Festlegen von Git-Repositoryeinstellungen und -richtlinien

Um Repositoryeinstellungen und -richtlinien über das Webportal zu konfigurieren, öffnen Sie in Ihrem Webbrowser Projekteinstellungen>Repositorys.

1. Um Einstellungen oder Richtlinien für alle Git-Repositorys anzuzeigen oder zu ändern, öffnen Sie die Seite "Alle Repositorys ", und wählen Sie die Registerkarte "Einstellungen oder Richtlinien " aus.

   

   Um Einstellungen und Richtlinien für ein bestimmtes Repository zu konfigurieren, wählen Sie die Registerkarte "Repositorys " aus, wählen Sie das Repository und dann die Registerkarte "Einstellungen " oder "Richtlinien " aus.

   

2. Auf der Registerkarte "Einstellungen " können Sie die Einstellungen für alle Git-Repositorys oder für ein einzelnes Repository definieren.

   

3. Auf der Registerkarte "Richtlinien " können Sie die Richtlinien für alle Git-Repositorys oder für ein einzelnes Repository definieren.

   

Sie können die Azure DevOps CLI verwenden, um Repositorys auflisten oder ein Repository anzeigen oder aktualisieren zu können. Außerdem können Sie Richtliniendetails für eine Verzweigung oder ein Repository auflisten, anzeigen oder aktualisieren.

Auflisten von Repositorys | Auflisten von Repositorydetails | Aktualisieren oder Umbenennen eines Repositorys
Auflisten von Repositoryrichtlinien | Auflisten von Richtliniendetails | Aktualisieren einer Repositoryrichtlinie

Mit der Azure CLI können Sie Richtlinien für einen Branch oder ein Repository oder für alle Repositories in einem Projekt auflisten, anzeigen und aktualisieren.

Auflisten von Repositorys

Mithilfe von az repos list listen Sie alle Repositorys für ein Projekt auf.

az repos list [--detect {false, true}]
              [--org]
              [--project]
              [--subscription]

Parameter

Beispiel

Der folgende Befehl gibt alle Git-Repositorys für die Standardkonfiguration zurück: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos list --output table
ID                                    Name            Default branch    Project
------------------------------------  --------------  ----------------  --------------
50a9df8e-5024-49d7-bf63-d3989139627e  Fabrikam Fiber  main              Fabrikam Fiber
ac228555-ea89-4881-9ace-dfa065baf7d3  Test 1-2-3      main              Fabrikam Fiber
0d58f562-4a10-495d-94d7-7ac61a22d7cc  Testing 1 2 3   main              Fabrikam Fiber
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO     main              Fabrikam Fiber

Auflisten von Details zum Repository

Mithilfe von az repos show listen Sie Informationen zu einem Repository auf oder öffnen es in einem Webbrowser.

az repos show --repository
              [--detect {false, true}]
              [--open]
              [--org]
              [--project]
              [--subscription]

Parameter

Beispiel

Der folgende Befehl listet die Details contosoREPO für die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"auf.

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Um weitere Details zu erhalten, geben Sie den folgenden Befehl ein:

az repos show --repository contosoREPO
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoREPO",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikamprime/Fabrikam%20Fiber/contosoREPO",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO"
}

Aktualisieren eines Repositorys

Sie können az repos update verwenden, um den Standardbranch zu aktualisieren oder ein Repository umzubenennen.

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

Parameter

Beispiel

Der folgende Befehl benennt contosoREPO in contosoFabrikam für die Standardkonfiguration az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" um.

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

Um weitere Details zu erhalten, geben Sie den folgenden Befehl ein:

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

Auflisten von Richtlinien

Mithilfe von az repos policy list können Sie alle Richtlinien für alle Projektrepositorys und -branches auflisten. Mithilfe der Parameter repository-id und branch können Sie Richtlinien für bestimmte Repositorys und Branches auflisten.

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--repository-id]
                     [--subscription]

Parameter

Beispiel

Der folgende Befehl gibt alle im Standardprojekt wirksamen Richtlinien zurück. In diesem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy list --output table

ID    Name                         Is Blocking    Is Enabled    Repository ID                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------------
1     Git repository settings      True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All branches
3     Work item linking            True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
5     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
6     Comment requirements         False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
7     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
8     Work item linking            False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
9     Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
10    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
11    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
12    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
13    Required reviewers           False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

Richtliniendetails anzeigen

Verwenden Sie zum Anzeigen der Details einer Richtlinie az repos policy show. Sie können die Richtlinien-ID abrufen, indem Sie az repos policy list ausführen.

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--subscription]

Parameter

Beispiel

Das folgende Beispiel zeigt den Namen und die Details für die Richtlinien-ID 1 im Standardprojekt an. In diesem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy show --id 1 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
1     Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Richtlinien aktualisieren

Sie können das Azure CLI az repos policy update mit einer Richtlinienkonfigurationsdatei verwenden, um Richtlinien zu aktualisieren. Eine Richtlinienkonfigurationsdatei kann eine Richtlinie auf mehr als einen Bereich gleichzeitig anwenden. Weitere Informationen finden Sie unter Konfigurieren von Git-Repositoryrichtlinien unter Verwendung einer Konfigurationsdatei. Beispiele für Richtlinienkonfigurationsdateien finden Sie unter Konfigurationen – Erstellen.

