macunha1.github_actions_runner

GitHub ActionsセルフホステッドランナーAnsibleロール

このAnsibleロールは、1つまたは複数のホストにGitHub Actionsセルフホステッドランナーをインストールし、設定します。 同じホスト内で異なるURL(リポジトリや組織)に対して再利用できるため、なるべく多くの再利用が可能です。

このロールの主な目的:

  • 無駄を避ける: 同じホストを再利用して、複数のリポジトリや組織にビルド環境を提供する。
  • 冪等性: ロールを何度実行しても問題が発生せず、実行すべきかどうかを検証するチェックがあります。

変数

変数の詳細なリストは、defaultsファイルを確認してください。理想的には、すべての値にその目的を説明するコメントがありますので、デフォルト値からタイプを判断できます。

必須の変数

以下の値は、セルフホステッドランナーを登録するために必要です。

名前 説明
gh_runner_config_url GitHubリポジトリまたは組織のURL
gh_runner_config_token ホストを認証するためのGitHub登録トークン

例プレイブック

最も単純なユースケース:1つのホスト上での単一リポジトリの設定。

- 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

このロールが作成された複雑なユースケース

- 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

同じホストを使用していても、これらのGitHub Actionsランナー設定はそれぞれ独自のパスと認証情報を持っています。したがって、お互いを干渉せずに共存できます。

貢献

PRs Welcome

フィーチャーリクエストを含む問題を作成するか、(さらに良いことに)プルリクエストを送ってください。喜んで協力いたします。

このロールがうまくいかなかった場合や、実行中にバグを見つけた場合はお知らせください。

プロジェクトについて

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

インストール
ansible-galaxy install macunha1.github_actions_runner
ライセンス
mit
ダウンロード
3.9k
所有者
cat /dev/null > /path/to/github/bio