Railiance S2 cluster runtime layer for Kubernetes installation, networking, ingress, operators, and verified cluster health.
Find a file
tegwick d88c52a7d4
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
Intake RAIL-BS-IN-0001: Stage 2/3 CLI assumes Helm
Requested by tenant-engine TEN-WP-0008-T02. Schema allows kubectl/kustomize
workloads; deploy/promote --plan still require a Helm chart.

Assistant: grok
Assistant-Session: 01a04cea-e5e8-7081-a0fc-808ebbc35fa9
2026-08-29 14:51:27 +02: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 RAIL-BS-WP-0008/0009: operator deploy + admin-sync smoke tooling 2026-07-02 10:44:06 +02:00
cloudinit chore(relocate): stub out S1 items moved to railiance-infra 2026-03-10 00:35:04 +01:00
docs Adopt repo-owned workplan prefix per ADR-007 2026-08-17 10:48:58 +02:00
examples/railiance Define Railiance app contract 2026-06-27 15:33:47 +02:00
helm feat(boundary): move Gitea Helm values to railiance-apps (T06) 2026-03-27 13:23:41 +01: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 Add capability registry scaffold (REUSE-WP-0014-T07 B05) 2026-06-16 01:57:57 +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 RAIL-BS-WP-0008/0009: operator deploy + admin-sync smoke tooling 2026-07-02 10:44:06 +02:00
wiki docs: add ThreePhoenix architecture concept and workplan 2026-02-25 01:13:05 +01:00
workplans fix(workplans): declare records the hub already holds as workplans 2026-08-26 10:29:32 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-08-15 20:54:01 +02:00
.editorconfig chore: optimize .editorconfig for consistent coding style 2025-09-12 02:19:01 +02:00
.gitattributes chore: .gitattributes updated for line ending normalization 2025-09-12 02:21:05 +02:00
.gitignore feat(secrets): encrypt gitea Helm values with SOPS (age) 2026-03-10 13:37:22 +00: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 Repurpose as the Railiance bootstrap path 2026-08-11 22:41:29 +02:00
uv.lock tools and workplans 2026-05-15 23:03:28 +02:00
WORK-RECORDS.md chore: keep ThreePhoenix pointer out of workplans/ 2026-08-15 20:56:47 +02: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.