Git based automated cluster runtime setup.
The requalification script applied its generic ADHOC rule before its RAIL-BS-ADHOC rule, producing RAIL-BS-RCLUSTER-WP-ADHOC-2026-07-27. My validator checked the identifier's shape and not its prefix, and the canon pattern accepts arbitrary prefix segments, so it passed. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Assistant: claude-code Assistant-Model: opus Assistant-Process: 2583210@bnt-lap001 Assistant-Session: f2bff2d5-e9b2-4338-92ca-10282a927006 |
||
|---|---|---|
| .claude/rules | ||
| .forgejo/workflows | ||
| .github/workflows | ||
| ansible | ||
| bin | ||
| cloudinit | ||
| docs | ||
| examples/railiance | ||
| helm | ||
| install/knative | ||
| lib | ||
| registry | ||
| schemas | ||
| tests | ||
| tools | ||
| wiki | ||
| workplans | ||
| .custodian-brief.md | ||
| .editorconfig | ||
| .gitattributes | ||
| .gitignore | ||
| .repo-classification.yaml | ||
| .sops.yaml | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| DECISIONS.md | ||
| INTENT.md | ||
| LICENSE | ||
| Makefile | ||
| pyproject.toml | ||
| QUICKSTART.md | ||
| README.md | ||
| sbom-tools.yaml | ||
| SCOPE.md | ||
| uv.lock | ||
| WORK-RECORDS.md | ||
railiance-cluster
S2 cluster runtime home for Railiance: Kubernetes substrate ownership, cluster operators, kubeconfig delivery, backup/preflight safety rails, and published cluster facts that downstream workload rails depend on.
This repo is the Kubernetes substrate owner, not the long-term home for the
generic workload-on-Kubernetes contract. The staged workload lifecycle,
railiance/app.toml, and overlay/wrapper scaffolding now belong canonically to
rail-kubernetes; this repo keeps only a migration-window compatibility shim
and temporary compatibility copies while the split completes.
Current Boundary
- S2-owned here: k3s bootstrap, Helm and kubeconfig access, cluster-level backup/preflight, smoke checks, and published substrate expectations.
- Transitional here only: the compatibility shim and temporary copies for the
generic Stage 1/2/3 workload lifecycle,
railiance/app.toml, canary and promotion CLI commands, and overlay scaffolding. - Reviewed move map: docs/rail-kubernetes-extraction-map.md
- Published substrate profile: docs/rail-kubernetes-substrate-profile.md
- Compatibility shim: docs/rail-kubernetes-compatibility-shim.md
Quick Start
- Clone this repo.
git clone <your-gitea-url>/railiance-cluster.git cd railiance-cluster - Configure Gitea access in
~/.railiance_gitea.conf. - Bootstrap a host with the Ansible playbooks in
ansible/. - Validate the cluster substrate with the documented smoke/preflight targets.
Repo Structure
ansible/- S2 bootstrap playbookshelm/- retained cluster-side helper manifeststests/- cluster validation and HA smoke checksdocs/- S2 substrate docs plus transitional rail-kubernetes specstools/- S2 operations plus compatibility tooling that is being split outworkplans/- repo-local cluster work records
Key Docs
- SCOPE.md
- docs/README.md
- docs/rail-kubernetes-extraction-map.md
- docs/rail-kubernetes-substrate-profile.md
Contributing
See docs/CONTRIBUTING.md.