このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2021-09-23. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

セルフホストランナーアプリケーションをサービスとして設定する

セルフホストランナーアプリケーションをサービスとして設定し、マシンの起動時に自動的にランナーアプリケーションが開始されるようにできます。

ノート: GitHub Actionsは、GitHub Enterprise Server 2.22で限定ベータとして利用可能でした。 ベータは終了しました。 GitHub Actionsは、GitHub Enterprise Server 3.0以降で一般に利用可能になりました。 詳しい情報については、GitHub Enterprise Server 3.0 のリリースノートを参照してください。


ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情報を見ることができます。

セルフホストランナーアプリケーションをサービスとして設定する前に、ランナーをGitHub Enterprise Serverに追加しなければなりません。 詳しい情報については「セルフホストランナーの追加」を参照してください。

systemdを利用するLinuxのシステムでは、セルフホストランナーアプリケーションと共に配布されているsvc.shスクリプトを使い、セルフホストランナーアプリケーションをサービスとしてインストール及び管理できます。

ランナー マシンで、セルフホストランナー アプリケーションをインストールしたディレクトリでシェルを開きます。 以下のコマンドを使って、セルフホストランナーサービスをインストール及び管理します。

ノート: Windows上でサービスとしてセルフホストランナーアプリケーションを設定するのは、アプリケーションの設定プロセスの一部です。 セルフホストランナーアプリケーションをすでに設定していて、サービスとして設定していない場合には、そのランナーをGitHubから削除して、アプリケーションを設定しなおさなければなりません。 アプリケーションを再設定する場合には、アプリケーションをサービスとして設定するオプションを選択してください。

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

Windowsでは、ランナーサービスはサービスアプリケーションで管理できます。あるいは、以下のコマンドをPowerShellを使って実行することもできます。

セルフホストランナーアプリケーションをサービスとして設定する前に、ランナーをGitHub Enterprise Serverに追加しなければなりません。 詳しい情報については「セルフホストランナーの追加」を参照してください。

ランナー マシンで、セルフホストランナー アプリケーションをインストールしたディレクトリでシェルを開きます。 以下のコマンドを使って、セルフホストランナーサービスをインストール及び管理します。

サービスのインストール

  1. セルフホストランナー アプリケーションが現在実行中の場合は、そのアプリケーションを停止します。

  2. 以下のコマンドでサービスをインストールしてください。

    sudo ./svc.sh install

サービスのインストール

  1. セルフホストランナー アプリケーションが現在実行中の場合は、そのアプリケーションを停止します。

  2. 以下のコマンドでサービスをインストールしてください。

    ./svc.sh install

サービスの起動

以下のコマンドでサービスを起動してください。

sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start

サービスのステータスチェック

以下のコマンドでサービスのステータスをチェックしてください。

sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status

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

サービスの停止

以下のコマンドでサービスを停止してください。

sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop

サービスのアンインストール

  1. もし実行中であれば、サービスを停止してください。

  2. 以下のコマンドでサービスをアンインストールしてください。

    sudo ./svc.sh uninstall
    Remove-Service "actions.runner.*"
    ./svc.sh uninstall

セルフホストランナーサービスのカスタマイズ

上記のデフォルトのsystemdサービス設定を使いたくないなら、カスタマイズされたサービスを作成するか、好みのサービスの仕組みを使うことができます。 リファレンスとしてactions-runner/bin/actions.runner.service.templateにあるservicedテンプレートの利用を検討してください。 カスタマイズされたサービスを使う場合、セルフホストランナーサービスは常にrunsvc.shエントリポイントを使って起動しなければなりません。

セルフホストランナーサービスのカスタマイズ

上記のデフォルトのlaunchdサービス設定を使いたくないなら、カスタマイズされたサービスを作成するか、好みのサービスの仕組みを使うことができます。 リファレンスとしてactions-runner/bin/actions.runner.plist.templateにあるplistテンプレートの利用を検討してください。 カスタマイズされたサービスを使う場合、セルフホストランナーサービスは常にrunsvc.shエントリポイントを使って起動しなければなりません。

問題がまだ解決していませんか?