Initial commit. Add Inventory
This commit is contained in:
68
readme.md
Normal file
68
readme.md
Normal file
@@ -0,0 +1,68 @@
|
||||
# Gitea Runner Automation with Ansible
|
||||
|
||||
This repository contains an Ansible playbook and configuration files to automate the deployment and configuration of a Gitea Runner on a Rocky Linux 10 VM.
|
||||
|
||||
To deploy a Rocky Linux virtual machine, please go to [this repository](https://git.phyllo.me/IaC/advanced-libvirt-terraform-examples).
|
||||
|
||||
## Repository Structure
|
||||
|
||||
```
|
||||
.
|
||||
├── ansible.cfg # Ansible configuration settings
|
||||
├── inventory.ini # Host inventory definition
|
||||
├── setup.yml # Main playbook for Gitea Runner configuration
|
||||
├── update.yml # Playbook to ensure system is up-to-date
|
||||
|
||||
```
|
||||
|
||||
## Prerequisites
|
||||
|
||||
1. Ansible installed on your control machine
|
||||
2. Access to a Rocky Linux 10 VM with IP `10.17.3.36`
|
||||
3. SSH key authentication configured with `~/.ssh/terraform_key`
|
||||
4. Root privileges or sudo access on the target VM
|
||||
|
||||
## How to Use
|
||||
|
||||
1. **Install Ansible** (if not already installed):
|
||||
```bash
|
||||
# For CentOS/RHEL/Fedora
|
||||
sudo yum install ansible
|
||||
|
||||
# For Ubuntu/Debian
|
||||
sudo apt update && sudo apt install ansible
|
||||
```
|
||||
|
||||
2. **Ensure SSH key exists**:
|
||||
```bash
|
||||
ls ~/.ssh/terraform_key
|
||||
```
|
||||
|
||||
3. **Run the playbook**:
|
||||
```bash
|
||||
ansible-playbook site.yml
|
||||
```
|
||||
|
||||
## What This Does
|
||||
|
||||
This automation will:
|
||||
1. Connect to the specified Rocky Linux VM
|
||||
2. Update the system packages
|
||||
3. Install necessary dependencies (git)
|
||||
4. Create a dedicated gitea-runner user
|
||||
5. Set hostname to rocky10
|
||||
6. Download and install Gitea Runner v0.2.13
|
||||
7. Configure systemd service for automatic startup
|
||||
8. Start the Gitea Runner service
|
||||
|
||||
The result is a fully configured Gitea Runner that will automatically start on system boot, ready to execute Gitea Actions workflows.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
If you encounter issues:
|
||||
- Verify SSH connectivity to the target VM
|
||||
- Ensure Ansible can reach the specified IP address
|
||||
- Check that `~/.ssh/terraform_key` has correct permissions
|
||||
- Review output logs for specific error messages
|
||||
|
||||
For additional help with Ansible configuration, consult the [official Ansible documentation](https://docs.ansible.com/ansible/latest/index.html).
|
||||
Reference in New Issue
Block a user