コンテンツにスキップ
Documentation

Runner コマンド

すべてのコマンドは champrep-code-runner <command>。追加 -h 任意のコマンドの前に を付けて実行すると、そのオプションを確認できます。例えば champrep-code-runner service -h.

タスクコマンド
このマシンをランナーに接続する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

Terminal window
champrep-code-runner run

ランナーは、停止するまで実行を続け、ジョブを受け付けます。 Ctrl+C ジョブの実行が完了した後、一度押すと停止します。もう一度押すと、ジョブを中断します。

サービスは起動時にランナーを起動し、障害発生後に再起動します。まず マシンを登録してください: service install ランナーが含まれていない設定は拒否されます。

Terminal window
sudo champrep-code-runner service install # install, enable at boot and start
champrep-code-runner service status # running, stopped or not installed
sudo champrep-code-runner service stop # running jobs finish first
sudo champrep-code-runner service start
sudo champrep-code-runner service uninstall # stop and remove the service

service status を出力します running, stopped または not installed。サービスが実行されていない場合は コード 3 で終了するため、スクリプトでこれを確認できます。

オプション意味
--config PATHサービスが使用する設定ファイルです。
--name NAMEサービス名です。1台のマシン上で異なる設定の複数のランナーを実行する場合は、それぞれ異なる名前を使用してください。
--user USERroot や LocalSystem ではなく、このユーザーとしてサービスを実行してください。

root 権限で実行すると、ランナーは champrep-code-runner。 別のユーザーとして実行する場合は、ログイン中に実行されるユーザーサービスが インストールされます( loginctl enable-linger (実行し続けるため)。systemdを 直接使用することも可能です:

Terminal window
systemctl status champrep-code-runner
journalctl -u champrep-code-runner -f # follow the logs

Docker エグゼキュータの場合、サービスユーザーは Docker ソケットへのアクセス権が必要ですが、 これはそのマシン上の root 権限に相当します。専用のビルドマシンを使用してください。

root 権限で実行すると、ランナーは起動時に実行される LaunchDaemon (com.champrep.code-runner)が 起動時に実行されます。別のユーザーとして、ログイン中に実行されるLaunchAgentを インストールします。これは、キーチェーン、シミュレータ、またはコード 署名が必要なタスクに適しています。ログ:

Terminal window
tail -f /Library/Logs/champrep-code-runner.log # LaunchDaemon
tail -f ~/Library/Logs/champrep-code-runner.log # LaunchAgent

管理者権限の PowerShell プロンプトから:

Terminal window
champrep-code-runner.exe service install
Get-Service champrep-code-runner

このサービスはバイナリを現在の場所から実行するため、まず安定した場所に コピーしてください。ログは champrep-code-runner.log 設定ファイルの隣 (%ProgramData%\champrep-runner\).

コマンド機能の概要
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 別の設定ファイルを使用するには。

ヘルスおよびメトリクスのエンドポイントを公開するために、リスンアドレスを指定してランナーを起動します:

Terminal window
champrep-code-runner run --listen-address 127.0.0.1:9252
パス意味
/healthzプロセスの実行中は200となります。
/readyzすべてのランナーが検証され、ジョブをリクエストしている場合、200となります。
/metricsPrometheus メトリクス:実行中、完了、失敗したジョブなど。

ログは構造化されたJSON形式であり、トークン、変数、ジョブの出力は一切含まれません。