Rôle Ansible pour un Runner GitHub Actions auto-hébergé

Un rôle Ansible qui installe et configure des Runners GitHub Actions auto-hébergés sur un ou plusieurs hôtes. Vous pouvez le réutiliser pour plusieurs URL (dépôts ou organisations) sur le même hôte afin d'en maximiser l'utilisation.

Objectifs principaux de ce rôle :

• éviter le gaspillage : réutiliser le même hôte pour fournir un environnement de construction pour plusieurs dépôts ou organisations ;
• idempotence : exécuter le rôle plusieurs fois ne causera pas de problèmes, les étapes ont des vérifications qui valident si elles doivent être exécutées ou non ;

Variables

Pour une liste exhaustive des variables, consultez le fichier defaults. Idéalement, toutes les valeurs auront des commentaires décrivant leur but et par la valeur par défaut, vous pourrez deviner le type.

Variables requises

Les valeurs suivantes sont requises car il n'est pas possible d'enregistrer le Runner auto-hébergé sans elles.

Exemple de Playbook

Cas d'utilisation le plus simple : configuration d'un dépôt unique sur un hôte.

- hosts: foo
  roles:
    - role: macunha1.github_actions_runner
      vars:
        gh_runner_config_labels:
          - linux
          - auto-hébergé

        gh_runner_config_url: https://github.com/macunha1/ansible-github-actions-runner
        gh_runner_config_token: AC5TNLJP9SBAFNEKKLLBLF264J8XO

Cas d'utilisation plus complexe pour lequel ce rôle a été créé.

- hosts: foo
  roles:
    - role: macunha1.github_actions_runner
      vars:
        gh_runner_config_labels:
          - linux
          - auto-hébergé

        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

Notez que malgré l'utilisation du même hôte, chacune de ces configurations de Runner GitHub Actions aura son propre chemin et ses propres identifiants. Par conséquent, elles peuvent coexister sans problème.

Contribuer

N'hésitez pas à soumettre un problème pour des demandes de fonctionnalités, ou (mieux encore) à m'envoyer une Pull request, je serais heureux de collaborer avec vous.

Si ce rôle ne fonctionne pas pour vous, ou si vous avez trouvé un bug lors de l'exécution, faites-le moi savoir.