Защита ветвей с помощью Buildbot

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

В настоящее время защищенными ветвями являются основные ветви 10.X и ветви релизов bb-10.X-release*

Порядок действий с защищенными ветвями

1. Сделайте перебазирование своей работы на основе последней основной ветви. git rebase 10.2
2. Отправьте изменения на ветвь bb-*
3. Подождите, пока пройдут все проверки.
4. Если все проверки пройдут успешно, вы можете отправить изменения на главную ветвь, чтобы она стала такой же, как bb-* ветвь.
5. Если проверки не пройдены (ошибки), проверьте статус сборки, внесите необходимые изменения и повторите этот порядок действий.

Строители защищенных ветвей

В настоящее время обязательны следующие строители:

1. amd64-centos-7
2. amd64-debian-10
3. amd64-fedora-35
4. amd64-ubuntu-2004-clang11
5. amd64-windows
6. amd64-windows-packages

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

--suite=main --skip-test="^stack_crash$|^float$|^derived_split_innodb$|^mysql_client_test$|^kill$|^processlist_not_embedded$|^sp-big$"

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

Отключенные защищенные ветви

1. ppc64le-rhel-8 (временно отключено, ожидание исправления проблемы с пропускной способностью сети)
2. aarch64-debian-10 (временно отключено, до момента увеличения вычислительной мощности)

Просмотр статуса сборки

Статус сборки можно увидеть непосредственно на GitHub рядом с сообщением о коммите. Ниже приведен пример (обратите внимание на желтую точку рядом с сообщением о коммите):

Если вы нажмете на желтую точку, вы увидите список выполненных проверок и их статус, как показано ниже:

Нажав на Подробности, вы будете перенаправлены на страницу buildbot, отображающую все подробности сборки.

Кроме того, вы можете найти сборки на в представлении сетки Buildbot. Это позволяет фильтровать по ветви, чтобы видеть только изменения для конкретной ветви. Например, https://buildbot.mariadb.org/#/grid?branch=10.5.

Статус и действия

• Желтая точка - указывает, что одна или несколько проверок еще не завершены.
  • Действие: подождите, пока все проверки завершатся
• Зеленый галочек - все проверки прошли успешно.
  • Действие: никаких действий не требуется. Коммит может быть совершен!
• Красный крестик - одна или несколько проверок завершились неудачно.
  • Действие: изучите статус сбоев и устраните возможные проблемы.

Примечание: В критериях защиты ветвей в настоящее время учитываются только buildbot, а не внешние системы CI (Travis, AppVeyor и т. д.). Обратите внимание и на другие ошибки, и если они приемлемы и объяснены, то можно объединять.

Повторное запуск проверок

В некоторых случаях может быть полезно повторно запустить одну или несколько проверок. Это легко сделать через интерфейс https://buildbot.mariadb.org. Шаги:

1. Войдите на https://buildbot.mariadb.org с учетными данными GitHub: Нажмите кнопку «Анонимный» в правом верхнем углу, затем «Войти с GitHub», как показано ниже:
   • 
2. Откройте подробности сборки, которую хотите повторно запустить.
3. Нажмите кнопку «Пересборка» в правом верхнем углу.

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