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

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Существует несколько способов настроить репозитории Azure Repos Git с помощью параметров и политик репозиториев и веток. В этой статье рассматриваются параметры и политики уровня репозитория.

• Параметры и политики репозитория настраивают глобальные параметры для всех репозиториев Git для проекта или организации или для отдельных репозиториев.

  В этой статье рассматриваются параметры и политики репозитория на стороне сервера. Дополнительные сведения о настройках Git на клиентской стороне см. в разделе "Настройки Git в Visual Studio".

• Политики ветви охватывают элементы управления, относящиеся к ветви.

  Политики ветвей включают такие варианты, как запрос на вытягивание, успешная сборка или проверка кода, прежде чем изменения могут объединиться в ветвь. Дополнительные сведения см. в разделе "Политики и параметры ветви".

• Разрешения на безопасность репозитория и ветви управляют назначениями пользователей.

  Эти разрешения определяют, кто может читать, записывать, вносить вклад в запросы на вытягивание и выполнять другие конкретные действия. Дополнительные сведения см. в разделе "Настройка разрешений для репозитория".

Сводка по всем параметрам репозитория и ветви и политикам

Параметры и политики можно настроить для всех репозиториев в проекте, для отдельных репозиториев и для ветвей репозиториев. В браузере вы настраиваете все эти параметры и политики через параметры проекта>репозитории.

Примечание.

Вы можете задать несколько настроек и политик ветвей с помощью Azure CLI, используя az repos policy.

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

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

В следующей таблице перечислены параметры, которые можно включить и настроить для всех новых репозиториев Git в проекте или организации.

Параметр

По умолчанию

Description

---

Имя ветви по умолчанию для новых репозиториев

Выключено

Инициализируйте новые репозитории с именем ветви по умолчанию, которое вы укажете. Вы можете изменить ветвь по умолчанию для определенного репозитория в любое время. Если эта функция не включена, репозитории инициализируются с помощью ветвь по умолчанию с именемmain.

Разрешить пользователям управлять разрешениями для созданных ветвей

Включено

Разрешить пользователям управлять разрешениями для созданных ветвей во всех новых репозиториях.

Параметры репозитория

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

Параметр

По умолчанию

Description

---

Вилки

Включено

Разрешить пользователям создавать форки из репозитория.

Связывание упоминаний в коммите

Включено

Автоматически создавайте ссылки для рабочих элементов, упомянутых в комментарии коммита.

Разрешение рабочих элементов фиксации

Включено

Разрешить закрытие рабочих элементов с помощью упоминаний в комментариях к коммитам. Требуется обновление или более поздняя версия Azure DevOps Server 2020.1.

Параметры перехода рабочих элементов

Включено

Запомните пользовательские настройки для завершения рабочих элементов с pull request.

Управление разрешениями

Включено

Разрешить пользователям управлять разрешениями для созданных ветвей

Строгий режим голосования

Включено

Включите Строгий режим голосования для репозитория, для которого требуется разрешение на участие, чтобы голосовать по запросам на вытягивание.

Отключение репозитория

Включено

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

Ветви, доступные для поиска

Включено

Укажите до пяти дополнительных веток для участия в поиске кода, который по умолчанию используется только для ветки по умолчанию. Требуется установить и включить расширение поиска кода.

Политики или параметры репозитория

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

Политика или параметр

По умолчанию

Description

---

Фиксация проверки электронной почты автора

Выключено

Блокировать отправку, если электронная почта автора коммита не соответствует указанным шаблонам. Для этого параметра требуется Azure DevOps Server 2020.1 или более поздней версии.

Проверка пути к файлу

Выключено

Запретить добавление путей к файлам, которые соответствуют указанным шаблонам. Для этого параметра требуется Azure DevOps Server 2020.1 или более поздней версии.

Принудительное исполнение

Выключено

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

Зарезервированные имена

Выключено

Блокировка отправок, которые вводят файлы, папки или имена веток, содержащие зарезервированные платформой имена или несовместимые символы.

Максимальная длина пути

Выключено

Блокирует изменения, которые добавляют пути, превышающие указанную длину.

Максимальный размер файла

Выключено

Блокирует отправки, содержащие новые или обновленные файлы, превышающие выбранное ограничение.

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

В следующей таблице перечислены политики, которые можно определить для настройки ветви. Дополнительные сведения о настройке этих параметров см. в статье "Улучшение качества кода с помощью политик ветви". При установке любой политики в ветви следующие политики автоматически применяются:

• Пулл-реквесты требуются для обновления ветви.
• Не удается удалить ветвь.

Примечание.

