Управление автоматическим удалением ветвей - документация GitHub Enterprise Server 310

GitHub Enterprise Server 310 предоставляет новую функциональность - управление автоматическим удалением ветвей. Эта функция позволяет пользователям указать, какие ветви должны быть автоматически удалены из репозитория, в соответствии с заданными условиями.

Управление ветвями стало более удобным и эффективным благодаря новым функциям GitHub Enterprise Server 310. Теперь вы можете настроить правила, чтобы определенные ветви автоматически удалялись при выполнении заданных условий, что освободит вам время и ресурсы.

О настройке удаления ветвей.

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

Настройка автоматического удаления ветвей

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

Для включения автоматического удаления ветвей необходимо выполнить следующие действия:

1. Откройте репозиторий, в котором вы хотите настроить удаление ветвей.
2. Перейдите во вкладку "Settings" (Настройки).
3. Выберите "Branches" (Ветви).
4. Прокрутите вниз до раздела "Branch protection rules" (Правила защиты ветвей).
5. Нажмите на кнопку "Add rule" (Добавить правило).
6. В появившемся окне настройте параметры правила.
7. Установите флажок "Automatically delete head branches" (Автоматически удалять ветви).
8. Нажмите на кнопку "Create" (Создать).

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

Однако, если ветвь содержит защищенный статус (например, сборка не прошла успешно), она не будет удалена автоматически. Также, если пользователь имеет права на защиту ветви, он может вручную отключить автоматическое удаление.

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

Создание правила удаления

Чтобы создать правило удаления в вашем проекте GitHub Enterprise Server, следуйте этим шагам:

Шаг 1: Откройте репозиторий проекта на GitHub Enterprise Server.

Шаг 2: Нажмите на вкладку "Settings" (Настройки) вверху страницы.

Шаг 3: Прокрутите вниз до раздела "Options" (Параметры) и выберите "Branches" (Ветки).

Шаг 4: В разделе "Branch Protection Rules" (Правила защиты веток) нажмите кнопку "Add rule" (Добавить правило).

Шаг 5: Введите имя создаваемого правила в поле "Rule name" (Имя правила).

Шаг 6: Введите паттерн или выберите ветку, для которой будет применяться правило удаления.

Шаг 7: Включите опцию "Enable default branch protection" (Включить защиту для основной ветки), если вы хотите применить правило удаления к основной ветке по умолчанию.

Шаг 8: Выберите тип правила удаления, например, "Dismiss stale pull request approvals when new commits are pushed" (Отклонять устаревшие подтверждения запросов на слияние при публикации новых коммитов).

Шаг 9: Нажмите кнопку "Create" (Создать), чтобы завершить создание правила удаления.

Примечание: Создание правила удаления позволяет автоматически применять определенные действия к веткам вашего проекта на GitHub Enterprise Server. Например, вы можете настроить удаление ветки после определенного времени без активности или отклонение устаревших запросов на слияние при публикации новых коммитов.

Настройка условий удаления

Для автоматического удаления ветвей в GitHub Enterprise Server 3.10 вы можете настроить условия, при которых ветвь будет удалена. За это отвечает файл конфигурации .github/auto-delete.yml в основной ветви вашего репозитория.

В файле .github/auto-delete.yml вы можете указать различные условия для удаления ветвей, включая:

• Время жизни ветви: вы можете задать, через какое время неактивной ветви она будет удалена. Например, если вы устанавливаете `days: 30`, то ветвь, не имеющая активности в течение 30 дней, будет удалена автоматически.
• Правила удаления: вы можете определить определенные правила для удаления ветвей. Например, вы можете указать, что ветви, название которых начинается с "feature/", должны быть удалены после 14 дней без активности. Или вы можете задать, чтобы ветви, название которых содержит "bugfix", не удалялись.
• Исключения: вы можете исключить определенные ветви из автоматического удаления путем указания их названий или регулярных выражений.

Пример файла .github/auto-delete.yml:

