Konfigurieren von Git-Repositoryrichtlinien mithilfe einer Konfigurationsdatei

  • Artikel

Azure DevOps Services

Branchrichtlinien helfen Teams dabei, ihre wichtigen Branches der Entwicklung zu schützen. Richtlinien erzwingen die Codequalitäts- und Change Management-Standards Ihres Teams. Eine Übersicht über Richtlinieneinstellungen, die Sie konfigurieren können, finden Sie unter Einstellungen und Richtlinien für Git-Repositorys.

Sie können Branchrichtlinien für Ihr Repository mithilfe der verschiedenen az repos policy Befehle konfigurieren. Die Richtlinienbefehle akzeptieren jedoch einen einzelnen Bereich, d. h. eine einzelne Kombination aus Repository, Branch und Übereinstimmungstyp. Wenn Sie dieselbe Richtlinie auf verschiedene Bereiche anwenden möchten, können Sie dies mithilfe einer Richtlinienkonfigurationsdatei tun.

Angenommen, Sie möchten eine manuelle Warteschlangenbuildrichtlinie für alle Branchordner erstellen, die mit "release" beginnen, und auch für den Standard Branch. Führen Sie dazu die folgenden Schritte aus:

Erstellen einer Richtlinienkonfigurationsdatei

Erstellen Sie eine Richtlinienkonfigurationsdatei für die Buildrichtlinie, einschließlich der verschiedenen Anwendungsbereiche.

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

Weitere Informationen zur Struktur für verschiedene Richtlinientypen finden Sie unter Erstellen von Richtlinien.

Speichern Sie die Datei, und führen Sie den Befehl Richtlinie erstellen aus.

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

Beachten Sie, dass der Pfad mit umgekehrtem Schrägstrich "\" angegeben wird.