使用組態檔設定 Git 存放庫原則

  • 發行項

Azure DevOps Services

分支原則可協助小組保護其重要的開發分支。 分支原則會針對小組強制執行程式碼品質和變更管理方面的標準。 如需您可以設定的原則設定概觀，請參閱 Git 存放庫設定和原則。

您可以使用各種 az repos policy 命令來設定存放庫的分支原則。 不過，原則命令接受單一範圍，也就是存放庫、分支和比對類型的單一組合。 如果您想要跨各種範圍套用相同的原則，您可以使用原則組態檔來執行此動作。

假設您想要在所有分支資料夾中建立手動佇列建置原則，該資料夾開頭為「發行」，也位於主要分支上。 若要達成此目的，請執行下列步驟：

建立原則組態檔

建立建置原則的原則組態檔，包括多個應用程式範圍。

{
  "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

請注意，路徑是使用 '\' 反斜線提供。