Урок 6. Удалённые репозитории: clone, push, pull, fetch

До сих пор история жила только у вас на диске. Удалённый репозиторий (remote) — копия проекта на сервере: на GitHub, GitLab, своём сервере или даже в другой папке. С ним обмениваются коммитами: отправляют свои (push) и забирают чужие (fetch, pull). Так проект попадает на другой компьютер, к коллегам и заодно в резервную копию.

Создайте пустой репозиторий на сервере

На GitHub, GitLab и похожих сервисах новый репозиторий создаётся кнопкой в веб-интерфейсе: задаётся имя (например, todo) и видимость — публичный или закрытый. Если локальный репозиторий у вас уже есть, не добавляйте при создании файлы README, .gitignore и лицензию: иначе на сервере появится свой первый коммит, не связанный с вашей историей, и первая отправка не пройдёт. Если уже добавили — решение в справке rejected — non-fast-forward.

После создания сервис показывает адрес репозитория — в двух видах:

• HTTPS: https://github.com/ivan/todo.git — вход по имени пользователя и токену;
• SSH: git@github.com:ivan/todo.git — вход по SSH-ключу, как его добавить — в справке Как добавить SSH-ключ для GitHub.

Свяжите и отправьте

В папке своего репозитория (вместо https://github.com/ivan/todo.git — адрес, который показал сервис):

git remote add origin https://github.com/ivan/todo.git
git push -u origin main

origin — короткое имя удалённого репозитория; так его принято называть, хотя имя может быть любым. git push -u origin main отправляет ветку main в origin, а -u запоминает связь: дальше хватит просто git push и git pull. В конце вывода Git сообщит:

 * [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

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

$ git remote -v
origin    https://github.com/ivan/todo.git (fetch)
origin    https://github.com/ivan/todo.git (push)

Вход по HTTPS

GitHub не принимает пароль от учётной записи для работы Git по HTTPS: вместо пароля нужен токен (personal access token), созданный в настройках учётной записи, или вход по SSH-ключу. В Git for Windows обычно ставится Git Credential Manager — при первой отправке он сам открывает окно входа в учётную запись и запоминает доступ. У GitLab и других сервисов похожие правила — смотрите их справку.

Склонируйте проект

Обратная задача — получить копию существующего репозитория:

$ git clone https://github.com/ivan/todo.git
Cloning into 'todo'...

Появится папка todo со всеми файлами и всей историей, а origin уже будет указывать на сервер. Подробнее — в справке Как клонировать репозиторий.

Заберите изменения: fetch и pull

Кто-то отправил на сервер новые коммиты. Получить их можно двумя способами:

• git fetch — скачивает новые коммиты, но не меняет ваши файлы и ветки. Они видны как ветка origin/main — это то, что было на сервере в момент последнего обмена;
• git pull — то же самое плюс слияние: забирает и сразу вливает origin/main в вашу main.

После git fetch команда git status подскажет, что делать:

$ git status
On branch main
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

Сам git status с сервером не связывается: он сравнивает с тем, что скачано последним fetch или pull. Разница подробно — в справке Чем pull отличается от fetch.

Ветки разошлись

Если и у вас, и на сервере есть новые коммиты, git pull в свежих версиях Git может остановиться с подсказкой You have divergent branches and need to specify how to reconcile them и ошибкой fatal: Need to specify how to reconcile divergent branches. Git просит один раз выбрать способ объединения. Для начала подойдёт слияние — как в уроке о ветках:

git config --global pull.rebase false
git pull

Git создаст коммит слияния и откроет редактор с готовым сообщением — сохраните и закройте его. После этого отправка пройдёт: git push.

Отправку отклонили

Если на сервере есть коммиты, которых нет у вас, git push откажется: ! [rejected] main -> main (fetch first) или (non-fast-forward). Это защита, а не поломка: сначала заберите чужое через git pull, при конфликте решите его, потом снова git push. Подробно — в справке rejected — non-fast-forward.

Частые ошибки

• error: src refspec main does not match any — отправлять нечего: в репозитории ещё нет ни одного коммита или ветка называется иначе (master). Посмотрите git branch и отправьте ту ветку, что есть.
• error: remote origin already exists. — origin уже задан. Поменять адрес: git remote set-url origin новый-адрес.
• Repository not found — ошибка в адресе или у учётной записи нет доступа к закрытому репозиторию.
• Permission denied (publickey) — сервер не принял SSH-ключ, решение — в справке Permission denied (publickey).

Коротко

• git remote add origin адрес — связать репозиторий с сервером; git remote -v — посмотреть связь.
• git push -u origin main — первая отправка, дальше просто git push.
• git clone адрес — скачать проект со всей историей.
• git fetch скачивает, но ничего не меняет; git pull скачивает и сливает.
• Отклонённый push лечится git pull и повторным push.

Проверьте себя