# Railiance Cluster
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](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.*