gtar/README.md

📖 Overview

This repository provisions and manages the Gitea 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 and Ansible

🚀 Features

• Declarative infrastructure management with OpenTofu and Ansible
• Remote state stored in PostgreSQL backend
• Secure injection of secrets into terraform.auto.tfvars

---

🔄 Usage

🛠️ Opentofu

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

🧩 Ansible

1. Checkout repo
2. From the ansible folder, run export GITEA_RUNNER_TOKEN="{{ YOUR_GITEA_RUNNER_TOKEN }}"
3. Run ansible-playbook main.yml -e "GITEA_RUNNER_TOKEN=$GITEA_RUNNER_TOKEN"