61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# Railiance Cluster
|
|
[](LICENSE)
|
|
|
|
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**
|
|
```bash
|
|
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](./docs/README.md))
|
|
- `tools/` — Helper scripts (e.g. `create_railiance_repo.sh`)
|
|
|
|
---
|
|
|
|
## 🤝 Contributing
|
|
|
|
See [docs/CONTRIBUTING.md](./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.*
|