Provision
—— XP

Удалённый репозиторий и запрос на слияние

теория~7 минут+150 XP

Твои коммиты пока лежат только у тебя на диске. Как их увидит коллега, где их проверит ревьюер и откуда возьмёт конвейер CI/CD? Через удалённый репозиторий — копию твоего репозитория на сервере, через которую команда обменивается коммитами. Обычно он живёт в GitLab или GitHub: там его видят коллеги, там проходит ревью и оттуда запускается конвейер. Урок о том, как пятеро человек правят одни конфиги и ни одна правка не теряется и не перезаписывает чужую молча.

Работа с ним сводится к четырём командам: clone — получить копию, pull — забрать чужие коммиты, push — отправить свои, и fetch — просто узнать, что нового. Главное правило у них одно: свою версию нельзя положить поверх, не посмотрев, что за ночь отправили коллеги. Сначала забираешь их правки, совмещаешь со своими и только потом отправляешь. Остальное — договорённости команды о том, как правки попадают в main.

remote — имя для адреса

Связь с сервером в Git называется remote. Это просто сохранённый адрес под коротким именем. Когда ты клонируешь репозиторий, Git сам заводит remote с именем origin. Посмотреть их помогает флаг -v (verbose, «подробно»).

ubuntu@stand:~$
git remote -v
ubuntu@stand:~$
origin  git@gitlab.example.com:team/infra.git (fetch)
origin  git@gitlab.example.com:team/infra.git (push)

Адрес вида git@сервер:путь — это доступ по SSH, тот же ключ, что в разделе про сервер. Бывает и вариант через https://, тогда Git спрашивает логин и токен. В уже существующий репозиторий remote добавляют командой git remote add origin адрес. Сам по себе адрес ничего не отправляет: коммиты по нему ходят, только когда ты явно об этом попросишь.

clone, push, pull и fetch

git clone адрес скачивает репозиторий целиком, со всей историей, и сразу настраивает origin. git push отправляет твои новые коммиты на сервер. В первый раз для новой ветки добавляют флаг -u, чтобы Git запомнил, куда её отправлять: git push -u origin main. Дальше хватает просто git push.

git pull забирает чужие коммиты и вливает их в твою ветку. На деле это две команды в одной: git fetch, который только скачивает, и git merge. Чтобы понять, зачем их разделили, нужно знать про одну метку.

Слева локальная сторона: main и origin/main оба указывают на C5. Справа сервер, где main уже на C7. Пунктир разделяет стороны, стрелка показывает, что origin/main — запись о прошлом состоянии сервера.
origin/main — это запись о том, где был main на сервере в момент последнего обмена.

Метка origin/main хранит, где был main на сервере, когда ты последний раз с ним общался. Это воспоминание, а не прямая связь: на сервере коллеги могли уже уйти вперёд. git fetch обновляет воспоминание, ничего не меняя в твоих файлах, и после него git status честно говорит: «Your branch is behind 'origin/main' by 2 commits». Тогда и видно, что пора делать pull. Иногда сервер не принимает и push.

Почему сервер отвергает push

Ты сделал коммит и отправляешь его, а коллега успел отправить свой раньше. Сервер откажет.

ubuntu@stand:~$
git push
ubuntu@stand:~$
 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'gitlab.example.com:team/infra.git'
hint: Updates were rejected because the remote contains work that you do not have locally.

Это не ошибка, а защита: на сервере есть коммит, которого нет у тебя, и твой push затёр бы его. Лечится в два шага: git pull, чтобы забрать и влить чужое, при конфликте — разрешить его, как в прошлой практике, и снова git push.

У push есть флаг --force, «принудительно». Он перезаписывает ветку на сервере твоей версией, и коммиты коллеги пропадают. На общих ветках им не пользуются никогда. Чтобы ошибиться было невозможно, в командах main защищают совсем.

Запрос на слияние

В командах в main не пушат напрямую. Работа идёт в ветке, ветку отправляют на сервер и открывают запрос на слияние: в GitLab он называется Merge Request (MR), в GitHub — Pull Request (PR). Смысл один и тот же.

Шесть шагов сверху вниз: ветка от main, работа, отправка ветки, запрос на слияние, слияние, удаление ветки. От четвёртого шага в сторону отходят три ветвления: автоматические проверки, ревью человеком, правки по замечаниям.
Ветка, отправка, запрос, проверки и ревью, слияние.

Ты создаёшь ветку от свежего main, коммитишь и отправляешь её командой git push -u origin feature/имя. Потом на сайте нажимаешь «Create merge request». Дальше две проверки: конвейер CI сам прогоняет тесты и, например, nginx -t, а коллега читает разницу и оставляет замечания. Замечания исправляешь новыми коммитами в ту же ветку — они сами появятся в запросе. Когда проверки зелёные и коллега одобрил, нажимают «Merge», и ветку удаляют.

Ветку main в настройках проекта делают защищённой: прямой push в неё запрещён, попасть туда можно только через запрос на слияние. Сейчас удалённым репозиторием у нас будет простой каталог на том же стенде, а в разделе 12 про CI/CD ты поднимешь собственный GitLab, перенесёшь туда этот репозиторий и пройдёшь весь путь запроса на слияние с настоящим конвейером.

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

remote
Сохранённый адрес удалённого репозитория под коротким именем. ↩ к тексту
origin
Имя remote по умолчанию, его создаёт git clone.
origin/main
Запись о том, где был main на сервере при последнем обмене. Обновляется командой git fetch. ↩ к тексту
push и pull
Отправить свои коммиты на сервер и забрать чужие с вливанием в свою ветку.
Merge Request
Запрос на слияние ветки в GitLab: ревью, проверки CI и само слияние. В GitHub — Pull Request. ↩ к тексту
защищённая ветка
Ветка, куда нельзя пушить напрямую, только через запрос на слияние.
Удалённый репозиторий и merge request
подборка на ютубе · ролик не закреплён
Как выглядит запрос на слияние в интерфейсе GitLab.

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

  • Почему нельзя делать git push --force в общую ветку?
    Он перезапишет ветку на сервере твоей версией, и коммиты коллег, которых у тебя нет, пропадут. В своей личной ветке это допустимо, в main — никогда.
  • Как правка попадает в main в команде?
    Через ветку и запрос на слияние: push ветки, MR, проверки CI и ревью коллеги, затем слияние. Прямой push в main запрещён защитой ветки.
  • Что делает git fetch?
    Скачивает новые коммиты с сервера и обновляет origin/main, не трогая твою ветку и файлы.

Что дальше

В практике заведёшь свой «сервер» прямо на стенде, сделаешь второй клон за коллегу и получишь отказ при push.

Проверь себя+150 XPдве попытки
1
remote и origin
Что такое origin?
2
push, pull и fetch
Чем git fetch отличается от git pull?
3
Отказ при push
push отвергнут с «fetch first». Что сделать?
4
Запрос на слияние
Зачем ветку main защищают от прямого push?
ответь на все вопросы, чтобы проверить

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