CI Quality Gate

CI Quality Gate を使用すると、継続的インテグレーション (CI) ビルドがそれに含まれている問題に基づいて合格となるか失格となるか判断される基準を定義することができます。そうすることで、カスタムスクリプトが置き換えられ、CI/CD ワークフローが、一貫性のある、組み込みの‑Validation に適合するものとなります。

CI ビルドがプロジェクトにロードされると、構成された Quality Gate クエリを使用して、Validate が自動的にビルドを評価します。クエリに一致する問題がある場合は、ビルドが Quality Gate: Failed とマークされます。

Quality Gate は (--ci-build を使用して作成された) CI ビルドにのみ適用されます。

Quality Gate はプロジェクトレベルおよびストリームレベルで構成することができ、Validate、コマンドライン (kwadmin/validate admin)、または Web API を使用して設定することができます。

CI Quality Gate の仕組み

Quality Gate は、[指摘] ページで使用されるのと同じ検索構文 (分類基準フィルター、ステータスフィルター、参照フィルターなど) を使用して定義されます。入力された Quality Gate 値に、制限された用語またはサポートされていない文字が含まれている場合は、ユーザーの参考となる提案メッセージがフィールドの下に表示されます。

Validate は、受け取った各 CI ビルドを以下のように評価します。

  • PASSED (合格):クエリに一致する問題はありません。

  • FAILED (失格):クエリに一致する問題が 1 つ以上あります。

  • NOT SET (未設定):Quality Gate が設定されていないため、ステータスバッジは表示されません。