Настройка параметров и политик репозитория Git

Чтобы настроить параметры репозитория и политики на веб-портале, откройте репозитории параметров>проекта из веб-браузера.

1. Чтобы просмотреть или изменить параметры или политики для всех репозиториев Git, откройте страницу "Все репозитории " и выберите "Параметры " или "Политики".

   

   Чтобы настроить параметры и политики для определенного репозитория, перейдите на вкладку "Репозитории ", выберите репозиторий и перейдите на вкладку "Параметры " или "Политики ".

   

2. На следующем снимках экрана показана вкладка "Параметры ". Эти параметры можно определить для всех репозиториев Git или для отдельного репозитория.

   

3. На следующем снимка экрана показана вкладка "Политики". Эти политики можно определить для всех репозиториев Git или для отдельного репозитория.

   

1. В веб-браузере откройте проект и выберите параметры проекта, репозитории и выберите свой репозиторий.

   

2. Чтобы просмотреть и настроить параметры репозитория, выберите "Параметры " или "Политики".

   На следующем снимку экрана показаны параметры для всех репозиториев:

   

   На следующем снимку экрана показаны параметры репозиториев Fabrikam:

   

Azure DevOps CLI можно использовать для перечисления репозиториев или отображения или обновления репозитория. Кроме того, можно отобразить или обновить сведения о политике для ветви или репозитория.

Обновление или переименование репозитория | списка репозиториев |
Список политик репозитория списков сведений о | | политике обновления репозитория

Azure CLI можно использовать для перечисления, отображения и обновления политик для ветви или репозитория или для всех репозиториев в проекте.

Вывод списка репозиториев

Используйте az repos list для перечисления всех репозиториев для проекта.

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

Параметры

Пример

Следующая команда возвращает все репозитории Git для конфигурации 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

Список сведений о репозитории

Используйте az repos show , чтобы перечислить сведения о репозитории или открыть его в веб-браузере.

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

Параметры

Пример

Следующая команда содержит сведения о contosoREPO для конфигурации az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

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

Дополнительные сведения см. в следующей команде:

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

Обновление репозитория

Можно использовать az repos update для обновления ветвь по умолчанию или переименования репозитория.

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

Параметры

Пример

Следующая команда переименовывает contosoREPO в contosoFabrikam для конфигурации az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"по умолчанию.

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

Дополнительные сведения см. в следующей команде:

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

Список политик

Используйте список политик az repos для перечисления всех политик для всех репозиториев и ветвей проекта. repository-id branch Используйте параметры для перечисления политик для определенных репозиториев и ветвей.

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

Параметры

Пример

Следующая команда возвращает все политики, действующие в проекте по умолчанию. В этом примере используется конфигурация 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

Отображение сведений о политике

Чтобы отобразить сведения о любой политике, используйте az repos policy show. Идентификатор политики можно получить, выполнив команду az repos policy list.

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

Параметры

Пример

В следующем примере показаны имя и сведения для идентификатора 1 политики в проекте по умолчанию. В этом примере используется конфигурация по умолчанию 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

Политики обновления

Для обновления политик можно использовать Azure CLI az repos policy update с файлом конфигурации политики. Файл конфигурации политики может применять политику в нескольких областях одновременно. Дополнительные сведения см. в разделе "Настройка политик репозитория Git с помощью файла конфигурации". Примеры файлов конфигурации политики см. в разделе "Конфигурации — создание".

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

Параметры

Пример

Следующий policy.json файл задает политику минимальных рецензентов, чтобы требовать трех утверждений во всех ветвях во всех main репозиториях проекта по умолчанию.

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

В az repos policy update командной строке обновляется политика минимальных рецензентов для файла policy.json . Идентификатор политики можно найти с помощью списка политик az repos. В примере используется конфигурация по умолчанию 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 не поддерживаются для Azure DevOps Server.

Чтобы задать политику принудительного применения регистра, выполните следующие действия.

1. Выберите репозитории> параметров проекта и выберите репозиторий, если вы хотите настроить только этот репозиторий.
2. На вкладке "Политики" на странице "Все репозитории" или <"Имя> репозитория" в разделе "Политики репозитория" установите значение "Вкл." или "Выкл.

Вы можете использовать Azure CLI az repos policy case-enforcement create и az repos policy case-enforcement update для настройки или обновления политики применения случаев.

Создание политики принудительного применения случаев

Используйте az repos case-enforcement create для создания политики принудительного применения случаев.

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

Параметры

Пример

В следующем примере реализована необходимая политика принудительного применения случаев в репозитории Fabrikam . Идентификатор репозитория можно получить с помощью az repos list. В этом примере используется конфигурация 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

Обновление политики применения регистра

Используйте az repos policy case-enforcement update для управления политикой применения случаев .

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

Параметры

Пример

В следующем примере политика принудительного применения случаев в Fabrikam репозитории обновляется, чтобы они больше не были включены или блокируются. В этом примере используется конфигурация 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 не поддерживаются для Azure DevOps Server.

Используйте az repos policy file-size create и az repos policy file-size update для управления максимальной политикой размера файла.

Создание политики размера файла

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]

Параметры

Пример

В следующем примере создается политика максимального размера файла в Fabrikam репозитории размером 1 ГБ. Идентификатор репозитория можно получить с помощью az repos list. В этом примере используется конфигурация 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

Обновление политики размера файла

Используйте az repos policy policy size update для управления политикой максимального размера файла.

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}]

Параметры

Пример

В следующем примере обновляется максимальный размер файла в репозитории Fabrikam . В примере используется конфигурация 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 не поддерживаются для Azure DevOps Server.