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

PRs Bienvenidos

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.

Acerca del proyecto

Idempotent Ansible role that installs and configures self-hosted GitHub Actions Runners (yeah, plural!)

Instalar
ansible-galaxy install macunha1.github_actions_runner
Licencia
mit
Descargas
3.9k
Propietario
cat /dev/null > /path/to/github/bio