GitHub Actions selbstgehosteter Runner Ansible-Rolle

Eine Ansible-Rolle, die GitHub Actions selbstgehostete Runner auf einem oder mehreren Hosts installiert und konfiguriert. Sie können sie für viele verschiedene URLs (Repositories oder Organisationen) im selben Host wiederverwenden, um so viel wie möglich von ihr zu profitieren.

Die Hauptziele dieser Rolle:

• Abfall vermeiden: denselben Host wiederverwenden, um eine Build-Umgebung für mehrere Repositories oder Organisationen bereitzustellen;
• Idempotenz: mehrmaliges Ausführen der Rolle verursacht keine Probleme, die Schritte haben Prüfungen, die überprüfen, ob sie ausgeführt werden sollen oder nicht;

Variablen

Für eine vollständige Liste der Variablen überprüfen Sie die defaults Datei. Idealerweise haben alle Werte Kommentare, die ihren Zweck beschreiben, und am Standardwert können Sie den Typ erkennen.

Erforderliche Variablen

Die folgenden Werte sind erforderlich, da es keine Möglichkeit gibt, den selbstgehosteten Runner ohne sie zu registrieren.

Beispiel-Playbook

Einfachster Anwendungsfall: Konfiguration eines einzelnen Repositories auf einem Host.

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

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

Komplexer Anwendungsfall, für den diese Rolle erstellt wurde.

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

        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

Beachten Sie, dass trotz der Verwendung desselben Hosts jede der GitHub Actions Runner-Konfigurationen ihren eigenen Pfad und ihre eigenen Anmeldeinformationen haben wird. Daher können sie gut harmonieren, ohne sich gegenseitig zu schaden.

Mitwirken

Fühlen Sie sich frei, ein Issue zu erstellen, das Funktionsanfragen enthält, oder (noch besser) mir einen Pull-Request zu senden. Ich würde mich freuen, mit Ihnen zusammenzuarbeiten.

Wenn diese Rolle für Sie nicht funktioniert hat oder Sie während der Ausführung einen Fehler gefunden haben, lassen Sie es mich wissen.