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


Выключено

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

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

Включено

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

Параметры отдельного репозитория

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

Параметр

По умолчанию

Описание


Включено

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

Включено

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

Включено

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

Включено

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

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

Включено

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

Режим "с соблюдением голоса"

Включено

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

Отключить репозиторий

Включено

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

Ветви с возможностью поиска

Включено

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

Политики репозитория

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

Политика

По умолчанию

Описание


Выключено

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

Выключено

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

Выключено

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

Выключено

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

Выключено

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

Выключено

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

Политики ветвей

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

Политика

По умолчанию

Описание


Выключено

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

Выключено

Рекомендуемая трассировка путем проверки связанных рабочих элементов в запросах на вытягивание

Выключено

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

Выключено

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

Выключено

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

Выключено

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

Выключено

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

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

  • чтобы задать политики ветви, необходимо быть членом группы безопасности Project администраторы или иметь разрешения уровня репозитория: изменение политик. Дополнительные сведения см. в разделе Установка разрешений для репозитория Git.
  • если вы впервые используете az repos команды, см. статью начало az repos.
  • чтобы задать политики ветви, необходимо быть членом группы безопасности Project администраторы или иметь разрешения уровня репозитория: изменение политик. Дополнительные сведения см. в разделе Установка разрешений для репозитория Git.

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

  1. в веб-браузере откройте проект для своей организации в Azure DevOps и выберите Project параметры, репозиториии выберите свой репозиторий.

    снимок экрана, на котором показано, как выбрать

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

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

  3. Выберите политики , чтобы просмотреть и настроить политики уровня проекта и перекрестного репозитория.

    Снимок экрана, показывающий выбранную вкладку

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

    снимок экрана:

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

    В параметрах для FabrikamFiber вкладки Параметры и политики выделены, а параметры выбраны.

  1. В веб-браузере откройте проект и выберите значок шестеренки, Управление версиямии выберите свой репозиторий.

    Снимок экрана, на котором показаны параметры управления версиями для вашего репозитория.

  2. Выберите Параметры , чтобы просмотреть и настроить параметры репозитория.

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

  1. В веб-браузере откройте проект и выберите значок шестеренки, Управление версиямии выберите свой репозиторий.

    Снимок экрана, на котором показаны параметры управления версиями для вашего репозитория.

  2. Выберите Параметры , чтобы просмотреть и настроить параметры репозитория.

    Снимок экрана, на котором показан пользовательский интерфейс параметров.

Параметры имени ветви по умолчанию

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

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

    снимок экрана, на котором показаны

  • параметры Project . на странице проекта выберите Project параметрырепозиторииПараметры, включите имя ветви по умолчанию для новых репозиториеви введите имя ветви по умолчанию.

    снимок экрана, показывающий, что выбраны

если вы не включите эту функцию, ваши репозитории будут инициализированы Azure Repos именем по умолчанию — main.

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

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

Снимок экрана, на котором выбраны

Вилки

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

в Project репозиторий Параметры > Параметрыможно включить или отключить >.

репозиторий, Параметры, вилки.

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

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

репозиторий, Параметры, конфигурация рабочего элемента.

Параметр

Описание


Связывание с упоминанием упоминания

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

Зафиксировать упоминаемое разрешение рабочего элемента

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

Зафиксировать упоминаемое разрешение рабочего элемента

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

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

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

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

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

Снимок экрана, на котором отображается выбранная вкладка

с помощью > политик репозитория Project Параметрыможно включить или отключить >.

Репозиторий, политик, проверка электронной почты автора фиксации.

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

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

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

Снимок экрана, на котором отображается выбранная вкладка

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

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

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

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

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

с помощью > политик репозитория Project Параметрыможно включить или отключить >.

Репозиторий, политик, параметр принудительного применения Регистра.

Примечание

Для политики применения Регистра требуется TFS 2018,2 или более поздней версии.

Зарезервированные имена и максимальная длина пути

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

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

Хранилище, политики, зарезервированные имена и параметры максимальной длины пути.

Параметр зарезервированные имена блокирует push-уведомления в репозиторий, который содержит имена файлов или папок, недопустимые для любой платформы. Просмотр недопустимых имен

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

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

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

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

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

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

с помощью > политик репозитория Project Параметрыможно включить или отключить > и задать максимальное значение.

Репозиторий, политик, параметр максимального размера файла.

Примечание

Для политики максимального размера файлов требуется TFS 2018,2 или более поздней версии.

Дальнейшие действия

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

вы можете настроить Azure DevOps репозитории Git с помощью параметров репозитория и политики. Глобальные параметры для всех репозиториев настраиваются параметрами репозитория. Существуют также элементы управления для конкретных пользователей и ветвей, которые покрываются разрешениями и политиками ветвей соответственно.

В этой статье рассматриваются параметры репозитория на стороне сервера. Вы также можете узнать о настройках Gitна стороне клиента.

Примечание

Для работы функции, описанной в этой статье, требуется TFS 2018 с обновлением 2 или более поздней версии.

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

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

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

Примечание

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

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

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

Параметр

По умолчанию

Описание