PR Gate ルールを設定する

This product is not supported for your selected Datadog site. ().

概要

Datadog PR Gates を使用する場合は、PR Gate Rules ページで 1 つ以上のルールを定義できます。

Datadog の PR Gates ページ

PR Gates は、品質基準を満たすコードのみがデプロイされることを保証し、品質保証プロセスを自動化して、ソフトウェアの信頼性を高めます。

ルールの作成

Datadog で PR Gates ルールを作成するには、次の手順を実行します。

  1. Software Delivery > PR Gates > PR Gate Rules に移動し、New Rule をクリックします。

  2. Select your source でルール タイプを選択します。

    • 静的コード解析
    • ソフトウェア構成分析
    • コードカバレッジ
    • Infrastructure as Code スキャン

  3. Define condition で、ルールが失敗し、関連するパイプラインも失敗する条件を設定します。各ルール タイプには独自の条件オプションがあり、ルール タイプを選択すると既存のデフォルト条件設定を使用できます。

  4. Define scope で、ルールの評価対象となるリポジトリを設定します。

    • All repositories: 各ルール タイプの対象として設定されたすべてのリポジトリを評価します。
    • Selected repositories: 指定したリポジトリのみを評価します。指定したリポジトリのみを評価する場合は IN を、指定したリポジトリ_以外の_ すべての設定済みリポジトリを評価する場合は NOT IN を使用します。

    次の例は、プルリクエストに深刻度 Critical 以上のコード脆弱性違反が 1 つでも含まれている場合に失敗する静的コード解析ルールを示しています。このルールは、静的コード解析の対象として設定されたすべてのリポジトリを評価します。

    すべてのリポジトリに対して実行され、PR に `Critical` 以上の静的コード解析のコード脆弱性違反が 1 つでも含まれる場合に失敗する静的解析ルール

  5. Preview checks で、プルリクエストに追加されるステータス チェックをプレビューするために、CI プロバイダーを選択します。チェックが失敗したときにパイプラインをブロックするように設定するには、ステータス チェックを required にするためのプロバイダーの手順に従ってください。

    ノン ブロッキング ルールは、新しいルールを導入し、ブロッキングに変更する前にその動作を確認したい場合に役立ちます。

  6. Create Rule をクリックします。

PR チェックの管理

PR Gates は、評価対象となったルール タイプごとに、GitHub または Azure DevOps のプルリクエストに PR チェックを自動作成します。このチェックには、失敗の理由や Datadog で一致したイベントなど、ルール評価に関する追加情報が含まれます。

注: プルリクエストの UI でチェックを再実行しても、対応する PR Gates ルールは再実行されません。

PR Gates が PR チェックを作成できるようにするには、ご利用の SCM プロバイダーに対応するインテグレーションをインストールする必要があります。インテグレーションがインストールされていない場合は、GitHub または Azure DevOps Source Code のインテグレーション ドキュメントに従ってセットアップしてください。

ルールの管理

PR Gates ルールを編集または削除するには、PR Gates Rules リスト上の該当するルールにカーソルを合わせ、Edit または Delete アイコンをクリックします。

PR Gates ルールの編集、複製、削除

権限

quality_gate_rules_write 権限を持つユーザーのみが PR Gate ルールを作成および編集できます。quality_gate_rules_read 権限を持つユーザーは PR Gate ルールを閲覧できます。

詳細は RBAC 権限ドキュメントを参照してください。

関連情報

お役に立つドキュメント、リンクや記事:

PR Gates について学ぶドキュメント more more