Provision
—— XP

Проект, защищённая ветка и merge request

теория~5 минут+210 XP

Пятница, вечер, ты быстро правишь одну строку и делаешь git push прямо в main. В понедельник выясняется, что опечатка сломала сборку всей команде, а проверить изменение никто не успел. В командах от этого защищаются не дисциплиной, а настройками: защищённая ветка не принимает прямой push, а изменения попадают в неё только через merge request — запрос на слияние, который видят и проверяют коллеги. Так решается задача из раздела 06: чтобы в основную ветку ничего не попадало без проверки.

Начинается всё с того, где код лежит. Проект в GitLab — это репозиторий Git плюс всё, что вокруг него нужно команде: запросы на слияние, задачи, конвейеры, реестр образов и настройки. Проекты складывают в группы, как рабочие папки по отделам компании: нового сотрудника добавляют в отдел один раз, а не в каждую папку. Так и в GitLab: человек, переменная или раннер, добавленные в группу, действуют во всех её проектах.

Группы, проекты и роли

Адрес проекта всегда строится из группы и имени: http://192.168.1.50:8929/devops/infra. Здесь devops — группа, infra — проект. В этом разделе у нас будет ровно одна группа и один проект — твой репозиторий инфраструктуры из раздела 06.

Каждому участнику проекта выдают роль, и от неё зависит, что ему можно. Тебе достаточно знать три: Developer пушит в ветки и создаёт merge request, Maintainer ещё и сливает в защищённые ветки и меняет настройки, Owner управляет группой целиком. Остальные роли (Guest, Reporter, Planner) — для тех, кто только читает.

На стенде ты работаешь под root, и ему можно всё. На работе у тебя будет обычный пользователь с ролью Developer или Maintainer — и половина вопросов «почему у меня нет кнопки» решается проверкой роли.

Роли говорят, кто что может. Но даже у человека с полными правами одна опечатка в main ломает работу всем, и роль от этого не спасает.

Защищённая ветка

Защищённая ветка — ветка, на которую повешены правила: кто может в неё пушить, кто может сливать, можно ли переписывать историю. В новом проекте GitLab сам защищает main: пушить и сливать могут только Maintainer, а git push --force запрещён.

Мы сделаем строже: прямой push в main запретим всем, даже себе. Тогда любое изменение пойдёт через merge request — и через конвейер, который ты скоро напишешь. Попытка прямого push выглядит так:

ответ GitLab на прямой push
remote: GitLab: You are not allowed to push code to protected branches on this project.
 ! [remote rejected] main -> main (pre-receive hook declined)

Первая строка — человеческое объяснение, вторая — как это видит Git: сервер отказал ещё до приёма коммитов. Пугаться не надо: так и задумано.

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

Раз напрямую нельзя, нужен путь, которым изменения всё-таки попадают в main.

Merge request и ревью

Merge request (MR, запрос на слияние) — по сути просьба к коллегам: «посмотрите мою ветку и влейте её в main». На GitHub то же самое называют pull request. Ты пушишь ветку, GitLab в ответ печатает ссылку на создание MR, и дальше всё происходит в интерфейсе.

На странице MR есть три вещи. Вкладка Changes показывает разницу изменений — ту же, что git diff из раздела 06, только с цветом и номерами строк. Вкладка Overview — обсуждение и статус конвейера по этой ветке. А внизу — кнопка Merge, которая и делает слияние.

Ревью — это когда второй человек читает твои изменения до слияния и оставляет комментарии к строкам. Комментарий можно закрыть кнопкой Resolve thread, когда вопрос решён. Хорошее ревью смотрит не на стиль, а на последствия: «что будет, если этот порт уже занят», «откуда этот пароль».

В бесплатной редакции утверждение коллегой (approve) необязательно: кнопка есть, но Merge работает и без неё. Обязательные утверждения — функция платной версии, и в небольших командах их заменяют договорённостью.

Словарь урока

Группа
Папка для проектов с общими участниками, переменными и раннерами. ↩ к тексту
Роль
Что участнику можно: Developer пушит ветки, Maintainer сливает в защищённые и меняет настройки. ↩ к тексту
Защищённая ветка
Ветка с правилами: кто пушит, кто сливает, можно ли переписывать историю. ↩ к тексту
Merge request
Предложение влить ветку в другую: разница, обсуждение, конвейер и кнопка Merge. На GitHub — pull request. ↩ к тексту

Что спросят на собеседовании

  • Зачем защищать основную ветку?
    Чтобы изменения попадали в неё только через merge request с конвейером и ревью. Заодно защищённые переменные получат только задачи в защищённых ветках.
  • Чем Developer отличается от Maintainer?
    Developer пушит в обычные ветки и создаёт MR. Maintainer сливает в защищённые ветки и меняет настройки проекта.

Что дальше

Дальше — перенести свой репозиторий в GitLab и провести через ревью первое изменение.

Проверь себя+210 XPдве попытки
1
Группы и проекты
Зачем проекты складывают в группу?
2
Защищённая ветка
Что даёт защита ветки main с запретом прямого push?
3
Merge request
Что показывает страница merge request?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.