ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

セルフホストランナーの追加

リポジトリ、Organization、Enterpriseにセルフホストランナーを追加できます。

ここには以下の内容があります:

Note: GitHub Actions was available for GitHub Enterprise Server 2.22 as a limited beta. The beta has ended. GitHub Actions is now generally available in GitHub Enterprise Server 3.0 or later. For more information, see the GitHub Enterprise Server 3.0 release notes.


Note: GitHub-hosted runners are not currently supported on GitHub Enterprise Server. You can see more information about planned future support on the GitHub public roadmap.

リポジトリ、Organization、Enterpriseにセルフホストランナーを追加できます。

Organization または Enterprise 管理者の場合は、Organization または Enterprise レベルでセルフホストランナーを追加することをお勧めします。 このアプローチにより、Organization または Enterprise 内の複数のリポジトリでランナーを使用できるようになり、ランナーを1か所で管理することもできます。

セルフホストランナーでサポートされているオペレーティングシステム、あるいはプロキシサーバーとセルフホストランナーを使う方法に関する情報については、「セルフホストランナーについて」を参照してください。

警告: パブリックリポジトリでは、セルフホストランナーを使わないことをおすすめします。

パブリックリポジトリのフォークでは、ワークフロー中のコードを実行するプルリクエストが作成されると、セルフホストランナー上で危険なコードが実行される可能性があります。

詳しい情報については「セルフホストランナーについて」を参照してください。

リポジトリへのセルフホストランナーの追加

単一のリポジトリにセルフホストランナーを追加できます。 セルフホストランナーをユーザのリポジトリに追加するには、リポジトリのオーナーでなければなりません。 Organizationのリポジトリの場合は、Organizationのオーナーであるか、そのリポジトリの管理アクセスを持っていなければなりません。

  1. GitHub Enterprise Serverで、リポジトリのメインページにアクセスしてください。

  2. リポジトリ名の下で Settings(設定)をクリックしてください。

    リポジトリの設定ボタン

  3. サイドバーでActions(アクション)をクリックしてください。

    アクションの設定

  4. [Self-hosted runners] で、[Add runner] をクリックします。

  5. 使用するセルフホストランナーマシンのオペレーティングシステムとアーキテクチャを選択してください。

    セルフホストランナーのオペレーティングシステムの選択

  6. ランナーアプリケーションをダウンロードして、使用するセルフホストランナーのマシンにインストールする方法が表示されます。

    セルフホストランナーのマシンでシェルを開き、表示順に従ってシェルコマンドを実行してください。

    ノート: Windowsでは、セルフホストランナーアプリケーションをサービスとしてインストールしたいのなら、シェルを管理者権限でオープンしなければなりません。 また、C:\actions-runnerをセルフホストランナーアプリケーションのためのディレクトリとして利用し、Windowsのシステムアカウントがランナーディレクトリにアクセスできるようにすることをおすすめします。

    この指示に従えば、以下のタスクが完了します。

    • セルフホストランナーアプリケーションのダウンロードと展開。
    • configスクリプトを実行してセルフホストランナーアプリケーションを設定し、GitHub Actionsに登録します。 configスクリプトには、登録先のURLと、リクエストを認証してもらうための自動的に生成された時間限定のあるトークンが必要です。
      • Windowsでは、configスクリプトはセルフホストランナーをサービスとしてインストールするかも聞いてきます。 LinuxとmacOSでは、ランナーの追加を終えた後にサービスをインストールできます。 詳しい情報については「サービスとしてセルフホストランナーを構成する」を参照してください。
    • セルフホストランナーアプリケーションを実行して、マシンをGitHub Actionsに接続します。

セルフホストランナーの追加に成功したことの確認

セルフホストランナーを追加するステップを完了したら、「Self-hosted runners(セルフホストランナー)」の下のリストにランナーとそのステータスが表示されます。

ジョブをランナーが受け付けるためには、セルフホストランナーアプリケーションが動作していなければなりません。 ランナーアプリケーションがGitHub Enterprise Serverに接続してジョブの受信準備ができたなら、以下のメッセージがマシンのターミナルに表示されます。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

詳しい情報については「セルフホストランナーのモニタリングとトラブルシューティング」を参照してください。

Organizationへのセルフホストランナーの追加

セルフホストランナーをOrganizationのレベルで追加し、Organization内の複数のリポジトリのジョブを処理するために使うことができます。 Organizationにセルフホストランナーを追加するには、Organizationのオーナーでなければなりません。

  1. GitHub Enterprise Serverで、Organizationのメインページにアクセスしてください。

  2. Organization名の下で、Settings(設定)をクリックしてください。

    Organizationの設定ボタン

  3. サイドバーでActions(アクション)をクリックしてください。

    アクションの設定

  4. [Self-hosted runners] で [Add new] をクリックし、[New runner] をクリックします。

  5. 使用するセルフホストランナーマシンのオペレーティングシステムとアーキテクチャを選択してください。

    セルフホストランナーのオペレーティングシステムの選択

  6. ランナーアプリケーションをダウンロードして、使用するセルフホストランナーのマシンにインストールする方法が表示されます。

    セルフホストランナーのマシンでシェルを開き、表示順に従ってシェルコマンドを実行してください。

    ノート: Windowsでは、セルフホストランナーアプリケーションをサービスとしてインストールしたいのなら、シェルを管理者権限でオープンしなければなりません。 また、C:\actions-runnerをセルフホストランナーアプリケーションのためのディレクトリとして利用し、Windowsのシステムアカウントがランナーディレクトリにアクセスできるようにすることをおすすめします。

    この指示に従えば、以下のタスクが完了します。

    • セルフホストランナーアプリケーションのダウンロードと展開。
    • configスクリプトを実行してセルフホストランナーアプリケーションを設定し、GitHub Actionsに登録します。 configスクリプトには、登録先のURLと、リクエストを認証してもらうための自動的に生成された時間限定のあるトークンが必要です。
      • Windowsでは、configスクリプトはセルフホストランナーをサービスとしてインストールするかも聞いてきます。 LinuxとmacOSでは、ランナーの追加を終えた後にサービスをインストールできます。 詳しい情報については「サービスとしてセルフホストランナーを構成する」を参照してください。
    • セルフホストランナーアプリケーションを実行して、マシンをGitHub Actionsに接続します。

