Retroactively author 15 grouped detail docs covering the backend functional (feat/fix) commits made before the change ledger was established (fad48ff), closing the ledger's detail-doc axis for the pre-convention history. Each doc groups a feature's constituent commits, lists their SHAs with subjects, and carries a backfill note stating it was reconstructed from git history on 2026-07-07 and not independently re-verified (current tree green at9911b8c). Add a Detail docs section to INDEX.md linking every detail doc (the 6 existing + 15 backfill) to the commit(s) it covers, so a doc is findable from the index without a column on the auto-generated ledger table. Catch the table up with the missing9911b8crow. Scope: backend (Go/Java/K8s) only, per the ledger's stated convention that frontend/panel commits are the collaborator's UI work; non-functional commits (docs/style/chore/refactor) keep their table row without a dedicated detail doc.
2.4 KiB
Deploy: one-line bootstrap installer + demo bring-up (ledger backfill)
- Type: feature + fix — retroactive ledger entry
- Date: 2026-06-27 – 2026-07-03
- Area:
deploy/(bootstrap.sh, Dockerfiles, demo-up.sh), image build context - Commits:
58fa4b0feat(deploy): one-line bootstrap installer + distroless felis image (auto-detects apt/dnf, installs Docker/k3s/PostgreSQL, opens pg_hba to the pod CIDR, runs migrations, applies the control-plane bundle, leaves Web disabled pendingfelis setup)94a3b7bfix(deploy): harden bootstrap for RHEL-family Linuxdeaa2f8feat(deploy): zypper support (openSUSE/SLES)318a724feat(deploy): pacman support (Arch)e5f1682refactor(deploy)!: TUI (breaking walkthrough restructure)28c3eeerefactor(deploy): improved TUI walkthroughc14ed17fix(docker): keep embeddedpanel/anddeploy/in the image build contextd9e866ffix(deploy): make the lobby image actually build (re-includeplugins/paper, build ongradle:8.14-jdk21)b84debffeat(deploy): one-shotdemo-up.sh— bootstrap → build/import limbo+lobby images → wire[velocity]image refs →felis setup, ending in the interactive Owner TUI
- Tasks: #26 (Phase A bootstrap verified end-to-end on the Demo VM)
What it did
Made a bare Linux box a running Felis with one command. bootstrap.sh auto-detects the
host package manager across the four major families (apt/dnf/zypper/pacman), installs
whatever is missing (Docker, k3s, PostgreSQL, cloudflared), builds+imports the distroless
felis image, opens pg_hba to the pod CIDR, runs migrations, and applies the rendered
control-plane bundle. demo-up.sh wraps that plus the login-limbo/lobby image build and
felis setup into a single command, stopping only at the Owner-creation TUI it cannot
automate.
Why
The spec calls for a self-hostable single-node deployment a SysAdmin can stand up without a Kubernetes background. The package-manager fan-out and the demo wrapper are what make "one line" true across real distros rather than only on the author's box.
Backfill note. Reconstructed 2026-07-07 from the commit history to close the change-ledger's detail-doc axis.
deploy/is shell + Dockerfiles (not Go-oracle verifiable);d9e866frecords a real build+boot check (limbo/healthz200, lobby reaches "Done"). Not independently re-verified for this doc; current tree green at9911b8c.