# Удаление ветвей через 30 дней без активности
days: 30
# Правила удаления
rules:
# Удаление ветвей, название которых начинается с "feature/", через 14 дней без активности
- prefix: "feature/"
days: 14
# Не удалять ветви, название которых содержит "bugfix"
- neg_regex: "bugfix"

После настройки условий в файле .github/auto-delete.yml GitHub Enterprise Server будет периодически проверять все ветви в вашем репозитории и удалять те, которые соответствуют указанным условиям.

Установка расписания удаления

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

1. Откройте страницу настроек вашего репозитория.
2. Выберите вкладку "Branches" (Ветви).
3. Прокрутите до раздела "Automatically delete head branches" (Автоматически удалять основные ветви).
4. Установите флажок "Enable scheduled branch deletion" (Включить расписание удаления ветвей).
5. Выберите интервал времени, через который ветви будут автоматически удаляться. Например, вы можете выбрать "1 week" (1 неделя) или "1 month" (1 месяц).
6. Нажмите кнопку "Save" (Сохранить).

После установки расписания удаления, все ветви, которые соответствуют условиям расписания, будут автоматически удалены. Вы также можете вручную удалить любую ветвь в любое время, нажав на кнопку "Delete" (Удалить) рядом с ней.

Проверка наличия правил удаления

Перед включением автоматического удаления ветвей в репозитории GitHub Enterprise Server 3.10, убедитесь в наличии правил удаления, которые определяют условия для автоматического удаления ветвей. Эти правила определяют, основываясь на условиях, например, возрасте и состоянии ветви, когда ветвь будет удалена автоматически.

Чтобы проверить наличие правил удаления, выполните следующие действия:

1. Откройте репозиторий на GitHub Enterprise Server.
2. Перейдите в раздел "Settings" (Настройки).
3. Выберите вкладку "Branches" (Ветви).
4. Прокрутите страницу вниз до раздела "Branch deletion" (Удаление ветвей).
5. Проверьте, есть ли установленные правила удаления. Если установлено, вы увидите определенные значения для параметров, таких как "Branch name" (Имя ветви), "Age" (Возраст) и "Condition" (Условие).

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

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

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

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

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

1. Перейдите на страницу вашего репозитория.
2. На панели навигации справа выберите вкладку "Settings".
3. На странице настроек репозитория выберите пункт "Branches".
4. Прокрутите вниз до секции "Automatic deletion"

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

Если вы хотите добавить новое правило удаления, нажмите кнопку "New rule" в секции "Automatic deletion". Затем следуйте указанным инструкциям и настройте условия для автоматического удаления ветвей.

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

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

Проверка состояния удаления

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

Следующие способы могут помочь вам проверить состояние удаления ветви:

1. Используйте команду git branch в командной строке для вывода списка ветвей в вашем локальном репозитории. Если ветвь успешно удалена, она не будет отображаться в списке.

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

3. Если вы используете GitHub API, вы можете отправить GET-запрос на универсальный URL-адрес ветви (/repos/{owner}/{repo}/branches/{branch}) и проверить, отвечает ли сервер кодом состояния 404, что указывает на успешное удаление ветви.

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

Отключение автоматического удаления ветвей

GitHub Enterprise Server предоставляет возможность настраивать автоматическое удаление ветвей после их слияния с основной веткой. Это удобная функция, которая позволяет поддерживать репозиторий в чистом состоянии, удаляя неиспользуемые ветки автоматически.

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

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

Чтобы отключить автоматическое удаление ветвей, следуйте этим шагам:

1. Откройте репозиторий на GitHub Enterprise Server
2. Перейдите на страницу "Settings" (Настройки)
3. Выберите вкладку "Branches" (Ветки)
4. Прокрутите вниз до раздела "Automatically delete head branches" (Автоматическое удаление ветвей)
5. Снимите галочку рядом с опцией "Enable branch auto-deletion" (Включить автоматическое удаление ветвей)
6. Сохраните изменения

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

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