Skip to content

docs: move the standalone runbook to its own home, sharpen the README to the shared contract #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jcardozo-eth merged 7 commits into from
Jul 24, 2026
Merged

docs: move the standalone runbook to its own home, sharpen the README to the shared contract #36

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
4aefe0a
docs(standalone): add standalone deployment runbook
jcardozo-eth Jul 23, 2026
d3b9842
docs(readme): fold host-specific values into their concerns
jcardozo-eth Jul 23, 2026
87548c2
docs(readme): state packages.sources and install orthogonality
jcardozo-eth Jul 23, 2026
9a8ee3e
docs(readme): slim to the shared contract, fleet-first front page
jcardozo-eth Jul 23, 2026
e81b7c0
docs(examples): use the default control-repository path
jcardozo-eth Jul 23, 2026
c28d7d9
docs(examples): reframe fleet-first, mark the standalone block
jcardozo-eth Jul 23, 2026
516e688
docs(changelog): record the standalone runbook split
jcardozo-eth Jul 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ module follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

### Changed

- Standalone operators get a self-contained runbook: installation, applying, systemd automation, and self-update now live in `docs/standalone.md`, and the README slims to the configuration, secrets, and security model shared by every consumer.
- The parameter surface is regrouped: five flat keys plus six parameter groups replace the 49 flat parameters. Related settings now live together, one hash per concern: `runner_account`, `configuration_file`, `packages` with its apt `sources`, `rootless_docker`, `runner_service`, and `standalone` with the nested `self_update`.
- Every subkey ships a module default and the groups merge deep across Hiera layers, so node data holds only its deviations, and a mistyped subkey now fails the compile instead of being silently ignored.
- The runner-token store reads as part of the runner family: `tokens` is now `runner_tokens`, alongside `runners` and `runner_defaults`. The automatic `Sensitive` wrap on lookup moves with the new key; the host's secret store file must follow the rename.
Expand Down
Loading