Provision
—— XP

Практика: перенести репозиторий и пройти ревью

практика~30 минут+525 XP

Твой репозиторий ~/infra из раздела 06 до сих пор жил в локальном «сервере» — голом репозитории в каталоге. Сейчас он переедет в настоящий GitLab, и ты проведёшь правку от коммита до слияния в main так, как это делают на работе каждый день.

Перед началом проверь, что GitLab запущен и здоров: docker compose ps в ~/gitlab должен показать (healthy).

Шаг 1. Группа

Группа — папка для проектов. Создадим одну, devops.

В левом меню GitLab нажми + вверху → New group → Create group. Имя — devops, адрес (Group URL) подставится сам. Видимость — Private: проекты увидят только участники. Нажми Create group.

Ты окажешься на пустой странице группы. Адрес в браузере — http://192.168.1.50:8929/devops, это и есть путь группы.

Шаг 2. Проект

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

На странице группы: New project → Create blank project. Имя — infra. Сними галочку Initialize repository with a README — это главное в этом шаге. Нажми Create project.

GitLab покажет пустой проект с подсказками команд. Нам нужен раздел Push an existing Git repository — он ровно про наш случай.

Шаг 3. Посмотреть текущие удалённые репозитории

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

ubuntu@stand:~$
cd ~/infra
git remote -v
ubuntu@stand:~$
origin  /home/anton/git-server/infra.git (fetch)
origin  /home/anton/git-server/infra.git (push)

origin — старый локальный «сервер» из раздела 06. Его не трогаем, а добавим рядом второй, с именем gitlab.

Шаг 4. Добавить GitLab

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

Адрес длинный, поэтому сначала положим его в переменную шелла, как в разделе 03. Скопировать его можно кнопкой Code → Clone with HTTP на странице проекта.

ubuntu@stand:~$
URL=http://192.168.1.50:8929/devops/infra.git
ubuntu@stand:~$
git remote add gitlab $URL

Обе команды молчат при успехе. Проверим ещё раз:

ubuntu@stand:~$
git remote -v
ubuntu@stand:~$
gitlab  http://192.168.1.50:8929/devops/infra.git (fetch)
gitlab  http://192.168.1.50:8929/devops/infra.git (push)
origin  /home/anton/git-server/infra.git (fetch)
origin  /home/anton/git-server/infra.git (push)

Адрес по HTTP — проще всего для начала. Вход по SSH-ключу на порт 2424 тоже работает, но потребует добавить ключ в профиль; на стенде обойдёмся паролем.

Шаг 5. Отправить историю

Отправляем ветку main в GitLab. Флаг -u запоминает связь: дальше git push в этой ветке будет знать, куда отправлять.

ubuntu@stand:~$
git push -u gitlab main
ubuntu@stand:~$
Username for 'http://192.168.1.50:8929': root
Password for 'http://root@192.168.1.50:8929':
Enumerating objects: 64, done.
Writing objects: 100% (64/64), 9.81 KiB | 9.81 MiB/s, done.
To http://192.168.1.50:8929/devops/infra.git
 * [new branch]      main -> main
branch 'main' set up to track 'gitlab/main'.

Git спросил логин и пароль — это пользователь GitLab, тот же root. Строка [new branch] main -> main значит, что ветка появилась на сервере. Обнови страницу проекта в браузере: там твои файлы и вся история коммитов.

Шаг 6. Закрыть прямой push

Теперь запретим пушить в main напрямую — всем, включая тебя.

В проекте: Settings → Repository → раздел Protected branches → Expand. У ветки main в колонке Allowed to push and merge выбери No one. Колонку Allowed to merge оставь Maintainers.

Проверим, что защита работает. Сделай пустой коммит и попробуй отправить его напрямую. Флаг --allow-empty разрешает коммит без изменений, -m задаёт сообщение.