Политики ветви применяются к запросам на вытягивание на основе целевой ветви запроса на вытягивание. Правила для ветвей не должны быть установлены на временных ветвях, которые будут удалены после пул-реквеста. Добавление политик ветви во временные ветви приведет к сбою автоматического удаления ветви.

Политика

По умолчанию

Description

---

Требовать минимальное количество рецензентов

Выключено

Требовать, чтобы пулл-реквест одобрили указанное количество рецензентов.

Проверка связанных рабочих элементов

Выключено

Стимулируйте прослеживаемость, проверяя наличие ссылок на рабочие элементы в pull-запросах.

Проверка выполнения решений по комментариям

Выключено

Убедитесь, что разрешены все комментарии в pull-запросах.

Ограничение типов слияний или применение стратегии слияния

Выключено

Управляйте историей ветви, ограничивая доступные типы объединения при завершении pull-запросов.

Проверка сборки

Выключено

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

Проверка статуса или
Требовать утверждения от дополнительных или внешних служб

Выключено

Добавьте, включите или отключите одну или несколько политик, чтобы требовать от других служб публикации успешного статуса для завершения pull-запросов.

Автоматически включенные рецензенты

Выключено

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

Предварительные условия

Категория	Требования
доступ к проекту	Член проекта .
Разрешения	— Просмотр кода в частных проектах: по крайней мере базовый доступ. — Клонирование или внесение вклада в код в частных проектах: Участник группы безопасности для участников или наличие соответствующих разрешений в проекте. — Задайте разрешения ветви или репозитория: управление разрешениями для ветви или репозитория. — Измените ветвь по умолчанию: . Измените политики и разрешения для репозитория. — Импорт репозитория: член группы безопасности администраторов проекта или разрешение уровня проекта Git на создание репозитория установлено в «Разрешить» . Дополнительные сведения см. в разделе "Настройка разрешений репозитория Git".
Сервисы;	Repos включено.
Инструменты	Необязательно. Используйте команды az repos: Azure DevOps CLI.

Примечание.

В общедоступных проектах пользователи с доступом Stakeholder имеют полный доступ к Azure Repos, включая возможность просмотра, клонирования и участия в коде.

Просмотр и изменение параметров и политик

Параметры, такие как настройки, можно настроить для всех репозиториев в организации или проекте, а также для отдельных репозиториев. Политики можно настроить для всех репозиториев, отдельных репозиториев или для указанных ветвей в репозиториях. Сведения о настройке политик ветви см. в разделе "Политики ветви".

Примечание.

Рекомендуется настроить параметры репозитория на уровне проекта или для отдельных репозиториев, но не для обоих. При настройке параметров на нескольких уровнях система учитывает самый строгий параметр. Настройка параметров на одном уровне снижает путаницу и проблемы с производительностью Git.

Браузер

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

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

   

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

   

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

   

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

   

CLI Azure DevOps

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

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

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

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

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

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

Параметры

Параметр	Описание
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

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

Параметры

Параметр	Описание
repository	Имя или идентификатор репозитория.
detect	Автоматическое распознавание организации. Допустимые значения: false, true.
open	Откройте страницу репозитория в веб-браузере.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено по умолчанию или не выбрано с помощью git config.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

Следующая команда содержит сведения о 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]

Параметры

Параметр	Описание
repository	Имя или идентификатор репозитория.
default-branch	Укажите ветвь по умолчанию для репозитория. Пример: "refs/heads/live" или "live".
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
name	Новое имя репозитория.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

Следующая команда переименовывает 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]

Параметры

Параметр	Описание
branch	Имя ветви для фильтрации результатов по точному совпадению. Параметр --repository-id требуется для использования фильтра ветви. Например: --branch main.
detect	Автоматическое распознавание организации. Допустимые значения: false, true.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано через git config.
query-examples	Рекомендуемая строка JMESPath. Вы можете скопировать один из запросов и вставить его после --query параметра в двойных кавычках, чтобы просмотреть результаты. Вы можете добавить одно или несколько позиционных ключевых слов, чтобы предложения основывались на этих ключевых словах.
repository-id	Идентификатор репозитория для фильтрации результатов по точному совпадению. Например, --repository-id e556f204-53c9-4153-9cd9-ef41a11e3345.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

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

Параметры

Параметр	Описание
id, policy-id	Идентификатор политики. Необходимые.
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
query-examples	Рекомендуемая строка JMESPath. Вы можете скопировать один из запросов и вставить его после --query параметра в двойных кавычках, чтобы просмотреть результаты. Вы можете добавить одно или несколько позиционных ключевых слов, чтобы предложения основывались на этих ключевых словах.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

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

Параметры

