- fabrics, VLANs, subnets, IP ranges (dynamic/reserved/static), IPAM with adoption of addresses machines already have; rollcall fabric|vlan|subnet|range|ip - interface layouts (physical/bond/vlan, NICs by selector: boot, name, mac, fastest:N, ib:N) per machine or per tag; deployment allocates addresses and writes cloud-init network-config plus udev name rules (RHEL cloud images boot with net.ifnames=0); release frees them; rollcall layout, rollcall net show|set - region/rack: rollcall rack long-polls its desired state (per-MAC PXE files kept in the database, dnsmasq configuration and host files) and a BMC command queue, caches boot and OS images (kernels/initrds prefetched for TFTP), proxies the node API and tags requests with its name; the region runs an embedded rack controller; install-rack.sh, rollcall-rack.service - dnsmasq configuration generated per rack from the VLANs it serves (split pool for two racks); reload script restarts only on change and restores the last working config if dnsmasq does not come back (drilled in the lab) - web: Network page, per-machine network tab, layout action, tag layout; console: Network page, network section in the machine view, layout action - tests for candidates, plans (default, bond+VLAN, pinned, DHCP fallback), network-config, udev rules and dnsmasq rendering - lab: pve-vbmc address script finds the interface per BMC address Verified in the lab: embedded rack (10.213.77.0/24) and a remote rack controller on a second SDN segment (10.213.78.0/24): enlistment, commissioning, BMC through the rack's queue, image cache, deployment and phone-home through the rack; Debian 13, Ubuntu 24.04 and Rocky 9 with a static boot NIC and with an active-backup bond carrying VLAN 200. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
91 lines
3.9 KiB
Go
91 lines
3.9 KiB
Go
package main
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"os"
|
|
"path/filepath"
|
|
"strings"
|
|
)
|
|
|
|
// Config is /etc/rollcall/config.json.
|
|
type Config struct {
|
|
Listen string `json:"listen"` // "10.213.77.1:80"
|
|
ImageDir string `json:"image_dir"` // live image files (vmlinuz, initrd.img, filesystem.squashfs), served under /rollcall/
|
|
TFTPRoot string `json:"tftp_root"` // pxelinux.cfg/01-<mac> files are written here
|
|
DatabaseURL string `json:"database_url"` // postgres://user:pw@host/db
|
|
MasterKeyFile string `json:"master_key_file"` // 32-byte hex key for AES-GCM at-rest encryption
|
|
AdminToken string `json:"admin_token"` // bearer token for the management API / web UI
|
|
AgentToken string `json:"agent_token"` // X-Rollcall-Token for the agent endpoints ("" = open)
|
|
CommissionAppend string `json:"commission_append"` // kernel cmdline used in generated pxelinux files
|
|
IPMITool string `json:"ipmitool"` // path, default "ipmitool"
|
|
BMCHints []BMCHint `json:"bmc_hints"` // out-of-band BMC mapping for machines without in-band IPMI
|
|
|
|
// stateless provisioning
|
|
ServerURL string `json:"server_url"` // how nodes reach this server, e.g. http://10.213.77.1
|
|
ImagesDir string `json:"images_dir"` // <images_dir>/<image>/{vmlinuz,initrd.img,filesystem.squashfs}, served under /images/
|
|
OverlaysDir string `json:"overlays_dir"` // <overlays_dir>/<overlay>/{system,runtime}/... (Go templates with .tmpl suffix)
|
|
DnsmasqDir string `json:"dnsmasq_dir"` // hosts.dhcp + hosts written here for dnsmasq (dhcp-hostsfile / addn-hosts); "" disables
|
|
NodePools map[string]string `json:"node_pools"` // {"mgmt": "10.0.0.50-10.0.0.99", "ib": "10.1.0.10-10.1.0.250"}
|
|
ClusterVars map[string]any `json:"cluster_vars"` // available to overlay templates as .Vars (profile vars override)
|
|
|
|
// disk-based deployment
|
|
OSDir string `json:"os_dir"` // <os_dir>/<name>/<version>/{disk.raw.zst,meta.json}, served under /os/
|
|
OSSources string `json:"os_sources"` // JSON list of upstream cloud images for `rollcall os sync`
|
|
|
|
// region/rack: this server runs an embedded rack controller named RackName;
|
|
// remote rack controllers (rollcall rack) authenticate with RackSecret
|
|
RackName string `json:"rack_name"`
|
|
RackSecret string `json:"rack_secret"`
|
|
}
|
|
|
|
// BMCHint maps a machine MAC to a known BMC (virtual lab nodes).
|
|
type BMCHint struct {
|
|
MAC string `json:"mac"`
|
|
Address string `json:"address"`
|
|
Port int `json:"port"`
|
|
User string `json:"user"`
|
|
Password string `json:"password"`
|
|
Comment string `json:"comment,omitempty"`
|
|
}
|
|
|
|
func loadConfig(path string) (*Config, error) {
|
|
b, err := os.ReadFile(path)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
c := &Config{Listen: "0.0.0.0:80", IPMITool: "ipmitool", MasterKeyFile: "/etc/rollcall/master.key"}
|
|
if err := json.Unmarshal(b, c); err != nil {
|
|
return nil, fmt.Errorf("%s: %w", path, err)
|
|
}
|
|
for _, k := range []struct{ v, n string }{{c.ImageDir, "image_dir"}, {c.TFTPRoot, "tftp_root"}, {c.DatabaseURL, "database_url"}, {c.AdminToken, "admin_token"}} {
|
|
if k.v == "" {
|
|
return nil, fmt.Errorf("%s: %s is required", path, k.n)
|
|
}
|
|
}
|
|
if c.ServerURL == "" {
|
|
host, _, _ := strings.Cut(c.Listen, ":")
|
|
if host == "" || host == "0.0.0.0" {
|
|
return nil, fmt.Errorf("%s: server_url is required when listen is not a specific address", path)
|
|
}
|
|
c.ServerURL = "http://" + c.Listen
|
|
}
|
|
c.ServerURL = strings.TrimRight(c.ServerURL, "/")
|
|
if c.ImagesDir == "" {
|
|
c.ImagesDir = filepath.Join(filepath.Dir(c.ImageDir), "images")
|
|
}
|
|
if c.OverlaysDir == "" {
|
|
c.OverlaysDir = "/etc/rollcall/overlays"
|
|
}
|
|
if c.OSDir == "" {
|
|
c.OSDir = filepath.Join(filepath.Dir(c.ImageDir), "os")
|
|
}
|
|
if c.OSSources == "" {
|
|
c.OSSources = "/etc/rollcall/os-sources.json"
|
|
}
|
|
if c.RackName == "" {
|
|
c.RackName, _ = os.Hostname()
|
|
}
|
|
return c, nil
|
|
}
|