Runner コマンド
すべてのコマンドは champrep-code-runner <command>。追加 -h 任意のコマンドの前に を付けて実行すると、そのオプションを確認できます。例えば champrep-code-runner service -h.
日常的なコマンド
Section titled “日常的なコマンド”| タスク | コマンド |
|---|---|
| このマシンをランナーに接続する | champrep-code-runner register --url https://code.champrep.com |
| このターミナルで実行してください | champrep-code-runner run |
| サービスとしてインストールし、起動してください | champrep-code-runner service install |
| 実行されていますか? | champrep-code-runner service status |
| 停止するには(実行中のジョブが先に完了します) | champrep-code-runner service stop |
| 再度起動する | champrep-code-runner service start |
| ランナーのトークンを確認してください | champrep-code-runner verify |
| インストールされたバージョンを表示する | champrep-code-runner version |
| 設定ファイルをご確認ください | champrep-code-runner check-config |
ターミナルで実行する
Section titled “ターミナルで実行する”champrep-code-runner runランナーは、停止するまで実行を続け、ジョブを受け付けます。 Ctrl+C ジョブの実行が完了した後、一度押すと停止します。もう一度押すと、ジョブを中断します。
サービスとして実行する
Section titled “サービスとして実行する”サービスは起動時にランナーを起動し、障害発生後に再起動します。まず マシンを登録してください: service install ランナーが含まれていない設定は拒否されます。
sudo champrep-code-runner service install # install, enable at boot and startchamprep-code-runner service status # running, stopped or not installedsudo champrep-code-runner service stop # running jobs finish firstsudo champrep-code-runner service startsudo champrep-code-runner service uninstall # stop and remove the serviceservice status を出力します running, stopped または not installed。サービスが実行されていない場合は コード 3 で終了するため、スクリプトでこれを確認できます。
| オプション | 意味 |
|---|---|
--config PATH | サービスが使用する設定ファイルです。 |
--name NAME | サービス名です。1台のマシン上で異なる設定の複数のランナーを実行する場合は、それぞれ異なる名前を使用してください。 |
--user USER | root や LocalSystem ではなく、このユーザーとしてサービスを実行してください。 |
root 権限で実行すると、ランナーは champrep-code-runner。 別のユーザーとして実行する場合は、ログイン中に実行されるユーザーサービスが インストールされます( loginctl enable-linger (実行し続けるため)。systemdを 直接使用することも可能です:
systemctl status champrep-code-runnerjournalctl -u champrep-code-runner -f # follow the logsDocker エグゼキュータの場合、サービスユーザーは Docker ソケットへのアクセス権が必要ですが、 これはそのマシン上の root 権限に相当します。専用のビルドマシンを使用してください。
root 権限で実行すると、ランナーは起動時に実行される LaunchDaemon (com.champrep.code-runner)が 起動時に実行されます。別のユーザーとして、ログイン中に実行されるLaunchAgentを インストールします。これは、キーチェーン、シミュレータ、またはコード 署名が必要なタスクに適しています。ログ:
tail -f /Library/Logs/champrep-code-runner.log # LaunchDaemontail -f ~/Library/Logs/champrep-code-runner.log # LaunchAgentWindows
Section titled “Windows”管理者権限の PowerShell プロンプトから:
champrep-code-runner.exe service installGet-Service champrep-code-runnerこのサービスはバイナリを現在の場所から実行するため、まず安定した場所に コピーしてください。ログは champrep-code-runner.log 設定ファイルの隣 (%ProgramData%\champrep-runner\).
すべてのコマンド
Section titled “すべてのコマンド”| コマンド | 機能の概要 |
|---|---|
register | ランナー トークンを確認し、設定にランナーを追加してください。 |
verify [--name N] | 設定されたランナーのトークンを確認します。トークンが無効な場合は、終了コード 1 を返します。 |
run | 停止するまで実行されます。 --log-file PATH ログをファイルに書き込みます。 |
run-single [--name N] [--max-jobs 1] | 1つのランナーのジョブを実行した後、終了します。短期間しか稼働しないマシンに便利です。 |
service install|start|stop|status|uninstall | ランナーをサービスとして管理します。 |
reset-token [--name N] | 新しいトークンを取得し、保存してください。古いトークンは、短い猶予期間中は引き続き使用可能です。 |
unregister --name N または --all | 設定および CodeCHAMPREP から、このマシンのランナーを削除します。 |
check-config | 設定ファイルの検証を行い、警告を表示します。 |
version | バージョン、リビジョン、およびプラットフォームを表示します。 |
すべてのコマンドは以下の引数を受け付けます --config PATH 別の設定ファイルを使用するには。
ヘルスチェックとメトリクス
Section titled “ヘルスチェックとメトリクス”ヘルスおよびメトリクスのエンドポイントを公開するために、リスンアドレスを指定してランナーを起動します:
champrep-code-runner run --listen-address 127.0.0.1:9252| パス | 意味 |
|---|---|
/healthz | プロセスの実行中は200となります。 |
/readyz | すべてのランナーが検証され、ジョブをリクエストしている場合、200となります。 |
/metrics | Prometheus メトリクス:実行中、完了、失敗したジョブなど。 |
ログは構造化されたJSON形式であり、トークン、変数、ジョブの出力は一切含まれません。