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

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

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

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

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

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

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

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

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

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

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

Примечание.

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

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

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

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

Параметр

По умолчанию

Description

---

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

Выключено

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

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

Включено

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

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

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

Параметр

По умолчанию

Description

---

Вилки

Включено

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

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

Включено

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

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

Включено

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

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

Включено

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

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

Включено

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

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

Включено

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

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

Включено

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

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

Включено

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

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

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

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

По умолчанию

Description

---

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

Выключено

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

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

Выключено

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

Принудительное применение случаев

Выключено

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

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

Выключено

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

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

Выключено

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

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

Выключено

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

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

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

• Запросы на вытягивание требуются для обновления ветви.
• Не удается удалить ветвь.

Примечание.

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

Политика

По умолчанию

Description

---

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

Выключено

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

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

Выключено

Поощрение прослеживаемости путем проверки связанных рабочих элементов в запросах на вытягивание.

Проверка разрешения комментариев

Выключено

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

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

Выключено

Журнал ветви управления путем ограничения доступных типов слияния при завершении запросов на вытягивание.

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

Выключено

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

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

Выключено

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

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

Выключено

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

Необходимые компоненты

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

• Если вы хотите использовать команды az repos , выполните действия, описанные в статье "Начало работы с Azure DevOps CLI".

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

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

Примечание.

Рекомендуется настроить параметры репозитория на уровне проекта или для отдельных репозиториев, но не для обоих. При настройке параметров на нескольких уровнях система учитывает самый строгий параметр. Настройка параметров на одном уровне снижает путаницу и проблемы с производительностью 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.
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.
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. На вкладке <"Параметры" страницы имени> репозитория включите или выключите параметры.

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

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

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

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

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

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

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

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

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

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

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

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>.

Пример

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

Параметры

Параметр	Описание
id, policy-id	Идентификатор политики для обновления. Необходимые.
blocking	Блокировать, если политика не выполнена. Допустимые значения: false, true.
detect	Автоматическое обнаружение организации. Допустимые значения: false, true.
enabled	Включите политику. Допустимые значения: false, true.
maximum-git-blob-size	Максимальный размер большого двоичного объекта Git в байтах.
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 по умолчанию (безопасность)
• Установка разрешений (безопасность)
• Общие сведения об интеграции между службами