27 lines
921 B
Markdown
27 lines
921 B
Markdown

|
|
|
|
## 📖 Overview
|
|
|
|
This repository provisions and manages the GitHub Self-Hosted Runner for the Comprofix Homelab Infrastructure. This repo is designed to be run manually to build and setup the runner when requuired.
|
|
|
|
Built using Infrastructure as Code (IaC) with [OpenTofu](https://opentofu.org/) and [Ansible](https://ansible.com)
|
|
---
|
|
|
|
## 🚀 Features
|
|
|
|
- Declarative infrastructure management with OpenTofu and Ansible
|
|
- Remote state stored in PostgreSQL backend
|
|
- Secure injection of secrets into `terraform.auto.tfvars`
|
|
---
|
|
|
|
## 🔄 Usage
|
|
|
|
1. Checkout repo
|
|
2. From the opentofu folder, generate `terraform.auto.tfvars` using the supplied ```prepareEnv.sh```
|
|
3. Run `tofu init`, `tofu fmt`, `tofu validate`
|
|
4. Execute `tofu plan`
|
|
5. If successful, run `tofu apply`
|
|
6. From the ansible folder, run `ansible-playbook main.yml`
|
|
|
|
|