メインコンテンツまでスキップ

CI ラベル

GitHub Actions では、GITHUB_JOB はワークフローファイル上のジョブキーです。マトリクスジョブの各インスタンスは、そのキーを共有します。それらを区別するには、--label ci.job=${{ github.job }}-${{ strategy.job-index }} を渡します。このフラグは、自動検出を上書きします。

yb ci​

yb ci env は、現在のジョブについて YABANIN_GATEWAY_URL、YABANIN_LABELS、ANTHROPIC_BASE_URL、ANTHROPIC_CUSTOM_HEADERS を出力します。--openai-env は OPENAI_BASE_URL を追加します。--with-key は、CI キーを YABANIN_API_KEY、OPENAI_API_KEY、ANTHROPIC_AUTH_TOKEN としても出力します。

yb ci exec -- <command> は、その環境を子プロセスだけに設定します。親シェルは変わらず、コマンドの stdout は子の stdout です。codex または opencode が PATH 上にある場合、子は一時的な Codex 設定、または OPENCODE_CONFIG_CONTENT も受け取ります。--isolate は CLAUDE_CONFIG_DIR を空のディレクトリに向け、ランナーの設定ファイルがヘッダーを上書きできないようにします。プロセスの終了コードは、子の終了コードです。yabanin-ci.json には、ラベル、タイムスタンプ、終了コード、利用状況が記録されます。セッションモードでは、ファイルは complete: true を最大 30 秒待ちます。ヘッダーモードでは、2 回の読み取りが一致するか、30 秒が経過するまでポーリングします。can_read_usage のないキーでもレポートは書き込まれますが、usage は null になり、stderr に警告が出ます。

yb ci report --pipeline は、パイプラインを合計します。GitLab では、デフォルトのウィンドウは CI_PIPELINE_CREATED_AT から始まります。--fail-over-cost は、コストが上回っている場合、レポートを書き込んだあと終了コード 4 で終了します。--gitlab-metrics は、artifacts:reports:metrics 向けに OpenMetrics(yabanin_cost_usd、yabanin_tokens_in、yabanin_tokens_out、yabanin_requests)を書き込みます。GitLab はそのウィジェットを Premium と Ultimate で表示します。Free では、ファイルはアーティファクトにすぎません。

yb ci finish は、コマンドを実行せずにレポートを書き込みます。finish ステップが実行されない場合、セッションキーはその TTL で期限切れになります。

インストール用スニペットと、バイナリのチェックサム変数は integrations/README.md にあります。

パイプラインまたはチケットのコスト​

yb ci exec --session=on は、CI キーが can_mint_sessions を持つとき、ybs_ キーを発行します。子が受け取るのはそのキーであり、長寿命のキーではありません。レポートは、complete が true になるか 30 秒が経過するまで、GET /v1/yabanin/session-keys/{id}/usage をポーリングします。ヘッダーモードは、2 つのボディが一致するまで GET /v1/yabanin/usage をポーリングします。いずれの場合も、yabanin-ci.json は version が 1、mode、session_key_id(セッションがないときは null)、usage を持ちます。

yb ci report --pipeline は、パイプラインを合計します。同じ実行に対するエクスプローラーのフィルターは、label.ci.pipeline = "<id>" です。チケットは、方針が導出したラベルを使います。通常は label.issue = "PAY-123" です。

label.issue = "PAY-123"

CI ボードのパイプラインパネルは、cost_usd を label:ci.pipeline でグループ化します。そのため、ログにリクエストが入ると、同じ id が同じリクエストを示します。セッションモードは、それらのリクエストを親キーとセッション id に帰属させます。

セキュリティ​

CI キーはマスクされ、保護されています。フォークからのワークフローに、それを渡してはいけません。フォークからの pull_request は、シークレットを受け取りません。プルリクエストのコードを実行するために pull_request_target を使わないでください。そのイベントは、信頼できないコードへシークレットを公開します。

CI キーには、最小限の権限を与えます。セッションキーの発行と、自身の利用状況の読み取りです。組織の管理権限は付与しないでください。

GitLab では、キーを dotenv アーティファクトに書き込まないでください。yb ci env --format gitlab-dotenv --with-key は、--allow-secret-dotenv が設定されていない限り拒否します。キーを子だけに渡す yb ci exec を優先してください。

yb は API キーを表示しません。yb ci env --format github は、各シークレットの前に ::add-mask:: を出力します。yb harness key と yb key print は、ヘルパープロセス向けに、末尾の改行も他のテキストもなくキーを書き込みます。ログ向けではありません。