セルフホストランナーの追加に成功したことの確認

セルフホストランナーを追加するステップを完了したら、「Self-hosted runners(セルフホストランナー)」の下のリストにランナーとそのステータスが表示されます。

ジョブをランナーが受け付けるためには、セルフホストランナーアプリケーションが動作していなければなりません。 ランナーアプリケーションがGitHub Enterprise Serverに接続してジョブの受信準備ができたなら、以下のメッセージがマシンのターミナルに表示されます。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

詳しい情報については「セルフホストランナーのモニタリングとトラブルシューティング」を参照してください。

Note: For security reasons, public repositories can't use runners in a runner group by default, but you can override this in the runner group's settings. 詳しい情報については、「グループを使用したセルフホストランナーへのアクセスを管理する」を参照してください。

セルフホストランナーを Enterprise に追加する

セルフホストランナーを Enterprise に追加して、複数の Organization に割り当てることができます。 Organization の管理者は、そのランナーを使用できるリポジトリを制御できます。

セルフホストランナーを your GitHub Enterprise Server instance の Enterprise レベルで削除するには、サイト管理者である必要があります。

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。

    Enterpriseアカウントサイドバー内のポリシータブ

  3. Under " Policies", click Actions.

  4. [Self-hosted runners] タブをクリックします。

  5. [Add new] をクリックし、[New runner] をクリックします。 新しいランナーがデフォルトグループに割り当てられます。 ランナーを登録した後、ランナーのグループを変更できます。 詳しい情報については、「セルフホストランナーへのアクセスを管理する」を参照してください。

  6. 使用するセルフホストランナーマシンのオペレーティングシステムとアーキテクチャを選択してください。

    セルフホストランナーのオペレーティングシステムの選択

  7. ランナーアプリケーションをダウンロードして、使用するセルフホストランナーのマシンにインストールする方法が表示されます。

    セルフホストランナーのマシンでシェルを開き、表示順に従ってシェルコマンドを実行してください。

    ノート: Windowsでは、セルフホストランナーアプリケーションをサービスとしてインストールしたいのなら、シェルを管理者権限でオープンしなければなりません。 また、C:\actions-runnerをセルフホストランナーアプリケーションのためのディレクトリとして利用し、Windowsのシステムアカウントがランナーディレクトリにアクセスできるようにすることをおすすめします。

    この指示に従えば、以下のタスクが完了します。

    • セルフホストランナーアプリケーションのダウンロードと展開。
    • configスクリプトを実行してセルフホストランナーアプリケーションを設定し、GitHub Actionsに登録します。 configスクリプトには、登録先のURLと、リクエストを認証してもらうための自動的に生成された時間限定のあるトークンが必要です。
      • Windowsでは、configスクリプトはセルフホストランナーをサービスとしてインストールするかも聞いてきます。 LinuxとmacOSでは、ランナーの追加を終えた後にサービスをインストールできます。 詳しい情報については「サービスとしてセルフホストランナーを構成する」を参照してください。
    • セルフホストランナーアプリケーションを実行して、マシンをGitHub Actionsに接続します。

セルフホストランナーの追加に成功したことの確認

セルフホストランナーを追加するステップを完了したら、「Self-hosted runners(セルフホストランナー)」の下のリストにランナーとそのステータスが表示されます。

ジョブをランナーが受け付けるためには、セルフホストランナーアプリケーションが動作していなければなりません。 ランナーアプリケーションがGitHub Enterprise Serverに接続してジョブの受信準備ができたなら、以下のメッセージがマシンのターミナルに表示されます。

√ Connected to GitHub

2019-10-24 05:45:56Z: Listening for Jobs

詳しい情報については「セルフホストランナーのモニタリングとトラブルシューティング」を参照してください。

Note: For security reasons, public repositories can't use runners in a runner group by default, but you can override this in the runner group's settings. 詳しい情報については、「グループを使用したセルフホストランナーへのアクセスを管理する」を参照してください。

Enterprise ランナーをリポジトリで利用可能にする

デフォルトでは、Enterprise の「デフォルト」のセルフホストランナーグループのランナーは、Enterprise 内のすべての Organization で使用できますが、各 Organization のすべてのリポジトリで使用できるわけではありません。

Enterprise レベルのセルフホストランナーグループを Organization リポジトリで使用できるようにするには、ランナーグループの Organization の継承設定を変更して、Organization 内のリポジトリでランナーを使用できるようにする必要がある場合があります。

ランナーグループのアクセス設定の変更に関する詳しい情報については、「グループを使用したセルフホストランナーへのアクセスを管理する」を参照してください。

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.