Watch the cluster and edit every setting from the console
The console gains live views of nodes, GPUs, models, replicas, usage and agent logs, and a settings tree over every key of server.yaml (agent.yaml on a node), generated from the configuration structs: values with their defaults and doc comments, edited in dialogs, saved only once the service's own loader accepts them, comments kept. The generator now tells blocks apart by package, which brings the TLS, engine and supervisor settings back into the reference. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
aa3efcebbe
commit
9ab93a0aa6
13 files changed
+2702
-472
No files matched your search
+30
-10
@@ -61,13 +61,13 @@ rather than repeated.
|
||||
for _, bl := range blocks {
|
||||
for _, f := range bl.Fields {
|
||||
b.WriteString(fmt.Sprintf("| `%s` | %s | [%s](#%s) |\n",
|
||||
f.Key, code(f.Type), bl.Name, anchor(bl.Name)))
|
||||
f.Key, code(f.Type), bl.Title, anchor(bl.Title)))
|
||||
}
|
||||
}
|
||||
b.WriteString("\n")
|
||||
|
||||
for _, bl := range blocks {
|
||||
fmt.Fprintf(&b, "## %s\n\n", bl.Name)
|
||||
fmt.Fprintf(&b, "## %s\n\n", bl.Title)
|
||||
if bl.Doc != "" {
|
||||
b.WriteString(bl.Doc + "\n\n")
|
||||
}
|
||||
@@ -76,24 +76,44 @@ rather than repeated.
|
||||
if f.Doc != "" {
|
||||
b.WriteString(f.Doc + "\n\n")
|
||||
}
|
||||
if f.Nested != "" && hasBlock(blocks, f.Nested) {
|
||||
fmt.Fprintf(&b, "Takes a [%s](#%s) block.\n\n", f.Nested, anchor(f.Nested))
|
||||
if nb, ok := Find(blocks, f.Nested); ok {
|
||||
fmt.Fprintf(&b, "Takes a [%s](#%s) block.\n\n", nb.Title, anchor(nb.Title))
|
||||
}
|
||||
}
|
||||
}
|
||||
return b.String()
|
||||
}
|
||||
|
||||
func hasBlock(blocks []Block, name string) bool {
|
||||
// Find is the block with an ID, as a Field's Nested names it.
|
||||
func Find(blocks []Block, id string) (Block, bool) {
|
||||
for _, b := range blocks {
|
||||
if b.Name == name {
|
||||
return true
|
||||
if id != "" && b.ID() == id {
|
||||
return b, true
|
||||
}
|
||||
}
|
||||
return false
|
||||
return Block{}, false
|
||||
}
|
||||
|
||||
func code(s string) string { return "`" + s + "`" }
|
||||
|
||||
// anchor is how GitHub and Gitea slug a heading.
|
||||
func anchor(s string) string { return strings.ToLower(s) }
|
||||
// anchor is how GitHub and Gitea slug a heading: lower case, and punctuation
|
||||
// such as the dot in tlsconf.Config dropped.
|
||||
func anchor(s string) string { return strings.ToLower(strings.ReplaceAll(s, ".", "")) }
|
||||
|
||||
// RenderGo writes the blocks as Go, for the settings screens: every key, its
|
||||
// type and what it does, from the same source as the reference, so a setting
|
||||
// added to the code is on the screens without anyone listing it.
|
||||
func RenderGo(blocks []Block) string {
|
||||
var b strings.Builder
|
||||
b.WriteString("// Code generated by go run ./internal/docgen/gen; DO NOT EDIT.\n\npackage docgen\n\n")
|
||||
b.WriteString("// Reference is every configuration block, as Collect reads them.\nvar Reference = []Block{\n")
|
||||
for _, bl := range blocks {
|
||||
fmt.Fprintf(&b, "\t{Package: %q, Name: %q, Title: %q, Doc: %q, Fields: []Field{\n", bl.Package, bl.Name, bl.Title, bl.Doc)
|
||||
for _, f := range bl.Fields {
|
||||
fmt.Fprintf(&b, "\t\t{Key: %q, Type: %q, Doc: %q, Nested: %q},\n", f.Key, f.Type, f.Doc, f.Nested)
|
||||
}
|
||||
b.WriteString("\t}},\n")
|
||||
}
|
||||
b.WriteString("}\n")
|
||||
return b.String()
|
||||
}
|
||||
Reference in new issue
Block a user