Параметр	Описание
--config, --policy-configuration	Локальный путь к файлу конфигурации политики. Используйте обратную косую черту \ при вводе пути к каталогу. Обязательно.
id, policy-id	Идентификатор политики для обновления. Требуется.
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
org, organization	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

Следующий 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

Имя ветви по умолчанию

Можно задать имя ветви репозитория по умолчанию на уровне организации или проекта. Параметр уровня организации вступает в силу для всех новых репозиториев во всех проектах организации. Параметр уровня проекта влияет на все новые репозитории в проекте и заменяет любой набор имен на уровне организации.

Вы можете:

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

Если вы не включите функцию имени ветвь по умолчанию, репозитории инициализируются с именем mainAzure Repos ветвь по умолчанию.

Чтобы задать имя ветки по умолчанию на уровне организации:

1. На странице организации Azure DevOps выберите параметры организации слева и выберите репозитории в области навигации слева.
2. На странице "Все репозитории" задайте для имени ветви по умолчанию для новых репозиториев значение включено, а затем введите имя ветви по умолчанию.

Чтобы задать имя ветви по умолчанию на уровне проекта:

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

Управление правами доступа к ветвям

Вы можете управлять разрешениями для ветвей репозитория, установив параметр управления разрешениями для всех репозиториев Git или отдельных репозиториев. Если разрешить пользователям управлять разрешениями для созданных ветвей на уровне "Все репозитории ", все новые репозитории проектов настроены, чтобы пользователи могли управлять разрешениями для созданных ветвей.

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

1. На странице проекта Azure DevOps выберите параметры проекта слева и выберите репозитории в области навигации слева.
2. На вкладке "Параметры" на странице "Все репозитории" задайте пользователям возможность управлять разрешениями для созданных ветвей значение "Вкл." или "Выкл.".

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

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

Изображения Gravatar

Этот параметр включает или отключает использование образов Gravatar для пользователей за пределами предприятия.

Изображения Gravatar — это настройка на уровне организации.

1. На странице организации Azure DevOps выберите параметры организации слева и выберите репозитории в области навигации слева.
2. На странице "Все репозитории" установите параметр изображения Gravatar в положение On или Off.

Включение вилок

Этот параметр репозитория определяет, могут ли пользователи создавать новые серверные форки. Отключение этого параметра не удаляет существующие вилки.

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

Параметры связывания рабочих элементов

Эти параметры репозитория управляют связыванием рабочих элементов.

1. Выберите параметры проекта>Репозитории, и затем выберите репозиторий.
2. На вкладке Настройки страницы с именем <репозитория>, включите или выключите настройки включенных или выключенных.

Фиксация ссылок

При включенной опции, сообщения фиксации, содержащие # и допустимый идентификатор рабочего элемента, автоматически связывают фиксацию с этим рабочим элементом. Отключите этот параметр, если репозиторий ранее использовал другую учетную запись или службу. Эти репозитории могут содержать сообщения о фиксации с # упоминаниями, которые не совпадают с идентификаторами рабочих элементов в текущей учетной записи.

Упоминание разрешения рабочих элементов в коммите

Включите этот параметр для автоматического завершения рабочих элементов при закрытии связанных pull-реквестов. Этот параметр также позволяет указывать другие состояния перехода рабочих элементов в сообщениях фиксации запроса на вытягивание. Дополнительные сведения см. в разделе Автозавершение рабочих элементов с помощью запросов на вытягивание.

Параметры перехода рабочих элементов

По умолчанию опция завершения связанных рабочих элементов во время завершения пулл-реквеста запоминает последний выбор каждого пользователя. Команды, которые хотят запретить пользователям выполнять рабочие элементы с запросами на вытягивание, могут отключить этот параметр. Затем пользователи должны соглашаться на выполнение рабочих элементов каждый раз, когда они завершают pull request.

Параметр строгого режима голосования

В некоторых ситуациях пользователи, не являющиеся участниками репозитория, могут отправлять pull-запрос, который может быть объединён, в зависимости от установленных политик. Чтобы предотвратить эту возможность, включите режим строгого голосования, чтобы изменить требуемое разрешение на голосование по запросам на вытягивание репозитория для участия. Включение этого параметра рекомендуется, если вы используете форки в Azure Repos.

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

Отключение параметра репозитория

Включение этого параметра отключает доступ к репозиторию, включая сборки и pull requests, но репозиторий остаётся доступным для обнаружения с предупреждением.

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

Политики межрепозиторных веток

Политики можно задать для определенного имени ветви или на ветвь по умолчанию во всех репозиториях проекта. Например, для всех репозиториев проектов может потребоваться два минимальных рецензента для всех запросов на вытягивание в каждой main ветви.

