Railiance S2 cluster runtime layer for Kubernetes installation, networking, ingress, operators, and verified cluster health.
Find a file
tegwick b0177947dd
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Adopt staged WORK-RECORDS generation and catch the index up.
The generated index had drifted from the workplan files. The opt-in lets
the pre-commit hook rebuild WORK-RECORDS.md in the same commit as the
workplan it indexes.

Assistant: grok
Assistant-Session: 01a17f9d-fe9d-7d72-9a22-6304f1a2a790
2026-10-28 00:31:12 +01:00
.claude/rules Adopt repo-owned workplan prefix per ADR-007 2026-08-17 10:48:58 +02:00
.forgejo/workflows Add Forgejo CI smoke workflow (enablement template) 2026-07-04 12:50:02 +02:00
.github/workflows railiance: initial bootstrap scaffold 2025-09-12 01:46:14 +02:00
ansible fix(bootstrap): commit full bootstrap.yml — Helm + kubeconfig tasks 2026-03-10 09:52:36 +00:00
bin feat(recovery): connect bootstrap to identity backup verification 2026-10-16 01:37:22 +02:00
cloudinit chore(relocate): stub out S1 items moved to railiance-infra 2026-03-10 00:35:04 +01:00
docs docs(recovery): verify actual identity archive recovery and active backups 2026-10-16 09:38:31 +02:00
examples/railiance Define Railiance app contract 2026-06-27 15:33:47 +02:00
helm Remove Gitea-era SSH NodePort manifest (RAPPS-WP-0019-T05) 2026-10-21 23:48:09 +02:00
intakes Intake RAIL-BS-IN-0001: Stage 2/3 CLI assumes Helm 2026-08-29 14:51:27 +02:00
lib refactor: separated command script 2025-09-13 02:39:47 +02:00
registry fix(discovery): project bootstrap metadata from owner entry 2026-10-16 21:01:52 +02:00
schemas Define Railiance app contract 2026-06-27 15:33:47 +02:00
tests fix(test): correct ha-failover test — wrong URL, wrong pod label, missing kubectl 2026-03-10 13:42:54 +00:00
tools feat(recovery): connect bootstrap to identity backup verification 2026-10-16 01:37:22 +02:00
wiki docs: add ThreePhoenix architecture concept and workplan 2026-02-25 01:13:05 +01:00
workplans docs(discovery): retain bootstrap work record projection bindings 2026-10-16 21:18:09 +02:00
.editorconfig chore: optimize .editorconfig for consistent coding style 2025-09-12 02:19:01 +02:00
.generated-work-records.json Adopt staged WORK-RECORDS generation and catch the index up. 2026-10-28 00:31:12 +01:00
.generated-work-records.mk Adopt staged WORK-RECORDS generation and catch the index up. 2026-10-28 00:31:12 +01:00
.gitattributes chore: .gitattributes updated for line ending normalization 2025-09-12 02:21:05 +02:00
.gitignore chore: keep generated orientation brief local 2026-10-21 12:12:28 +02:00
.repo-classification.yaml Add .repo-classification.yaml (CUST-WP-0050 T11 agent first-pass) 2026-06-22 17:47:40 +02:00
.sops.yaml feat(secrets): encrypt gitea Helm values with SOPS (age) 2026-03-10 13:37:22 +00:00
AGENTS.md docs(agents): repoint remote State Hub URL to the in-cluster address 2026-08-25 00:21:42 +02:00
CLAUDE.md Regenerate agent instructions from state-hub templates (CUST-WP-0055 T01) 2026-07-08 14:50:33 +02:00
DECISIONS.md feat(backup): revise WP-0004 — integrated backup per capability (D4) 2026-03-10 17:43:30 +01:00
INTENT.md Repurpose as the Railiance bootstrap path 2026-08-11 22:41:29 +02:00
LICENSE chore: add MIT License 2025-09-12 02:44:03 +02:00
Makefile RAIL-BS-WP-0008/0009: operator deploy + admin-sync smoke tooling 2026-07-02 10:44:06 +02:00
pyproject.toml chore(rename): railiance-bootstrap → railiance-cluster 2026-03-10 00:34:21 +01:00
QUICKSTART.md chore(rename): railiance-bootstrap → railiance-cluster 2026-03-10 00:34:21 +01:00
README.md tools and workplans 2026-05-15 23:03:28 +02:00
sbom-tools.yaml chore(sbom): add system-level tool dependency manifest 2026-03-18 18:31:12 +01:00
SCOPE.md Adopt staged WORK-RECORDS generation and catch the index up. 2026-10-28 00:31:12 +01:00
uv.lock tools and workplans 2026-05-15 23:03:28 +02:00
WORK-RECORDS.md Adopt staged WORK-RECORDS generation and catch the index up. 2026-10-28 00:31:12 +01:00

Railiance Cluster

License: MIT

Opinionated Infrastructure-as-Code framework for reproducible, self-reliant systems.

Railiance is an opinionated Infrastructure-as-Code framework —
think Rails for Ops: convention over configuration, reproducibility first.

This repo (railiance-cluster) is the cluster runtime entry point:
from two bare Linux servers, a Git repo, and credentials, you can rebuild
a fully automated Kubernetes-based environment.


🚀 Quick Start

  1. Clone this repo

    git clone <your-gitea-url>/railiance-cluster.git
    cd railiance-cluster
    
  2. Configure Gitea access
    Edit ~/.railiance_gitea.conf with your server URL, username, and token.
    (Never commit this file!)

  3. Bootstrap a host
    Run the Ansible playbooks in ansible/ to set up k3s, Helm, kubectl.

  4. Deploy baseline services
    Use helm/ charts to roll out essential services (GitOps, monitoring, etc.).

  5. Validate
    Check the automated tests in tests/ to confirm infra health.


📂 Repo Structure

  • ansible/ — Playbooks for provisioning
  • helm/ — Opinionated Helm charts
  • k8s/ — Kubernetes manifests
  • tests/ — Automated validation
  • docs/ — Documentation (see docs/README.md)
  • tools/ — Helper scripts (e.g. create_railiance_repo.sh)

🤝 Contributing

See docs/CONTRIBUTING.md.


🌍 Vision

Railiance aims for self-reliant infrastructure:
automation you can rebuild from scratch, with calmness and clarity.

From bare metal to resilient clusters — in one repo.