Rollcall: bare-metal commissioning server, agent, image build, lab and CI
Go server (API, embedded web UI, CLI) backed by PostgreSQL with AES-GCM sealed BMC secrets; Debian live commissioning agent and live-build recipe; Proxmox lab with pve-vbmc virtual BMCs; Gitea workflows for CI, releases and deployment; project website. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
commit
d9ae89b295
33 files changed
+3248
No files matched your search
@@ -0,0 +1,15 @@
|
||||
{
|
||||
"listen": "10.213.77.1:80",
|
||||
"image_dir": "/srv/rollcall/image",
|
||||
"tftp_root": "/srv/tftp",
|
||||
"database_url": "postgres://rollcall:<PGPASS>@127.0.0.1:5432/rollcall?sslmode=disable",
|
||||
"master_key_file": "/etc/rollcall/master.key",
|
||||
"admin_token": "<ADMIN-TOKEN: rollcall keygen>",
|
||||
"agent_token": "<AGENT-TOKEN: rollcall keygen>",
|
||||
"commission_append": "boot=live components fetch=http://10.213.77.1/rollcall/filesystem.squashfs rollcall.server=http://10.213.77.1 rollcall.token=<AGENT-TOKEN> console=tty0 console=ttyS0,115200n8",
|
||||
"ipmitool": "ipmitool",
|
||||
"bmc_hints": [
|
||||
{"mac": "bc:24:11:8e:1e:6c", "address": "10.213.77.11", "port": 623, "user": "admin", "password": "password", "comment": "pxe-node01 (VM 211, pve-vbmc)"},
|
||||
{"mac": "bc:24:11:36:90:3f", "address": "10.213.77.12", "port": 623, "user": "admin", "password": "password", "comment": "pxe-node02 (VM 212, pve-vbmc)"}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,28 @@
|
||||
#!/bin/sh
|
||||
# Install the rollcall binary on pxe-server. Run as root from this directory.
|
||||
# Prereqs: PostgreSQL running locally with role+db "rollcall";
|
||||
# /etc/rollcall/config.json present (see config.example.json).
|
||||
set -eu
|
||||
cd "$(dirname "$0")"
|
||||
getent passwd rollcall >/dev/null || useradd --system --no-create-home --shell /usr/sbin/nologin --user-group rollcall
|
||||
install -d -m 0750 -o root -g rollcall /etc/rollcall
|
||||
install -d /srv/rollcall/image
|
||||
[ -x ./rollcall ] && install -m 0755 rollcall /usr/local/bin/rollcall
|
||||
install -m 0644 rollcall.service /etc/systemd/system/
|
||||
[ -e /etc/rollcall/config.json ] || { echo "write /etc/rollcall/config.json first (see config.example.json)" >&2; exit 1; }
|
||||
chown root:rollcall /etc/rollcall/config.json && chmod 0640 /etc/rollcall/config.json
|
||||
# master key is created by the service on first start; the dir must be writable for that
|
||||
chown rollcall:rollcall /etc/rollcall
|
||||
# rollcall writes per-MAC pxelinux configs
|
||||
chgrp rollcall /srv/tftp/pxelinux.cfg && chmod 2775 /srv/tftp/pxelinux.cfg
|
||||
install -m 0644 /usr/lib/syslinux/modules/bios/poweroff.c32 /srv/tftp/poweroff.c32
|
||||
sed "s/@AGENT_TOKEN@/$(jq -r .agent_token /etc/rollcall/config.json)/g" pxelinux-default > /srv/tftp/pxelinux.cfg/default && chmod 0644 /srv/tftp/pxelinux.cfg/default
|
||||
[ -e /srv/tftp/rollcall ] || ln -s /srv/rollcall/image /srv/tftp/rollcall
|
||||
[ -d /srv/tftp/efi64 ] && ln -sfn ../rollcall /srv/tftp/efi64/rollcall
|
||||
# old python prototype
|
||||
rm -f /usr/local/bin/rollcall /usr/local/bin/commctl
|
||||
systemctl daemon-reload
|
||||
systemctl enable --now rollcall.service
|
||||
systemctl restart rollcall.service
|
||||
sleep 1
|
||||
systemctl --no-pager status rollcall.service | head -5
|
||||
@@ -0,0 +1,27 @@
|
||||
# /srv/tftp/pxelinux.cfg/default - unknown machines land here.
|
||||
# Commissioned machines get a per-MAC file (01-xx-xx-...) written by rollcall.
|
||||
DEFAULT menu.c32
|
||||
PROMPT 0
|
||||
TIMEOUT 80
|
||||
MENU TITLE pxe-server (10.213.77.1) - unknown machine: commissioning in 8s
|
||||
|
||||
LABEL commission
|
||||
MENU LABEL Commission this machine (inventory + BMC account)
|
||||
MENU DEFAULT
|
||||
KERNEL rollcall/vmlinuz
|
||||
INITRD rollcall/initrd.img
|
||||
APPEND boot=live components fetch=http://10.213.77.1/rollcall/filesystem.squashfs rollcall.server=http://10.213.77.1 rollcall.token=@AGENT_TOKEN@ console=tty0 console=ttyS0,115200n8
|
||||
|
||||
LABEL commission-debug
|
||||
MENU LABEL Commission, but stay up afterwards (ssh root@<ip>)
|
||||
KERNEL rollcall/vmlinuz
|
||||
INITRD rollcall/initrd.img
|
||||
APPEND boot=live components fetch=http://10.213.77.1/rollcall/filesystem.squashfs rollcall.server=http://10.213.77.1 rollcall.token=@AGENT_TOKEN@ rollcall.nopoweroff console=tty0 console=ttyS0,115200n8
|
||||
|
||||
LABEL netbootxyz
|
||||
MENU LABEL netboot.xyz (needs internet via NAT)
|
||||
KERNEL netboot.xyz.lkrn
|
||||
|
||||
LABEL local
|
||||
MENU LABEL Boot from local disk
|
||||
LOCALBOOT 0
|
||||
@@ -0,0 +1,22 @@
|
||||
[Unit]
|
||||
Description=rollcall - MAAS-like commissioning server (API, web UI)
|
||||
After=network-online.target postgresql.service
|
||||
Wants=network-online.target
|
||||
Requires=postgresql.service
|
||||
|
||||
[Service]
|
||||
Type=simple
|
||||
ExecStart=/usr/local/bin/rollcall serve -config /etc/rollcall/config.json
|
||||
Restart=always
|
||||
RestartSec=3
|
||||
User=rollcall
|
||||
Group=rollcall
|
||||
AmbientCapabilities=CAP_NET_BIND_SERVICE
|
||||
NoNewPrivileges=yes
|
||||
ProtectSystem=strict
|
||||
ProtectHome=yes
|
||||
PrivateTmp=yes
|
||||
ReadWritePaths=/etc/rollcall /srv/tftp/pxelinux.cfg
|
||||
|
||||
[Install]
|
||||
WantedBy=multi-user.target
|
||||
Reference in new issue
Block a user