Чтобы задать политики для защиты определенных имен ветвей или ветвей по умолчанию в проекте:

1. В разделе "Параметры проекта" выберите репозитории в области навигации слева.

2. На странице "Все репозитории" выберите вкладку "Политики".

3. В нижней части страницы выберите знак плюса + в Политики веток.

4. На экране "Добавить ветвь" выберите "Защитить ветвь по умолчанию каждого репозитория" или "Защитить текущие и будущие ветви", соответствующие указанному шаблону.

   Если выбрать второй параметр, введите имя ветви для защиты. Информационное сообщение позволяет узнать, сколько текущих ветвей затронуты. Помните, что введенное имя ветви (или введенный шаблон) воспринимается с учетом регистра. Чтобы защитить имя ветви, сама ветвь еще не должна существовать.

5. Нажмите кнопку создания.

   

6. На странице Кросс-репозиторные политики для <названия ветки> установите политики, которые вы хотите для защищенных ветвей. Дополнительные сведения о политиках ветви см. в разделе "Политики ветви".

   

Политика проверки электронной почты автора коммита

Эта политика блокирует коммиты в репозитории от авторов коммитов, адреса электронной почты которых не соответствуют шаблону.

1. Выберите Параметры проекта>репозитории и выберите репозиторий, если вы хотите настроить только этот репозиторий.

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

3. Если вы включите политику, укажите соответствующий адрес или адреса электронной почты.

   Можно указать точные адреса электронной почты или использовать подстановочные знаки. Используйте ; в качестве разделителя для нескольких шаблонов электронной почты. Шаблоны электронной почты, префиксированные с ! помощью, исключаются. Порядок важен.

Политика проверки пути к файлу

Вы можете задать политику, которая предотвращает коммиты в репозитории из файловых путей, соответствующих шаблону.

1. Выберите Параметры проекта>Репозитории и выберите репозиторий, если вы хотите настроить только этот репозиторий.

2. На вкладке > репозитория" установите для проверки пути к файлу значение "Вкл." или "Выкл.".

3. Если включить политику, укажите путь или пути, которые нужно заблокировать.

   Можно указать точные пути и подстановочные знаки. Точные пути начинаются с /. Можно также указать несколько путей с помощью ; разделителя. Пути с префиксом ! исключаются. Порядок важен.

Политика применения мер

Git учитывает регистр, то есть файл с именем Foo.txt отличается от файла с именем foo.txt. Однако Windows и macOS по умолчанию файловые системы нечувствительны к регистру, что означает, что Foo.txt и foo.txt имеют одно и то же имя. Это несоответствие может привести к проблемам, если кто-то в нечувствительной системе отправляет файлы, папки, ветви или теги, которые отличаются только по буквам. Дополнительные сведения см. в статье о кроссплатформенной совместимости Git.

Если большинство участников находятся в Windows или macOS, рекомендуется включить политику принудительного применения случаев . Переключение учета регистра изменяет работу сервера с режима, в котором File.txt и file.txt рассматриваются как разные файлы, на режим, совместимый с Windows и macOS, где File.txt и file.txt считаются одним и тем же файлом. Этот параметр распространяется на файлы, папки, ветви и теги.

Этот параметр запрещает участникам вводить различия только в регистре. Этот параметр позволяет избежать конфликтов конфиденциальности регистра, блокируя отправки, которые изменяют регистр имени в файлах, папках, ветвях и тегах. Чтобы устранить проблему, пользователь должен переписать свою незапушенную историю, а затем попробовать запушить заново.

Этот параметр не исправит репозиторий, который уже содержит объекты, которые отличаются только по регистру. Прежде чем включить политику, рекомендуется устранить такие проблемы. Переименуйте файлы и папки или повторно создайте ветви и теги , чтобы использовать не конфликтующие имена.

Браузер

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

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

CLI Azure DevOps

Вы можете использовать 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]

Параметры

Параметр	Описание
blocking	Блокировать, если правило не соблюдено. Допустимые значения: false, true. Обязательно.
enabled	Включите политику. Допустимые значения: false, true. Необходимые.
repository-id	Идентификатор репозитория, в котором применяется политика. Необходимые.
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
org	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

Пример

В следующем примере реализована необходимая политика принудительного применения случаев в репозитории 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]

Параметры

Параметр	Описание
id, policy-id	Идентификатор политики для обновления. Необходимые.
blocking	Блокировать, если политика не выполнена. Допустимые значения: false, true.
detect	Автоматическое определение организации. Допустимые значения: false, true.
enabled	Включите политику. Допустимые значения: false, true.
org	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
repository-id	Идентификатор репозитория, в котором применяется политика.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_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