ubuntu@stand:~$
git commit --allow-empty -m "проверка защиты"
ubuntu@stand:~$
git push
ubuntu@stand:~$
remote: GitLab: You are not allowed to push code to protected branches on this project.
To http://192.168.1.50:8929/devops/infra.git
 ! [remote rejected] main -> main (pre-receive hook declined)

Отказ — это успех шага. Уберём пробный коммит: reset --hard HEAD~1 из раздела 06 возвращает ветку на один коммит назад.

ubuntu@stand:~$
git reset --hard HEAD~1

Шаг 7. Ветка с изменением

Изменения теперь идут через ветки. Создадим ветку и поправим README: флаг -c у switch создаёт новую ветку и переходит в неё.

ubuntu@stand:~$
git switch -c docs/gitlab

Открой README.md в nano и допиши в конец строку: Репозиторий живёт в GitLab: http://192.168.1.50:8929/devops/infra. Затем закоммить.

ubuntu@stand:~$
git add README.md
git commit -m "docs: адрес репозитория в GitLab"

Шаг 8. Отправить ветку

Отправляем новую ветку — она не защищена, и GitLab её примет.

ubuntu@stand:~$
git push -u gitlab docs/gitlab
ubuntu@stand:~$
remote: To create a merge request for docs/gitlab, visit:
remote:   http://192.168.1.50:8929/devops/infra/-/merge_requests/new?merge_request%5Bsource_branch%5D=docs%2Fgitlab
To http://192.168.1.50:8929/devops/infra.git
 * [new branch]      docs/gitlab -> docs/gitlab

GitLab сам подсказывает ссылку на создание merge request. Открой её в браузере.

Шаг 9. Merge request

На странице нового MR заголовок подставился из коммита. Проверь, что Source branch — docs/gitlab, Target branch — main, и нажми Create merge request.

Открой вкладку Changes. Зелёная строка — то, что ты добавил. Наведи мышь на номер строки, нажми на появившийся значок комментария и напиши себе замечание, например: «А по SSH какой порт?». Нажми Start a review → Submit review.

Так выглядит ревью: комментарий привязан к строке и висит открытым, пока его не закроют.

Шаг 10. Ответить на ревью и влить

Ответь на комментарий во вкладке Overview и нажми Resolve thread — вопрос закрыт.

Теперь кнопка Merge внизу. Галочка Delete source branch удалит ветку после слияния — оставь её: ветка своё отработала. Нажми Merge. Статус MR сменится на Merged.

Шаг 11. Забрать результат к себе

Слияние произошло на сервере, локальная main о нём ещё не знает. Возвращаемся в неё и забираем.

ubuntu@stand:~$
git switch main
git pull
ubuntu@stand:~$
Updating 4e1a2c7..b93f0d1
Fast-forward
 README.md | 1 +
 1 file changed, 1 insertion(+)

Посмотрим на сам коммит слияния. Флаг --merges оставляет только коммиты слияния, -1 — один последний, --format=%B печатает полное сообщение.

ubuntu@stand:~$
git log --merges -1 --format=%B
ubuntu@stand:~$
Merge branch 'docs/gitlab' into 'main'

docs: адрес репозитория в GitLab

See merge request devops/infra!1

Последняя строка — ссылка на MR с номером !1. По ней через год можно найти обсуждение и понять, почему изменение сделали именно так.

Шаг 12. Сдать

Выполни команду сдачи. Она покажет удалённый репозиторий и последний коммит слияния в gitlab/main.

Практика 02+525 XP

Перенести свой репозиторий в GitLab, защитить основную ветку и провести изменение по рабочему пути: ветка, merge request, ревью, слияние.

  • Удалённый репозиторий gitlab добавлен
  • Изменение влито через merge request
  • Слияние сделано в GitLab, а не руками
Команда сдачи — выполни на своей машине
команда
cd ~/infra; git remote -v | grep gitlab; git fetch -q gitlab; git log --merges -1 --format=%B gitlab/main

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