railiance-cluster/README.md

Railiance Cluster

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.