Управление наборами правил кода для репозиториев в вашей организации

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

• Добавление правил для более эффективной защиты ветвей или тегов в этих репозиториях
• Переключите набор правил с режима "Оценка" на "Активный" после тестирования его влияния на опыт участника

Сведения об делегированной обходе

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

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

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

Чтобы настроить делегированный обход, владелец организации или администраторы репозитория сначала создадут список обхода. Список обходов включает определенные роли и команды, такие как администраторы команды или репозитория, которые контролируют запросы на обход принудительной защиты. Дополнительные сведения см. в разделе [AUTOTITLE и Управление наборами правил для репозиториев в организации](/repositories/configuring-branches-and-merges-in-your-repository/managing-rulesets/about-rulesets).

Изменение набора правил

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

1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.

2. В левой боковой панели в разделе "Политики" щелкните "Код", а затем щелкните "Наборы правил".

3. На странице "Наборы правил" щелкните имя набора правил, который требуется изменить.

4. Измените набор правил по мере необходимости.

   Сведения о доступных правилах см. в разделе Доступные правила для наборов правил

5. В нижней части страницы нажмите кнопку Сохранить изменения.

Удаление набора правил

1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
2. В левой боковой панели в разделе "Политики" щелкните "Код", а затем щелкните "Наборы правил".
3. Справа от имени набора правил выберите , а затем выберите Удалить набор правил.

Использование журнала наборов правил

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

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

1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
2. В левой боковой панели в разделе "Политики" щелкните "Код", а затем щелкните "Наборы правил".
3. Чтобы просмотреть журнал изменений в наборе правил, выберите справа от имени набора правил, а затем выберите History.
4. Справа от конкретной итерации выберите , а затем нажмите кнопку "Сравнить изменения, восстановить или скачать".

Импорт набора правил

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

1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
2. В левой боковой панели в разделе "Политики" щелкните "Код", а затем щелкните "Наборы правил".

3.        **Выберите раскрывающийся список "Создать правила", а затем нажмите кнопку **"Импорт набора**** правил".
   

4. Откройте экспортируемый JSON-файл.
5. Просмотрите импортированный набор правил и нажмите кнопку "Создать".

Просмотр аналитических сведений для наборов правил

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

• Действия, которые были проверены на наличие одного или нескольких наборов правил и переданы.
• Действия, которые были проверены на наличие одного или нескольких наборов правил и завершились ошибкой.
• Действия, в которых кто-то обошел один или несколько наборов правил.

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

Кроме того, эти инсайты доступны через REST API наборов правил.

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

1. Перейдите к своему предприятию. Например, на странице Enterprises на GitHub.com.
2. В левой боковой панели в разделе "Политики" щелкните "Код", а затем щелкните "Наборы правил".
3. На странице "Аналитика правил" используйте раскрывающееся меню в верхней части страницы, чтобы отфильтровать действия по набору правил, репозиторию, субъекту и периоду времени.
4. Чтобы узнать, какие определенные правила завершились ошибкой или требуется обход, щелкните , а затем разверните имя набора правил.

Управление запросами для обхода правил push-отправки

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

1. На GitHubперейдите на главную страницу репозитория.

2. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

   

3. Щелкните " Обходить запросы".

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

Состояние	Description
Cancelled	Запрос был отменен участником.
Completed	Запрос был утвержден, и фиксации были отправлены в репозиторий.
Denied	Запрос был рассмотрен и отклонен.
Expired	Срок действия запроса истек. Запросы действительны в течение 7 дней.
Open	Запрос еще не был проверен или утвержден, но фиксации не были отправлены в репозиторий.

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

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