セルフホストランナーアプリケーションをサービスとして設定する前に、ランナーをGitHubに追加しなければなりません。 詳しい情報については「セルフホストランナーの追加」を参照してください。
systemdを利用するLinuxのシステムでは、セルフホストランナーアプリケーションと共に配布されているsvc.shスクリプトを使い、セルフホストランナーアプリケーションをサービスとしてインストール及び管理できます。
ランナー マシンで、セルフホストランナー アプリケーションをインストールしたディレクトリでシェルを開きます。 以下のコマンドを使って、セルフホストランナーサービスをインストール及び管理します。
ノート: Windows上でサービスとしてセルフホストランナーアプリケーションを設定するのは、アプリケーションの設定プロセスの一部です。 セルフホストランナーアプリケーションをすでに設定していて、サービスとして設定していない場合には、そのランナーをGitHubから削除して、アプリケーションを設定しなおさなければなりません。 アプリケーションを再設定する場合には、アプリケーションをサービスとして設定するオプションを選択してください。
詳しい情報については「セルフホストランナーの削除」及び「セルフホストランナーの追加」を参照してください。
Windowsでは、ランナーサービスはサービスアプリケーションで管理できます。あるいは、以下のコマンドをPowerShellを使って実行することもできます。
セルフホストランナーアプリケーションをサービスとして設定する前に、ランナーをGitHubに追加しなければなりません。 詳しい情報については「セルフホストランナーの追加」を参照してください。
ランナー マシンで、セルフホストランナー アプリケーションをインストールしたディレクトリでシェルを開きます。 以下のコマンドを使って、セルフホストランナーサービスをインストール及び管理します。
サービスのインストール
-
セルフホストランナー アプリケーションが現在実行中の場合は、そのアプリケーションを停止します。
-
以下のコマンドでサービスをインストールしてください。
sudo ./svc.sh install
サービスのインストール
-
セルフホストランナー アプリケーションが現在実行中の場合は、そのアプリケーションを停止します。
-
以下のコマンドでサービスをインストールしてください。
./svc.sh install
サービスの起動
以下のコマンドでサービスを起動してください。
sudo ./svc.sh startStart-Service "actions.runner.*"./svc.sh startサービスのステータスチェック
以下のコマンドでサービスのステータスをチェックしてください。
sudo ./svc.sh statusGet-Service "actions.runner.*"./svc.sh statusセルフホストランナーの状態の表示に関する詳しい情報については、「セルフホストランナーのモニタリングとトラブルシューティング」を参照してください。
サービスの停止
以下のコマンドでサービスを停止してください。
sudo ./svc.sh stopStop-Service "actions.runner.*"./svc.sh stopサービスのアンインストール
-
もし実行中であれば、サービスを停止してください。
-
以下のコマンドでサービスをアンインストールしてください。
sudo ./svc.sh uninstallRemove-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エントリポイントを使って起動しなければなりません。