Skip to main content

Преобразование защиты ветвей в наборы правил

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

Кто может использовать эту функцию?

People with admin access to a repository, or a custom role with the "edit repository rules" permission, can create, edit, and delete rulesets for a repository.

Наборы правил доступны в публичных репозиториях с GitHub Free и GitHub Free для организаций, а также в публичных и частных репозиториях с GitHub Pro, GitHub Team, и GitHub Enterprise Cloud. См . раздел AUTOTITLE.

Push-наборы правил доступны для GitHub Enterprise Cloud плана во внутренних и частных репозиториях, форках репозиториев, где включены push-правила, и в организациях вашего предприятия.

О преобразовании защиты ветвей в наборы правил

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

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

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

Преобразование правила защиты ветви в набор правил

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

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

    Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.

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

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

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

  6. Просмотрите раздел "Новое поведение", чтобы понять, что изменится при создании набора правил или наборов правил.

  7. В разделе "Состояние принудительного применения" выберите, как применяется новый набор правил. Дополнительные сведения см. в разделе "Выбор состояния принудительного применения".

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

  9. Нажмите кнопку "Создать набор правил". Если преобразование создает несколько наборов правил, кнопка включает количество наборов правил, например создать 2 набора правил.

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

Примечание.

Преобразование охватывает все типы защиты ветви, за исключением параметра "Требовать разрешение бесед перед слиянием". В защите ветви этот параметр существует самостоятельно. В наборах правил разрешение бесед является частью правила запроса на вытягивание и применяется только при включении этого правила. В результате этот параметр не сопоставляет один с одним во время преобразования. См . раздел AUTOTITLE.

Выбор состояния принудительного применения

При преобразовании правила защиты ветви вы выбираете состояние принудительного применения для нового набора правил.

  • Активный: набор правил применяется сразу после создания.
  • Оценка: набор правил выполняется без применения его правил, поэтому вы можете проверить, как он будет вести себя, прежде чем он вступит в силу.

Хотя параметр "Активный" выбран по умолчанию, рассмотрите, какое состояние соответствует вашей ситуации:

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

Удаление исходного правила защиты ветви

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

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

Дополнительные материалы