tegwick
660a63c674
T01: helm/gitea-values.yaml with postgresql-ha.pgpool.adminPassword
(fill REPLACE_WITH_PGPOOL_ADMIN_PASSWORD before helm upgrade)
T02: tests/smoke_kube.sh — add pgpool and postgresql-ha pod health checks
T03: tests/test_ha_failover.sh — D3 HA failover test script
T04: docs/incidents/2026-03-10-pgpool-missing-secret.md + README link
Also: make test-ha-failover target, Makefile .PHONY updated.
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.