mcpField
R
rhdh-prow-jobs

rhdh-prow-jobs

github.com/redhat-developerテスト・品質1943 回インストール1 日前に更新
リポジトリ

rhdh-prow-jobs について

rhdh-prow-jobsは、openshift/release内のRHDH Prowテスト項目とクラスター プールを調査・変更するスキルです。既存リリースブランチのカバレッジ分析に対応し、OCP、AKS、EKS、GKEのワークフローを提供します。

主な機能

  1. 01OCPテスト項目の一覧表示と管理
  2. 02Hive ClusterPoolの管理
  3. 03OCPカバレッジ不足の分析
  4. 04AKS、EKS、GKE項目の一覧表示
  5. 05Kubernetesバージョンの更新

活用シーン

  1. 01設定済みプラットフォームテスト項目の確認
  2. 02OCPテスト項目の追加または削除
  3. 03OCPのカバレッジ不足の特定
  4. 04クラウド項目のKubernetesバージョン変更

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redhat-developer/rhdh-skills --skill rhdh-prow-jobs

インストール後、Claude Code で/rhdh-prow-jobsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
scripts/
analyze_coverage.py
generate_cluster_pool.py
generate_test_entry.py
list_aks_jobs.py
list_cluster_pools.py
list_eks_jobs.py
list_gke_jobs.py
list_ocp_test_configs.py
scripts/rhdh_prow/
__init__.py
k8s_configs.py
openshift_release.py
versions.py
workflows/
k8s-jobs.md
ocp-coverage.md
ocp-jobs.md
ocp-pools.md

詳細

RHDH Prow テストエントリーとクラスタープール

openshift/release で RHDH のテスト対象となるプラットフォームバージョンを確認し、変更します。 一覧表示とカバレッジ分析は、gh 経由でリモートリポジトリを対象に実行できます。 生成と削除では、処理の最後に make update を実行するため、ローカルのチェックアウトが必要です。

YAML のロジックを再構築せず、同梱のスクリプトを実行してください。すべてのスクリプトは --repo-dir を受け取り、ローカルの openshift/release チェックアウトを指定できます。指定がない場合は、GitHub API を使用します。

手順

目的読み込むファイル
OCP テストエントリーを一覧表示する、または追加・削除するworkflows/ocp-jobs.md
Hive ClusterPool を一覧表示、生成、または削除するworkflows/ocp-pools.md
OCP のカバレッジギャップと古い設定を見つけるworkflows/ocp-coverage.md
AKS、EKS、または GKE のエントリーを一覧表示する、または K8s バージョンを更新するworkflows/k8s-jobs.md

選択したワークフローのみを読み込んでください。

対象範囲

このスキルは、既存のブランチにある個々のテストエントリーとクラスタープールを対象とします。リリースブランチのジョブ一式（ブランチ設定ファイル、生成されたジョブ、ブランチ保護ブロック）を作成または廃止する作業は /rhdh-prow-release-branch の対象です。設定済みのジョブをオンデマンドで実行する作業は /rhdh-prow-trigger の対象です。

連携

プラットフォームバージョンがまだサポートされているかどうかを確認するには、/rhdh-platform-lifecycle を名前で呼び出し、その返却内容を使用してください。その Python パッケージをインポートしたり、ファイルを読み込んだりしないでください。scripts/analyze_coverage.py はライフサイクル API を直接クエリするため、スクリプトは単独で動作します。

読み取りルール

  • 読み取りで得たバージョンのみを報告し、記憶に基づいて報告しないでください。どの設定ソースをいつ読み取ったかを明記してください。
  • OCP バージョンはテスト名ではなく、cluster_claim.version から抽出してください。OCP を対象とするテストでも、名前にバージョンが含まれないものがあります。
  • 設定されているバージョンと、サポートされているバージョンは同じではありません。ライフサイクル情報がない場合は、設定済みのバージョンをサポート対象として示すのではなく、未分類のままのプラットフォームを明記してください。

書き込みルール

ファイルの生成、設定の編集、make update の実行、コミット、プッシュ、プルリクエストの作成は書き込み操作です。各操作の対象となる設定ファイルまたはジョブファイルを指定し、/mutation-gate に従ってください。

  • 書き込む前に、generate_cluster_pool.py で --dry-run を指定してプレビューしてください。
  • generate_test_entry.py は確認用のブロックを出力します。これを挿入する作業は、別途承認を受けた編集です。
  • 設定を変更した後は、make update を実行してください。設定ファイルと生成されたジョブファイルを一緒にコミットしてください。
  • OCP バージョンを削除する場合は、すべての製品ブランチにあるそのバージョンのテストエントリーとクラスタープールの両方を削除します。削除完了とする前に、もう一方も確認してください。

完了条件

読み取りは、回答に読み取った設定ソースが明記され、エントリー、プール、ギャップのすべてがその読み取り結果に基づいており、スキャンでアクセスできなかったものは存在しないと報告するのではなく、未読み取りとして明記されていれば完了です。

書き込みは、承認されたすべてのファイル編集が適用されて報告され、make update が実行され、ci-operator/jobs/redhat-developer/rhdh/ 以下の再生成されたジョブファイルが設定変更とともに明記され、プッシュとプルリクエストの状況が明示されていれば完了です。何もプッシュしていない場合は「プッシュしていません」と明記してください。削除は、そのバージョンのテストエントリーとクラスタープールの両方が確認できた場合にのみ完了です。

コメント

Markdown 対応