GitHub Actions Runner

This role will deploy or redeploy or uninstall and register or unregister local GitHub Actions Runner (version you specified).

Requirements

• Supported Linux distros:

  • CentOS/RHEL 7,8
  • Fedora 16+
  • Ubuntu 16,18

• System must have access to the GitHub.

• Runner user has to be pre-created.
  Recommended role: monolithprojects.user_management

• CentOS/Fedora systems require EPEL repository.
  Recommended role: robertdebock.epel

• PERSONAL_ACCESS_TOKEN variable needs to be exported to your environment. The token has to have admin rights for the repo.
  Personal Access Token for your GitHub account can be created here.

Role Variables

This is a copy from defaults/main.yml

# Runner user - user inder which is the local runner service running
runner_user: runner

# Directory where the local runner will be installed
runner_dir: /opt/actions-runner

# Version of the GitHub Actions Runner
runner_version: "2.165.2"

# If found, replace already registered runner
replace_runner: yes

# Do not show Ansible logs which may contain sensitive data (registration token)
hide_sensitive_logs: yes

# Personal Access Token for your GitHub account
access_token: "{{ lookup('env', 'PERSONAL_ACCESS_TOKEN') }}"

# GitHub address
github_server: "https://github.com"

# GitHub account name
# github_account: "youruser"

# Github repository name
# github_repo: "yourrepo"

Example Playbook

In this example the role will deploy (or redeploy) the GitHub Actions runner service (default version ins ) and register the runner for the GitHub repo.

---
- name: GitHub Actions Runner
  hosts: all
  become: yes
  vars:
    - runner_version: "2.165.2"
    - runner_user: runner
    - github_account: myuser
    - github_repo: my_awesome_repo
  roles:
    - role: monolithprojects.github_actions_runner

By using tag uninstall, GitHub Actions runner will be removed from the host and unregistered from the GitHub.

ansible-playbook playbook.yml --tags uninstall

License

MIT

Author Information

Created in 2020 by Michal Muransky