tegwick
75467673a8
- workplans/RAIL-BS-WP-0004-safety-net.md: ADR-001 workplan file for current-env-safety-net workstream (7e8b0c20), T01-T04 done, T05-T06 todo - tools/cmd/railiance-preflight: update REPOS to OAS S1-S5 stack (railiance-infra/cluster/platform/enablement/apps) + project repos; remove stale railiance-bootstrap reference - docs/backup-restore.md: fix Step 5 clone commands to current repo names - Makefile: add make backup and make preflight targets Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Railiance Documentation
Welcome to Railiance — an opinionated framework for Infrastructure-as-Code.
Think of it as Rails for Ops: convention over configuration, productivity first, reproducible everywhere.
🚀 What is Railiance?
Railiance is the self-reliant infrastructure bootstrap for Coulomb and beyond.
From two bare Linux servers, a Git repo, and valid credentials, you can rebuild a full Kubernetes-based environment with:
- Automated provisioning (Ansible, Helm, k3s)
- Git-driven state (ArgoCD / Flux)
- AI-ready automation with OODA loop (Observe, Orient, Decide, Act)
- End-to-end reproducibility — no hidden steps, no snowflake servers
🌱 Core Principles
-
Convention over configuration
Opinionated defaults remove friction. -
Don’t repeat yourself (DRY)
Single source of truth in Git, reused everywhere. -
Automated OODA
- Observe: collect telemetry.
- Orient: AI interprets state.
- Decide: human reviews & authorizes.
- Act: automation applies changes.
-
Self-Reliance
Everything can be rebuilt from scratch, with no external dependencies beyond Git + credentials. -
Calm Ops
Systems should be simple, resilient, and predictable.
📂 Repo Layout
ansible/— bootstrap playbooks (OS setup, k3s install, etc.)helm/— Helm charts for servicesk8s/— raw manifests & overlaystests/— automated validation of infra stepsdocs/— documentation & contributor guidestools/— helper scripts (e.g. repo bootstrap)
🛠 Getting Started
-
Clone the repo
git clone <your-gitea-url>/railiance-bootstrap.git cd railiance-bootstrap -
Prepare your config Edit ~/.railiance_gitea.conf with your Gitea URL, user, and token. (Never commit this file!)
-
Run bootstrap Use the playbooks in ansible/ to turn a bare Ubuntu server into a Kubernetes host.
-
Deploy services Install baseline services via Helm from the helm/ directory.
Incidents
👥 Contributing
See CONTRIBUTING.md for rules, coding style, and workflow.
🌍 Vision
Railiance is more than infra scripts: it’s the foundation of self-empowering infrastructure, where humans and AI agents collaborate to manage systems with trust, clarity, and calmness.
From bare metal to resilient clusters, in one repo.