az repos policy update --config
                       --id
                       [--detect {false, true}]
                       [--org]
                       [--project]
                       [--subscription]

Parameter

Beispiel

Die folgende Datei policy.json legt die Richtlinie für die Mindestanzahl an Reviewern so fest, dass drei Genehmigungen in allen main-Branches für alle Repositorys im Standardprojekt erforderlich sind.

{
  "isEnabled": true,
  "isBlocking": false,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4906e5d171dd"
  },
  "settings": {
    "minimumApproverCount": 3,
    "creatorVoteCounts": false,
    "scope": [
      {
        "repositoryId": null,
        "refName": "refs/heads/main",
        "matchKind": "exact"
      }
    ]
  }
}

Die Befehlszeile az repos policy update aktualisiert die Richtlinie für die Mindestanzahl an Reviewern gemäß der Datei policy.json. Sie können die Richtlinien-ID mithilfe von az repos policy list ermitteln. In dem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy update --config C:\policies\policy.json --id 7 --output table

ID    Name                         Is Blocking    Is Enabled    Branch
----  ---------------------------  -------------  ------------  -----------------
7     Minimum number of reviewers  False          True          refs/heads/main

Azure DevOps CLI-Befehle werden für Azure DevOps Server nicht unterstützt.

So legen Sie eine Durchsetzungsrichtlinie für Fälle fest:

1. Wählen Sie Projekteinstellungen>Repositorys und dann ein Repository aus, wenn Sie nur dieses Repository konfigurieren möchten.

2. Legen Sie auf der Seite "Alle Repositorys " oder <"Repositoryname> " auf der Registerkarte " Richtlinien " unter "Repositoryrichtlinien" die Fallerzwingung auf "Ein" oder "Aus" fest.

   

Sie können das Azure CLI az repos policy case-enforcement create und az repos policy case-enforcement update verwenden, um die Richtlinie zur Durchsetzung der Groß- und Kleinschreibung zu konfigurieren oder zu aktualisieren.

Erstellen der Richtlinie „Groß-/Kleinschreibung erzwingen“

Verwenden Sie az repos case-enforcement create, um eine Richtlinie zur Durchsetzung von Fällen zu erstellen.

az repos policy case-enforcement create --blocking {false, true}
                                        --enabled {false, true}
                                        --repository-id
                                        [--detect {false, true}]
                                        [--org]
                                        [--project]

Parameter

Beispiel

Im folgenden Beispiel wird eine erforderliche Richtlinie „Groß-/Kleinschreibung erzwingen“ im Fabrikam-Repository implementiert. Sie können die Repository-ID mithilfe von az repos list abrufen. In diesem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy case-enforcement create --blocking true --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Aktualisieren der Richtlinie „Groß-/Kleinschreibung erzwingen“

Verwenden Sie az repos policy case-enforcement update, um die Richtlinie Groß-/Kleinschreibung erzwingen zu verwalten.

az repos policy case-enforcement update --id
                                        [--blocking {false, true}]
                                        [--detect {false, true}]
                                        [--enabled {false, true}]
                                        [--org]
                                        [--project]
                                        [--repository-id]

Parameter

Beispiel

Im folgenden Beispiel wird die Richtlinie „Groß-/Kleinschreibung erzwingen“ im Fabrikam-Repository so aktualisiert, dass sie nicht mehr aktiviert ist und also auch nicht mehr blockiert. In diesem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy case-enforcement update --blocking false --enabled false --policy-id 40 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  False          False         d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI-Befehle werden für Azure DevOps Server nicht unterstützt.

Verwenden Sie az repos policy file-size create und az repos policy file-size update, um die Richtlinie „Maximale Dateigröße“ zu verwalten.

Erstellen einer Richtlinie für die Dateigröße

az repos policy file-size create --blocking {false, true}
                                 --enabled {false, true}
                                 --maximum-git-blob-size
                                 --repository-id
                                 --use-uncompressed-size {false, true}
                                 [--detect {false, true}]
                                 [--org]
                                 [--project]
                                 [--subscription]

Parameter

Beispiel

Im folgenden Beispiel wird eine Dateigrößenrichtlinie mit maximal 1 GB Blockierung im Repository erstellt.The following example creates a file size policy with a 1-GB blocking maximum in the Fabrikam repository. Sie können die Repository-ID mithilfe von az repos list abrufen. In diesem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy file-size create --blocking true --enabled true --maximum-git-blob-size 10485760 --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --use-uncompressed-size true --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Aktualisieren einer Richtlinie für die Dateigröße

Verwenden Sie az repos policy file-size update, um die Richtlinie „Maximale Dateigröße“ zu verwalten.

az repos policy file-size update --id
                                 [--blocking {false, true}]
                                 [--detect {false, true}]
                                 [--enabled {false, true}]
                                 [--maximum-git-blob-size]
                                 [--org]
                                 [--project]
                                 [--repository-id]
                                 [--subscription]
                                 [--use-uncompressed-size {false, true}]

Parameter

Beispiel

Im folgenden Beispiel wird die maximale Dateigröße im Fabrikam-Repository aktualisiert. In dem Beispiel wird die Standardkonfiguration verwendet: az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber".

az repos policy file-size update --id 45 --maximum-git-blob-size 20971520 --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI-Befehle werden für Azure DevOps Server nicht unterstützt.