構成ファイルを使用して Git リポジトリ ポリシーを構成する

Azure DevOps Services

ブランチ ポリシーは、チームが開発の重要なブランチを保護するのに役立ちます。 ポリシーによって、チームのコード品質と変更管理の基準が適用されます。 構成できるポリシー設定の概要については、「 Git リポジトリの設定とポリシー」を参照してください。

さまざまな az repos policy コマンドを使用して、リポジトリのブランチ ポリシーを構成できます。 ただし、ポリシー コマンドは、リポジトリ、ブランチ、一致の種類の単一の組み合わせという 1 つのスコープを受け入れます。 さまざまなスコープで同じポリシーを適用する場合は、ポリシー構成ファイルを使用して適用できます。

たとえば、"リリース" で始まり、メイン ブランチで始まるすべてのブランチ フォルダーに対して手動キュー ビルド ポリシーを作成するとします。 これを実現するには、次の手順を実行します。

ポリシー構成ファイルを作成する

複数のアプリケーション スコープを含む、ビルド ポリシーのポリシー構成ファイルを作成します。

{
  "isBlocking": true,
  "isDeleted": false,
  "isEnabled": true,
  "revision": 1,
  "settings": {
    "buildDefinitionId": 22,
    "displayName": "Manual Queue Policy",
    "manualQueueOnly": true,
    "queueOnSourceUpdateOnly": false,
    "scope": [
      {
        "matchKind": "Prefix",
        "refName": "refs/heads/release",
        "repositoryId": "e646f204-53c9-4153-9ab9-fd41a11e3564"
      },
      {
        "matchKind": "Exact",
        "refName": "refs/heads/main",
        "repositoryId": "e646f204-53c9-4153-9ab9-fd41a11e1234"
      }
    ],
    "validDuration": 0
  },
  "type": {
    "displayName": "Build",
    "id": "0609b952-1397-4640-95ec-e00a01b2f659"
  }
}

さまざまなポリシーの種類の構造の詳細については、「 ポリシーの作成」を参照してください。

ファイルを保存し、ポリシーの作成コマンドを実行します

az repos policy create --policy-configuration C:\policyConfiguration.txt

パスは '\' 円記号を使用して提供されることに注意してください。