Политика зарезервированных имен

Не все имена файлов разрешены в трех основных файловых системах ОС: Windows, macOS и Linux. Фиксации в общем репозитории могут содержать имена файлов или папок, недопустимые на одной или нескольких платформах. Если недопустимые файлы или папки загружаются и оформляются на этих платформах, рабочие каталоги могут быть повреждены. Дополнительные сведения см. в статье о кроссплатформенной совместимости Git.

Вы можете включить или отключить политики для размещения ограничений по именам файлов и папок. Настройка зарезервированных имен блокирует отправку в репозиторий, если имена файлов или папок недопустимы на всех платформах. Сведения о недопустимых именах см. в статье о кроссплатформенной совместимости Git.

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

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

Политика максимальной длины пути

Не все длины пути разрешены в трех основных файловых системах ОС: Windows, macOS и Linux. Фиксации в общем репозитории могут содержать файлы или каталоги с недопустимой длиной пути на одной или нескольких платформах. Если эти файлы или каталоги извлекаются и извлекаются на платформе, в которой они недопустимы, рабочие каталоги могут стать повреждены. Дополнительные сведения см. в статье о кроссплатформенной совместимости Git.

Параметр максимальной длины пути блокирует отправки, содержащие файлы или каталоги с недопустимой длиной пути на любой платформе. Чтобы узнать, какая длина пути недопустима, ознакомьтесь с кроссплатформенной совместимостью Git. Если вы включаете этот параметр, максимальное значение по умолчанию составляет 248, потому что такая максимальная длина поддерживается на 100 % на всех трех основных платформах.

Можно изменить максимальное значение пути. Например, если у вас есть только разработчики macOS или Linux в вашей организации, можно задать максимальную длину значения, поддерживаемого на обеих платформах 1016. Вы также можете задать более низкое максимальное значение пути для применения соглашений об именовании каталогов организации.

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

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

Политика максимального размера файла

Большие файлы, зарегистрированные в Git, остаются в репозитории неограниченное время, увеличивая время клонирования и использование дисков. Рекомендации по управлению большими файлами см. в статье "Управление большими файлами" и хранение больших файлов в Git.

Параметр политики максимального размера файла блокирует доступ к файлам с определенным размером при входе в репозиторий. Если push-запрос содержит новый или обновленный файл, превышающий ограничение, настроенное в этом параметре, push-запрос блокируется. Чтобы удалить большой файл, пользователь должен перезаписать журнал незавершенной отправки и повторить попытку отправки.

Браузер

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

1. Выберите Настройки проекта>Репозитории и выберите репозиторий, если вы хотите настроить только его.
2. На вкладке Политика на странице Все репозитории или <Имя репозитория> в разделе Политика репозитория задайте максимальный размер файла на Включить или Выключить.
3. Если вы включили параметр, выберите максимальный размер файла.

CLI Azure DevOps

Используйте 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]

Параметры

Параметр	Описание
blocking	Блокировать, если политика не выполнена. Допустимые значения: false, true. Обязательно.
enabled	Включите политику. Допустимые значения: false, true. Обязательно.
maximum-git-blob-size	Максимальный размер двоичного объекта Git в байтах. Например, чтобы указать 10-байтовый предел, --maximum-git-blob-size 10.обязательный.
repository-id	Идентификатор репозитория, в котором применяется политика. Обязательно.
use-uncompressed-size	Следует ли использовать несжатый размер. Допустимые значения: false, true. Обязательно.
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
org	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.

Пример

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

Параметры

Параметр	Описание
id, policy-id	Идентификатор политики для обновления. Необходимые.
blocking	Блокировать, если политика не соблюдена. Допустимые значения: false, true.
detect	Автоматически определять организацию. Допустимые значения: false, true.
enabled	Включите политику. Допустимые значения: false, true.
maximum-git-blob-size	Максимальный размер Git blob в байтах.
org	URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=<ORG_URL>. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.
project, p	Имя или идентификатор проекта. Вы можете настроить проект по умолчанию с помощью az devops configure -d project=<NAME_OR_ID>. Требуется, если не настроено по умолчанию или не выбрано с помощью конфигурации git.
repository-id	Идентификатор репозитория, в котором применяется политика.
subscription	Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s <NAME_OR_ID>.
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

Следующие шаги

Улучшение качества кода с помощью политик ветвей

Связанные статьи

• Настройка политик репозитория Git с помощью файла конфигурации
• Разрешения Git по умолчанию (безопасность)
• Установка разрешений (безопасность)
• Общие сведения об интеграции между службами