Управление наборами правил для репозитория

После создания набора правил вы по-прежнему можете внести в него изменения. Например, вы можете добавить правила для лучшей защиты ветвей или тегов, или переключить набор правил из режима «Оценить» на «Активный» после тестирования его влияния на опыт участника в вашем репозитории.

Для управления наборами правил можно использовать ИНТЕРФЕЙСы API REST и GraphQL. Дополнительные сведения см. в разделе [AUTOTITLE и Конечные точки REST API для правил](/graphql/reference/mutations#createrepositoryruleset).

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

На странице «Наборы правил» любой, кто имеет доступ к репозиторию, может просматривать активные наборы правил, направленные на определённую ветку, тег или ограничение

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

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

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

2. В представлении дерева файлов слева выберите раскрывающееся меню "git-branch" aria-hidden="true" aria-label="git-branch" %} в раскрывающемся меню "git-branch" %} и выберите команду Просмотреть все ветви. Вы также можете найти раскрывающееся меню ветви в верхней части интегрированного редактора файлов.

   

3. Слева от названия ветки нажмите .

   Совет

   Только ветки с набором правил имеют иконку рядом с названием.

4. При необходимости, чтобы отфильтровать результаты, щелкните вкладки или используйте строку поиска "Ветви поиска".

5. Щелкните имя набора правил, который вы хотите просмотреть.

Кроме того, можно просмотреть активные русели:

• /rules Добавив slug в URL-адрес репозитория. Например, чтобы просмотреть правила репозитория документации открытый код по адресу GitHub, перейдите в https://github.com/github/docs/rules.

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

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

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

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

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

   

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

   

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

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

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

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

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

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

   

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

   

4. Щелкните имя набора правил, который вы хотите удалить.

5. Справа от имени набора правил выберите , а затем выберите Удалить набор правил.

   

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

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

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

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

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

   

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

   

4. Чтобы просмотреть журнал изменений в наборе правил, выберите справа от имени набора правил, а затем выберите History.

   

5. Справа от конкретной итерации выберите , а затем нажмите кнопку "Сравнить изменения, восстановить или скачать".

   

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

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

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

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

   

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

   

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

   

5. Откройте экспортируемый JSON-файл.

6. Просмотрите импортированный набор правил и нажмите кнопку "Создать".

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

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

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

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

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

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

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

   

3. В левой боковой панели в разделе "Код и автоматизация" щелкните "Правила **", а затем нажмите **кнопку "Аналитика".

   

4. На странице "Аналитика правил" используйте раскрывающееся меню в верхней части страницы, чтобы отфильтровать действия по набору правил, ветви, субъекту и периоду времени.

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

   

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

Dashboard Rules Insights

Панель анализа правил предоставляет вам визуальное общее резюме деятельности по оценке правил для вашего репозитория, включая:

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

•         **Лучшие обходящие**: список самых активных обходных для ваших правил.
  

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

Чтобы просмотреть панель управления:

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

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

   

3. В левой боковой панели в разделе "Код и автоматизация" щелкните "Правила **", а затем нажмите **кнопку "Аналитика".

4. В верхней части страницы «Инсайты правил» просмотрите диаграммы панели для обзора активности по оценке правил.

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

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

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

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

   

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

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

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

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

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