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ランナー設定はそれぞれ独自のパスと認証情報を持っています。したがって、お互いを干渉せずに共存できます。
貢献
フィーチャーリクエストを含む問題を作成するか、(さらに良いことに)プルリクエストを送ってください。喜んで協力いたします。
このロールがうまくいかなかった場合や、実行中にバグを見つけた場合はお知らせください。
プロジェクトについて
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