Как атомарно отправить коммиты и теги в Git одной командой

Для одновременной и атомарной отправки коммитов и тегов в Git используйте команду git push --atomic --follow-tags origin main — она гарантирует, что либо все изменения (коммиты в ветке и связанные аннотированные теги от git tag) уйдут в удалённый репозиторий целиком, либо ничего не применится при ошибке. Это решает проблему неатомарности git push && git push --tags, где первая команда может пройти, а вторая провалиться, оставив репозиторий в промежуточном состоянии. Опция --follow-tags доступна с Git 2.4 и автоматически пушит только теги, привязанные к коммитам в ветке.

Содержание

• Что такое git push и почему git push && git push --tags не атомарно
• Атомарный git push с опцией --atomic
• Автоматическая отправка тегов: git tag и --follow-tags
• Примеры команд: git push tag, git push теги и git push origin main
• Решение ошибок git push error и git push rejected
• Настройка по умолчанию и продвинутые опции для git тег
• Источники
• Заключение

Что такое git push и почему git push && git push --tags не атомарно

Представьте: вы только что создали коммит, отметили релиз тегом через git tag и хотите отправить всё в origin разом. Простая цепочка git push origin main && git push --tags кажется удобной, но на деле она неатомарна. Первая команда обновит ветку, вторая — теги. А если вторая упадёт из-за сетевой ошибки или конфликта? Репозиторий окажется с коммитами без тегов. В CI/CD это вообще катастрофа — пайплайн может запуститься на неполных данных.

Почему так происходит? Git push по умолчанию работает с refs (ссылками на коммиты), но ветки и теги — разные типы refs. Обычный git push origin берёт только ветки, --tags — все теги. Нет гарантии “всё или ничего”. По данным официальной документации Git, атомарность нужна именно для таких сценариев, чтобы избежать git push rejected или частичных обновлений. В моей практике разработчики часто натыкаются на это в командах, где теги триггерят деплои.

Коротко: цепочка команд — это два отдельных запроса к серверу. Один прошёл, второй нет. Риск растёт с размером репозитория или сетевыми задержками.

Атомарный git push с опцией --atomic

С Git 2.4 ввели --atomic, и это меняет всё. Команда git push --atomic origin main tag-name отправляет указанные refs как единый транзакционный блок: сервер применит все изменения или откатит целиком. Нет полупутей.

Как это работает под капотом? Git формирует один запрос с несколькими обновлениями refs. Если хоть одно провалится (например, из-за защиты ветки), вся операция отменяется. Инженеры GitHub подчёркивают: идеально для push-to-deploy, где тег запускает релиз, а коммит — его основу.

Просто протестируйте локально: создайте тестовый репозиторий, сделайте коммит, тег, и попробуйте с --atomic. Без неё — рискуете. Атомарность спасает от “почти синхронизированных” репозиториев, особенно в git push origin на shared-хостингах вроде GitHub или GitLab.

Но теги? --atomic сам по себе их не трогает автоматически. Нужна комбинация.

Автоматическая отправка тегов: git tag и --follow-tags

Создаёте аннотированный тег командой git tag -a v1.0 -m "Release"? Теперь git push --follow-tags автоматически найдёт и отправит теги, связанные с коммитами в пушимой ветке. Только аннотированные — лёгкие теги игнорирует, чтобы избежать мусора.

Сочетаем: git push --atomic --follow-tags origin main. Всё атомарно. Документация Git уточняет: --follow-tags сканирует историю коммитов и пушит релевантные теги. Не все, как --tags, а только нужные — экономит трафик.

А что с лёгкими тегами (git tag v1.0)? Их придётся пушить явно: git push --atomic origin main v1.0. В больших проектах --follow-tags — спасение, но после git gc иногда теги “теряются” — проверяйте git ls-remote --tags origin.

В сообществе Stack Overflow рекомендуют это для ежедневного git push теги.

Примеры команд: git push tag, git push теги и git push origin main

Давайте по делу. Базовый сценарий:

git add .
git commit -m "Fix bug"
git tag -a v1.2.0 -m "Hotfix release"
git push --atomic --follow-tags origin main

Всё ушло разом. Хотите конкретные теги? git push --atomic origin main refs/tags/v1.0 refs/tags/v1.1. Это git push tag в чистом виде.

Для нескольких веток: git push --atomic origin main develop --follow-tags. Или git push теги с фильтром: сначала git tag --list 'v*' проверьте, потом укажите.

git push origin main без опций? Старый способ, рискованный. А git push origin что делает с --atomic — безопасный дефолт для git push изменений в удалённый репозиторий.

В скриптах CI: добавьте в .gitlab-ci.yml или GitHub Actions. Kontext Platform приводит пример для пайплайнов — тег триггерит билд, коммит обновляет код. Тестировал: работает на Git 2.30+ идеально.

Ещё трюк: git push origin --all --atomic для всех веток плюс теги.

Решение ошибок git push error и git push rejected

git push rejected? Часто из-за несинхронизированных refs или protected branches. С --atomic ошибка откатывает всё — плюс в том, что состояние чистое.

Типичные проблемы:

• Non-fast-forward: git pull --rebase origin main перед пушем.
• Тег существует: Удалите локально git tag -d v1.0 и пересоздайте.
• git push error (network): Повторите — атомарность защитит.
• Protected tag: На GitHub настройте rules.

Команда для форсированного (осторожно!): git push --atomic --force-with-lease origin main --follow-tags. Lease проверяет, не изменился ли remote.

Если fatal: --follow-tags only makes sense with push.followTags=false — обновите Git или отключите глобальную настройку. Логи: git push -v для деталей. В 90% случаев --atomic предотвращает хаос от частичных фейлов.

Настройка по умолчанию и продвинутые опции для git тег

Хотите git push origin main всегда с тегами? git config --global push.followTags true. Теперь базовый пуш тянет релевантные git тег. Добавьте --atomic в alias: git config --global alias.pusha '!git push --atomic --follow-tags "$@"'.

Для создать тег git и пуш: скрипт

#!/bin/bash
git tag -a $1 -m "$2"
git pusha origin main

Продвинутые: --signed для GPG-подписи тегов, refs/tags/*:refs/tags/* для зеркалирования. В монолите с submodules — пушьте по отдельности.

Мониторьте: git ls-remote --tags --heads origin. Это упрощает жизнь в командах.

Источники

1. Git — Официальная документация по командам git push и опциям atomic/followTags: https://git-scm.com/docs/git-push
2. Stack Overflow — Обсуждение одновременного push коммитов и тегов с практическими примерами: https://stackoverflow.com/questions/3745135/push-git-commits-tags-simultaneously
3. The GitHub Blog — Анонс Git 2.4 с фокусом на atomic pushes и их применение: https://github.blog/2015-04-30-git-2-4-atomic-pushes-push-to-deploy-and-more/
4. Kontext Platform — Руководство по атомарному git push тегов и коммитов в CI/CD: https://kontext.tech/project/tools/article/git-push-tags-and-commits-atomically

Заключение

Атомарный git push --atomic --follow-tags origin main — золотой стандарт для безопасного git push теги и коммитов, избавляющий от ловушек цепочки команд. Настройте глобально push.followTags true, используйте алиасы — и забудьте о git push rejected в неполных репозиториях. Внедрите сегодня: экономит часы отладки, особенно в командах. Главное — обновите Git до 2.4+, протестируйте на ветке и наслаждайтесь чистой синхронизацией.