GitHub ホステッドランナー

GitHub ホステッドランナーの概要

ランナーは、GitHub Actions ワークフローでジョブを実行するマシンです。たとえば、ランナーはリポジトリをローカルにクローンし、テストソフトウェアをインストールしてから、コードを評価するコマンドを実行できます。

GitHub は、ジョブの実行に使用できるランナーを提供します。または、独自のランナーをホストすることもできます。各 GitHub ホステッドランナーは、ランナーアプリケーションとその他のツールがプレインストールされた GitHub によってホストされる新しい仮想マシン (VM) であり、Ubuntu Linux、Windows、または macOS オペレーティングシステムで使用できます。 GitHubホストランナーを使用すると、マシンのメンテナンスとアップグレードが自動的に行われます。

標準の GitHub ホステッドランナーオプションのいずれかを選択できます。あるいは、GitHub Team または GitHub Enterprise Cloud プランの場合は、より多くのコアを持つランナー、または GPU プロセッサを搭載したランナーをプロビジョニングできます。これらのマシンは "より大きなランナー" と呼ばれます。詳しくは、「より大きなランナー」をご覧ください。

GitHub ホステッドランナーを使用するには、アップロードおよびダウンロード速度が 70 kbps 以上のネットワークアクセスが必要です。

メモ

GitHub でホストされるランナーの資格分は、マネージドユーザーアカウントでは利用できません。メンバーではない組織のリポジトリに貢献する Enterprise Managed Users は、組織リポジトリをフォークし、組織リポジトリを対象としたプルリクエストを開くことができます。これにより、組織の GitHub ホストランナーでワークフローが実行されます。詳しくは、「Enterprise Managed Users について」をご覧ください。

ランナーのイメージ

GitHub には、標準ホステッドランナー用の独自の VM イメージのセットが保持されています。これには、macOS、x64 Linux、Windows イメージ用のイメージが含まれます。イメージとそれに含まれるツールのリストは、actions/runner-images リポジトリで管理されています。 arm64 イメージはパートナーイメージであり、actions/partner-runner-images リポジトリで管理されています。

GitHub 所有イメージ用のプレインストール済みソフトウェア

GitHub 所有イメージに含まれるソフトウェアツールは、毎週更新されます。更新プロセスには数日かかり、main ブランチのプレインストール済みソフトウェアのリストは、デプロイ全体が終了した後で更新されます。

ワークフローログには、正確なランナーにプレインストールされているツールへのリンクが含まれています。ワークフローのログでこの情報を見つけるには、Set up job セクションを展開します。そのセクションの下で、Runner Image セクションを展開します。 Included Software の後のリンクで、ワークフローを実行したランナーにプレインストールされているツールが示されています。

詳しくは、「Viewing workflow run history」をご覧ください。

GitHubホストランナーには、オペレーティングシステムのデフォルトの組み込みツールに加え、上のリファレンスのリスト内のパッケージにが含まれています。たとえば、Ubuntu と macOS のランナーには、他の既定のツールと共に grep、find、which が含まれます。

Windows と Ubuntu のランナーイメージのビルドごとにソフトウェア部品表 (SBOM) を表示することもできます。詳しくは、「セキュリティで保護された使用に関するリファレンス」をご覧ください。

アクションを使用して、ランナーにインストールされているソフトウェアと対話することをお勧めします。この方法には、いくつかの利点があります。

アクションでは通常、バージョンの選択、引数を渡す機能、パラメータなどの機能が提供されています
これにより、ソフトウェアの更新に関係なく、ワークフローで使用されるツールのバージョンが同じままになります

要求したいツールがある場合は、actions/virtual-environments で issue を開いてください。このリポジトリには、ランナーに関するすべての主要なソフトウェア更新に関するお知らせも含まれています。

メモ

GitHub ホステッドランナーに追加のソフトウェアをインストールすることもできます。「GitHub ホステッドランナーのカスタマイズ」を参照してください。