Rola Ansible do samodzielnie hostowanych Runnerów GitHub Actions

Jest to rola Ansible, która instaluje i konfiguruje samodzielnie hostowane Runery GitHub Actions na jednym lub wielu hostach. Możesz używać jej dla wielu różnych URL-i (repozytoriów lub organizacji) na tym samym hoście, aby maksymalnie wykorzystać zasoby.

Główne cele tej roli:

• uniknięcie marnotrawstwa: ponowne używanie tego samego hosta do dostarczania środowiska do budowy dla wielu repozytoriów lub organizacji;
• idempotencja: wykonanie roli wiele razy nie spowoduje żadnych problemów, ponieważ kroki mają kontrole, które weryfikują, czy powinny być wykonane;

Zmienne

Aby uzyskać pełną listę zmiennych, sprawdź plik defaults. Ideą jest, że wszystkie wartości będą miały komentarze opisujące ich przeznaczenie, a na podstawie domyślnej wartości można określić typ.

Wymagane zmienne

Oto wartości wymagane, ponieważ nie ma możliwości zarejestrowania samodzielnie hostowanego Runnera bez nich:

Przykład Playbooka

Najprostszy przypadek użycia: konfiguracja pojedynczego repozytorium na jednym hoście.

- hosts: foo
  roles:
    - role: macunha1.github_actions_runner
      vars:
        gh_runner_config_labels:
          - linux
          - self-hosted

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

Złożony przypadek użycia, dla którego stworzono tę rolę.

- hosts: foo
  roles:
    - role: macunha1.github_actions_runner
      vars:
        gh_runner_config_labels:
          - linux
          - self-hosted

        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

Zauważ, że pomimo używania tego samego hosta, każda z tych konfiguracji Runnerów GitHub Actions będzie miała swoją własną ścieżkę i dane uwierzytelniające. Dlatego mogą współistnieć bez zakłócania się nawzajem.

Współpraca

Czuj się swobodnie, aby zgłosić problem zawierający sugestie dotyczące funkcji lub (jeszcze lepiej) wysłać mi Pull request. Chętnie z Tobą współpracuję.

Jeśli ta rola nie działała dla Ciebie lub napotkałeś jakieś błędy podczas jej wykonywania, daj mi znać.