macunha1.github_actions_runner
Rol de Ansible para Corrredores autoalojados de GitHub Actions
Un rol de Ansible que instala y configura corredores autoalojados de GitHub Actions dentro de uno o múltiples hosts. Puedes reutilizarlo para muchas URLs diferentes (repositorios u organizaciones) dentro del mismo host para aprovecharlo al máximo.
Los principales objetivos de este rol son:
- evitar desperdicios: reutilizar el mismo host para proporcionar un entorno de construcción para múltiples repositorios u organizaciones;
- idempotencia: ejecutar el rol varias veces no romperá nada, los pasos tienen verificaciones que validan si deben o no ejecutarse;
Variables
Para obtener una lista exhaustiva de variables, consulta el archivo defaults. Idealmente, todos los valores tendrán comentarios que describen sus propósitos y, por el valor predeterminado, podrás conocer el tipo.
Variables requeridas
Los siguientes valores son requeridos ya que no hay forma de registrar el corredor autoalojado sin ellos.
Nombre | Descripción |
---|---|
gh_runner_config_url | URL del repositorio o la organización de GitHub |
gh_runner_config_token | Token de registro de GitHub para autenticar el host |
Ejemplo de Playbook
Caso de uso más simple: configuración de un solo repositorio en un host.
- hosts: foo
roles:
- role: macunha1.github_actions_runner
vars:
gh_runner_config_labels:
- linux
- autoalojado
gh_runner_config_url: https://github.com/macunha1/ansible-github-actions-runner
gh_runner_config_token: AC5TNLJP9SBAFNEKKLLBLF264J8XO
Caso de uso complejo para el cual se creó este rol:
- hosts: foo
roles:
- role: macunha1.github_actions_runner
vars:
gh_runner_config_labels:
- linux
- autoalojado
gh_runner_config_url: https://github.com/macunha1/ansible-github-actions-runner
gh_runner_config_token: AC5TNLJP9SBAFNEKKLLBLF264J8XO
- role: macunha1.github_actions_runner
vars:
gh_runner_config_url: https://github.com/macunha1/another-repository
gh_runner_config_token: AC5CQV3IJRR2OAFGEFCPJ0WJPJQXO
- role: macunha1.github_actions_runner
vars:
gh_runner_config_url: https://github.com/macunha-acme-corp
gh_runner_config_token: ACYWUR9MHGR9U58C34W9ZK00UNBF
Ten en cuenta que, a pesar de usar el mismo host, cada una de estas configuraciones de corredor de GitHub Actions tendrá su propio camino y credenciales. Por lo tanto, pueden coexistir sin problemas.
Contribuir
Siéntete libre de abrir un problema que contenga solicitudes de funciones, o (aún mejor) envíame una Pull Request. Estaré encantado de colaborar contigo.
Si este rol no funcionó para ti, o si encontraste algún error durante la ejecución, házmelo saber.
Idempotent Ansible role that installs and configures self-hosted GitHub Actions Runners (yeah, plural!)
ansible-galaxy install macunha1.github_actions_runner