Compare commits

...

17 Commits

Author SHA1 Message Date
Lukas Greve
205f7b83be create a meta file to execute sub roles. Remove / add blank lines at the end. Add mock 2025-11-22 11:22:46 +01:00
Lukas Greve
3553a8d289 update inventory 2025-11-22 11:21:17 +01:00
Lukas Greve
7c36cec3b7 add changes to runner configuration file so that the runner can run against the host directly, without relying on Docker 2025-11-22 11:12:57 +01:00
Lukas Greve
55e51548c4 change hostname to act 2025-11-22 11:06:43 +01:00
Lukas Greve
6a1bd2d258 ? 2025-11-22 11:06:09 +01:00
Lukas Greve
1a523b843c linter applied to file 2025-11-13 20:37:21 +01:00
Lukas Greve
8f8d56eae7 remove registration token 2025-11-13 20:36:49 +01:00
Lukas Greve
c2391eec7f update inv 2025-11-13 20:36:39 +01:00
Lukas Greve
459448b827 improve host setup, especially related to Docker setup 2025-11-13 20:36:27 +01:00
Lukas Greve
fdcd15064a "ansible-lint --fix" version of the file ; add new labels in the configuration file; allow for privileged containers to be run otherwise docker won't work 2025-11-13 20:35:44 +01:00
Lukas Greve
517bd5321b fix other regression 2025-11-02 11:21:25 +01:00
Lukas Greve
d68ca406e2 fix regression 2025-11-02 11:21:12 +01:00
Lukas Greve
bae2419235 Update to Fedora Rawhide, make act_runner name consistent, change file where runner registration data is tored 2025-10-26 20:06:42 +01:00
Lukas Greve
29887948ff update to Fedora Rawhide 2025-10-26 20:04:02 +01:00
Lukas Greve
48f9eef167 remove group 2025-10-26 20:03:12 +01:00
Lukas Greve
2563c429ae remove line 2025-10-26 20:03:00 +01:00
Lukas Greve
98040c59fd rename file and add dependencies 2025-10-26 20:02:50 +01:00
10 changed files with 296 additions and 226 deletions

View File

@@ -18,4 +18,4 @@ become_method = sudo
# -o ControlPersist=60s # -o ControlPersist=60s
# Sets the persistence time for the master connection to 60 seconds # Sets the persistence time for the master connection to 60 seconds
[ssh_connection] [ssh_connection]
ssh_args = -o ControlMaster=auto -o ControlPersist=60s ssh_args = -o ControlMaster=auto -o ControlPersist=60s

View File

@@ -1,6 +1,6 @@
# This file defines targets (hosts, groups, host-specific variables) # This file defines targets (hosts, groups, host-specific variables)
[all] [all]
rocky10 ansible_host=10.17.3.215 ansible_user=groot ansible_become=true ansible_python_interpreter=/usr/bin/python3.12 192.168.1.12 ansible_user=groot ansible_become=true ansible_python_interpreter=/usr/bin/python3
[gitrunner] [gitrunner]
rocky10 192.168.1.12

10
main.yml Normal file
View File

@@ -0,0 +1,10 @@
---
- name: Deploy and configure a runner on target machine
hosts: gitrunner
become: true
gather_facts: true
roles:
- update.yml
- host_setup.yml
- runner_setup.yml

View File

