coulomb/railiance-cluster
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
19 commits 1 branch 0 tags 854 KiB
Find a file
tegwick eb8a6902b6 docs: add ThreePhoenix architecture concept and workplan 
RailianceThreePhoenix: 3-node HA Kubernetes cluster with embedded etcd,
Longhorn distributed storage, PostgreSQL HA (repmgr + Pgpool-II), and
Phoenix CronJob for weekly node rotation to prevent configuration drift.

ThreePhoenixWorkplan: 7-phase implementation plan from blank Ubuntu nodes
to self-healing Gitea cluster with monitoring and alert silencing.

Also adds CLAUDE.md with Custodian State Hub session protocol.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 01:13:05 +01:00
.github/workflows railiance: initial bootstrap scaffold 2025-09-12 01:46:14 +02:00
ansible feat: rails style bootkit bin/railiance with quickstart 2025-09-13 01:32:19 +02:00
bin feat: added plan-host command 2025-09-13 02:46:48 +02:00
cloudinit feat: rails style bootkit bin/railiance with quickstart 2025-09-13 01:32:19 +02:00
docs feat: rails style bootkit bin/railiance with quickstart 2025-09-13 01:32:19 +02:00
lib refactor: separated command script 2025-09-13 02:39:47 +02:00
tests railiance: initial bootstrap scaffold 2025-09-12 01:46:14 +02:00
tools feat: added plan-host command 2025-09-13 02:46:48 +02:00
wiki docs: add ThreePhoenix architecture concept and workplan 2026-02-25 01:13:05 +01: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: rails style bootkit bin/railiance with quickstart 2025-09-13 01:32:19 +02:00
CLAUDE.md docs: add ThreePhoenix architecture concept and workplan 2026-02-25 01:13:05 +01:00
LICENSE chore: add MIT License 2025-09-12 02:44:03 +02:00
QUICKSTART.md chore: another improvement 2025-09-13 01:23:02 +00:00
README.md chore: add MIT License 2025-09-12 02:44:03 +02:00

README.md

Railiance Bootstrap

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-bootstrap) is the 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-bootstrap.git
cd railiance-bootstrap

  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.