rhdh-prow-trigger

RHDH の nightly ProwJob をトリガーする

openshift/release ですでに設定されているジョブを実行します。このスキルは CI 設定を編集しません。どのジョブを用意するかを変更する場合、テストエントリーとプールには /rhdh-prow-jobs、リリースブランチのジョブ一式には /rhdh-prow-release-branch を使用します。

手順

workflows/trigger-nightly.md を読み込みます。ジョブの一覧表示、自然言語のリクエストから完全なジョブ名への対応付け、オーバーライドオプション、実行について説明しています。

認証

scripts/trigger_nightly_job.py は専用の kubeconfig ~/.config/openshift-ci/kubeconfig を使用するため、ユーザーの現在のクラスターコンテキストに影響しません。既存の oc セッションを使用し、ログインは行いません。

ライブ送信と --status には、そのセッションが必要です。oc が見つからない場合、専用 kubeconfig がない場合、またはセッションの有効期限が切れている場合は停止し、ユーザーに /setup-rhdh-skills openshift-ci の実行を案内してください。ログインはセットアップが担当し、このスキルでは行いません。オフラインでのプレビューと、公開されているジョブやタグの一覧表示には認証は必要ありません。

公開スクリプトは scripts/gangway_adapter.py に kubeconfig のパスとリクエストペイロードのみを渡します。このアダプターだけが一時的な認証情報を取得してリクエストを認証し、認証情報を含まないレスポンスデータを返します。トークンを引数や出力に含めたり、ユーザーに報告したりしないでください。

実行ルール

ジョブのトリガーは外部への書き込みです。--dry-run、--list、--list-tags、--status は該当しません。完全なジョブ名を対象として、/mutation-gate に従ってください。

• まず --dry-run でプレビューします。オフラインで、サポート対象の nightly 名とフラグを検証し、認証情報へのアクセス、設定の作成、ネットワークリクエストを行わずに、アダプターへのリクエストを出力します。ジョブ、イメージ、チャートが存在するかどうかは検証しません。ライブ送信では、所有リポジトリに設定されているジョブ一覧を確認し、所属を検証できない場合は停止します。--skip-job-check は緊急時に限り、この確認を回避します。
• プレビューには、実行するコマンド全体、パラメーター、リソースへの影響、不明なコスト、中止方法、失敗時の動作、検証手順が含まれます。書き込みゲートで使用し、--dry-run なしで実行する前に明示的な承認を得てください。
• GKE と OSD-GCP はそれぞれ 1 つのクラスターを共有しています。同じプラットフォームでジョブが実行中の場合、2 つ目のジョブを開始しないでください。どちらかをトリガーする前にユーザーへ警告してください。
• 調査やドライランへの承認は、実行への承認ではありません。改めて確認してください。
• --image-repo には --tag が必要です。--tag は単独でも使用できます。--playwright-version は overlay 専用です。overlay ジョブでは、イメージ、チャート、アラートのオーバーライドは拒否されます。

完了

トリガーは、実行したコマンドを実行時のまま正確に示し、Gangway API のレスポンスを報告し、実行 URL または ID を目立つ形で示した時点で完了です。API から識別子が返されなかった場合は、その不在を明記し、暗に示すだけにしないでください。ドライランは、出力されたリクエストを示し、何も実行されていないことが明確になった時点で完了です。失敗は、考えられる原因（よくある原因は認証の有効期限切れ）とともにエラーを報告し、セッションに問題がある場合はユーザーに /setup-rhdh-skills openshift-ci を案内した時点で完了です。いずれの場合も、認証情報を含めてはいけません。