@@ -1,8 +1,8 @@
# Gitea Runner Automation with Ansible # 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. This repository contains an Ansible playbook and configuration files to automate the deployment and configuration of a Gitea Runner on a Fedora Rawhide Cloud VM.
To deploy a Rocky Linux virtual machine, please go to [this repository](https://git.phyllo.me/IaC/advanced-libvirt-terraform-examples). To deploy a Fedora Rawhide Cloud virtual machine, please go to [this repository](https://git.phyllo.me/IaC/advanced-libvirt-terraform-examples).
## Repository Structure ## Repository Structure
@@ -17,7 +17,7 @@ To deploy a Rocky Linux virtual machine, please go to [this repository](https://
## Prerequisites ## Prerequisites
1. Ansible installed on your control machine 1. Ansible installed on your control machine
2. Access to a Rocky Linux 10 VM with IP `10.17.3.250` 2. Access to a Fedora Rawhide Cloud VM with IP `10.17.3.250`
3. SSH key authentication configured with `~/.ssh/terraform_key` 3. SSH key authentication configured with `~/.ssh/terraform_key`
4. Root privileges or sudo access on the target VM 4. Root privileges or sudo access on the target VM
5. Gitea registration token (to be placed in runner_setup.yml) 5. Gitea registration token (to be placed in runner_setup.yml)
@@ -62,10 +62,10 @@ To deploy a Rocky Linux virtual machine, please go to [this repository](https://
This automation will: This automation will:
- Connect to the specified Rocky Linux VM - Connect to the specified Fedora Rawhide Cloud VM
- Update the system packages and reboot if required - Update the system packages and reboot if required
- Install necessary dependencies - Install necessary dependencies
- Set hostname to rocky10 - Set hostname to fedora-rawhide10
- Create a dedicated gitea-runner user - Create a dedicated gitea-runner user
- Download and install Gitea Runner - Download and install Gitea Runner
- Configure systemd service for automatic startup - Configure systemd service for automatic startup

View File

@@ -0,0 +1,91 @@
---
- name: More advanced setup, to use host itself as runner
hosts: gitrunner
become: true
gather_facts: true
tasks:
- name: Ensure required repositories are enabled
ansible.builtin.dnf:
name:
- dnf-plugins-core
state: present
update_cache: true
- name: Install required packages with error handling
ansible.builtin.dnf:
name:
- mock
- anaconda
- lorax
- make
- git
- gcc
- gcc-c++
- cmake
- clang
- clang-tools-extra
- python3
- python3-pip
- python3-devel
- python3-setuptools
- python3-wheel
- nodejs
- npm
- ruby
- ruby-devel
- rust
- cargo
- go
- perl
- perl-Module-Build
- perl-ExtUtils-MakeMaker
- gettext
- wget
- curl
- unzip
- tar
- gzip
- bzip2
- xz
- vim
- which
- procps-ng
- findutils
- coreutils
- diffutils
- patch
- shadow-utils
- util-linux
- grep
- sed
- bash
- zsh
- openssh-clients
- openssl
- ca-certificates
- libarchive
- libtool
- automake
- autoconf
- libffi-devel
- openssl-devel
- zlib-devel
- bison
- flex
- gdb
- strace
- ltrace
- valgrind
state: present
update_cache: true
allow_downgrade: false
- name: Clean dnf cache
ansible.builtin.command: dnf clean all
changed_when: true
- name: Remove dnf cache directory
ansible.builtin.file:
path: /var/cache/dnf
state: absent

46
roles/host_setup.yml Normal file
View File

@@ -0,0 +1,46 @@
---
- name: Initial generic setup
hosts: gitrunner
become: true
gather_facts: true
tasks:
- name: Install required packages
ansible.builtin.dnf:
name:
- docker
- nodejs
- git
- mock
state: present
update_cache: true
- name: Start and enable Docker service
ansible.builtin.systemd:
name: docker
enabled: true
state: started
- name: Add current user to docker group
ansible.builtin.user:
name: "{{ item }}"
groups: docker
append: true
loop:
- "{{ ansible_user }}"
- act_runner
- name: Verify Docker installation
ansible.builtin.command: docker version
changed_when: true
- name: Check current hostname
ansible.builtin.command: hostname
register: current_hostname
changed_when: false
- name: Set hostname to configured value (if needed)
ansible.builtin.hostname:
name: act
when:
- current_hostname.stdout != "act"

131
roles/runner_setup.yml Normal file
View File

@@ -0,0 +1,131 @@
---
- name: Initial one-time setup for the Act Runner, Gitea's Action runner
hosts: gitrunner
become: true
vars:
gitea_runner_version: "0.2.13"
# Token has to be generated here https://git.phyllo.me/user/settings/actions/runners and paste here, like:
# registration_token: "asdlkhgalsdhlgksdahklds"
registration_token: ""
tasks:
- name: Create act runner user
ansible.builtin.user:
name: "act_runner"
system: true
shell: /bin/bash
home: "/var/lib/act_runner"
create_home: true
state: present
- name: Create /etc/act_runner directory
ansible.builtin.file:
path: /etc/act_runner
state: directory
owner: "act_runner"
group: "act_runner"
mode: "0755"
- name: Install Act Runner
ansible.builtin.get_url:
url: "https://gitea.com/gitea/act_runner/releases/download/v{{ gitea_runner_version }}/act_runner-{{ gitea_runner_version }}-linux-amd64"
dest: "/usr/local/bin/act_runner"
mode: "0755"
force: "{{ (ansible_facts['cmdline']['force'] is defined) | default(false) }}"
retries: 3
delay: 5
- name: Create Act Runner configuration file
ansible.builtin.copy:
content: |
log:
level: info
runner:
file: "/var/lib/act_runner/.runner"
capacity: 4
timeout: 3h
shutdown_timeout: 0s
insecure: false
fetch_timeout: 5s
fetch_interval: 2s
github_mirror: ''
labels:
- "fedora-cloud-42:docker://git.phyllo.me/devops/fedora-runner-image:latest"
- "ubuntu-latest:docker://docker.gitea.com/runner-images:ubuntu-latest"
- "ubuntu-latest-full:docker://docker.gitea.com/runner-images:ubuntu-latest-full"
- "fedora-cloud-42:host"
cache:
enabled: true
dir: /var/lib/act_runner/.act-runner/actcache
host: ""
port: 0
external_server: ""
container:
network: ""
privileged: true
options:
workdir_parent:
valid_volumes: []
docker_host: ""
force_pull: true
force_rebuild: false
require_docker: false
docker_timeout: 0s
host:
workdir_parent: /var/lib/act_runner/act-runner/workdir
dest: /etc/act_runner/config.yaml
owner: "act_runner"
group: "act_runner"
mode: "0755"
backup: true
register: config_file
- name: Check if runner is already registered
ansible.builtin.stat:
path: /var/lib/act_runner/.runner
register: runner_registered
changed_when: false
- name: Register the runner with Gitea (if not already registered)
ansible.builtin.command: >
/usr/local/bin/act_runner register --no-interactive
--config /etc/act_runner/config.yaml --instance https://git.phyllo.me --token {{ registration_token }}
--name fedora-bios-0
when: not runner_registered.stat.exists
changed_when: true
notify: restart act runner service
- name: Create Act Runner service file
ansible.builtin.copy:
content: |
[Unit]
Description=Gitea Actions Runner
Documentation=https://gitea.com/gitea/act_runner
After=network.target
[Service]
ExecStart=/usr/local/bin/act_runner daemon --config /etc/act_runner/config.yaml
ExecReload=/bin/kill -s HUP $MAINPID
WorkingDirectory=/var/lib/act_runner
TimeoutSec=0
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
dest: /etc/systemd/system/act_runner.service
mode: "0644"
backup: true
notify: restart act runner service
- name: Ensure act_runner service is enabled and started
ansible.builtin.systemd:
name: act_runner
enabled: true
state: started
daemon_reload: true

View File

@@ -1,25 +1,25 @@
--- ---
- name: Update system packages - name: Update system packages
hosts: gitrunner hosts: gitrunner
become: yes become: true
tasks: tasks:
- name: Update system packages - name: Update system packages
yum: ansible.builtin.dnf:
name: "*" name: "*"
state: latest state: latest
update_cache: yes update_cache: true
- name: Check if reboot required (RedHat/CentOS) - name: Check if reboot required (RedHat/CentOS)
command: needs-restarting -r ansible.builtin.command: needs-restarting -r
register: needs_restarting_output register: needs_restarting_output
changed_when: false changed_when: false
ignore_errors: true ignore_errors: true
when: ansible_os_family == "RedHat" when: ansible_os_family == "RedHat"
- name: Reboot if required (RedHat/CentOS) - name: Reboot if required (RedHat/CentOS)
reboot: ansible.builtin.reboot:
when: when:
- ansible_os_family == "RedHat" - ansible_os_family == "RedHat"
- needs_restarting_output.rc == 1 - needs_restarting_output.rc == 1
- needs_restarting_output is defined - needs_restarting_output is defined

View File

@@ -1,187 +0,0 @@
---
- name: Initial one-time setup for the Act Runner, Gitea's Action runner
hosts: gitrunner
become: yes
vars:
gitea_runner_version: "0.2.13"
# Token has to be generated here https://git.phyllo.me/user/settings/actions/runners and paste here, like:
# registration_token: "asdlkhgalsdhlgksdahklds"
registration_token: ""
tasks:
- name: Create act runner user
ansible.builtin.user:
name: "act_runner"
system: yes
shell: /bin/bash
home: "/var/lib/act_runner"
create_home: yes
state: present
- name: Create /etc/act_runner directory
ansible.builtin.file:
path: /etc/act_runner
state: directory
owner: "act_runner"
group: "act_runner"
mode: '0755'
- name: Install Act Runner
ansible.builtin.get_url:
url: "https://gitea.com/gitea/act_runner/releases/download/v{{ gitea_runner_version }}/act_runner-{{ gitea_runner_version }}-linux-amd64"
dest: "/usr/local/bin/act-runner"
mode: '0755'
force: "{{ (ansible_facts['cmdline']['force'] is defined) | default(false) }}"
retries: 3
delay: 5
- name: Create Act Runner configuration file
ansible.builtin.copy:
content: |
log:
# The level of logging, can be trace, debug, info, warn, error, fatal
level: info
runner:
# Where to store the registration result.
file: .runner
# Execute how many tasks concurrently at the same time.
capacity: 1
# Extra environment variables to run jobs.
#envs:
# A_TEST_ENV_NAME_1: a_test_env_value_1
# A_TEST_ENV_NAME_2: a_test_env_value_2
# Extra environment variables to run jobs from a file.
# It will be ignored if it's empty or the file doesn't exist.
env_file: .env
# The timeout for a job to be finished.
# Please note that the Gitea instance also has a timeout (3h by default) for the job.
# So the job could be stopped by the Gitea instance if it's timeout is shorter than this.
timeout: 1h
# The timeout for the runner to wait for running jobs to finish when shutting down.
# Any running jobs that haven't finished after this timeout will be cancelled.
shutdown_timeout: 0s
# Whether skip verifying the TLS certificate of the Gitea instance.
insecure: false
# The timeout for fetching the job from the Gitea instance.
fetch_timeout: 5s
# The interval for fetching the job from the Gitea instance.
fetch_interval: 2s
# The labels of a runner are used to determine which jobs the runner can run, and how to run them.
# Like: "macos-arm64:host" or "ubuntu-latest:docker://docker.gitea.com/runner-images:ubuntu-latest"
# Find more images provided by Gitea at https://gitea.com/docker.gitea.com/runner-images .
# If it's empty when registering, it will ask for inputting labels.
# If it's empty when execute `daemon`, will use labels in `.runner` file.
labels:
- "rocky-latest:host:local"
cache:
# Enable cache server to use actions/cache.
enabled: true
# The directory to store the cache data.
# If it's empty, the cache data will be stored in $HOME/.cache/actcache.
dir: ""
# The host of the cache server.
# It's not for the address to listen, but the address to connect from job containers.
# So 0.0.0.0 is a bad choice, leave it empty to detect automatically.
host: ""
# The port of the cache server.
# 0 means to use a random available port.
port: 0
# The external cache server URL. Valid only when enable is true.
# If it's specified, act_runner will use this URL as the ACTIONS_CACHE_URL rather than start a server by itself.
# The URL should generally end with "/".
external_server: ""
container:
# Specifies the network to which the container will connect.
# Could be host, bridge or the name of a custom network.
# If it's empty, act_runner will create a network automatically.
network: ""
# Whether to use privileged mode or not when launching task containers (privileged mode is required for Docker-in-Docker).
privileged: false
# And other options to be used when the container is started (eg, --add-host=my.gitea.url:host-gateway).
options:
# The parent directory of a job's working directory.
# NOTE: There is no need to add the first '/' of the path as act_runner will add it automatically.
# If the path starts with '/', the '/' will be trimmed.
# For example, if the parent directory is /path/to/my/dir, workdir_parent should be path/to/my/dir
# If it's empty, /workspace will be used.
workdir_parent:
# Volumes (including bind mounts) can be mounted to containers. Glob syntax is supported, see https://github.com/gobwas/glob
# You can specify multiple volumes. If the sequence is empty, no volumes can be mounted.
# For example, if you only allow containers to mount the `data` volume and all the json files in `/src`, you should change the config to:
# valid_volumes:
# - data
# - /src/*.json
# If you want to allow any volume, please use the following configuration:
# valid_volumes:
# - '**'
valid_volumes: []
# overrides the docker client host with the specified one.
# If it's empty, act_runner will find an available docker host automatically.
# If it's "-", act_runner will find an available docker host automatically, but the docker host won't be mounted to the job containers and service containers.
# If it's not empty or "-", the specified docker host will be used. An error will be returned if it doesn't work.
docker_host: ""
# Pull docker image(s) even if already present
force_pull: true
# Rebuild docker image(s) even if already present
force_rebuild: false
host:
# The parent directory of a job's working directory.
# If it's empty, $HOME/.cache/act/ will be used.
workdir_parent:
dest: /etc/act_runner/config.yaml
owner: "act_runner"
group: "act_runner"
mode: '0755'
backup: yes
- name: Check if runner is already registered
ansible.builtin.stat:
path: /var/lib/act_runner/.runner
register: runner_registered
changed_when: false
- name: Register the runner with Gitea (if not already registered)
ansible.builtin.command: >
/usr/local/bin/act-runner register
--no-interactive
--config /etc/act_runner/config.yaml
--instance https://git.phyllo.me
--token {{ registration_token }}
--name rl-bios-0
when: not runner_registered.stat.exists
changed_when: true
- name: Create Act Runner service file
ansible.builtin.copy:
content: |
[Unit]
Description=Gitea Actions Runner
After=network.target
[Service]
Type=simple
User=act_runner
ExecStart=/usr/local/bin/act-runner daemon --config /etc/act_runner/config.yaml
ExecReload=/bin/kill -s HUP $MAINPID
WorkingDirectory=/var/lib/act_runner
TimeoutSec=0
Restart=always
RestartSec=10
User=act_runner
[Install]
WantedBy=multi-user.target
dest: /etc/systemd/system/act-runner.service
mode: '0755'
backup: yes
- name: Ensure act-runner service is enabled and started
ansible.builtin.systemd:
name: act-runner
enabled: yes
state: started
daemon_reload: yes

View File

@@ -1,21 +0,0 @@
---
- name: Initial generic setup
hosts: gitrunner
become: yes
tasks:
- name: Install required packages
yum:
name:
- git
state: present
- name: Check current hostname
command: hostname
register: current_hostname
changed_when: false
- name: Set hostname to rocky10 (if needed)
hostname:
name: rocky10
when: current_hostname.stdout != "rocky10"