Что происходит при выполнении `git push --mirror`?

Команда git push --mirror является мощным, но опасным инструментом, используемым для создания точной копии локального репозитория Git в удаленном репозитории. Она, по сути, синхронизирует все ветки, теги и другие ссылки между локальным и удаленным репозиториями, удаляя удаленные ссылки, которые не существуют в локальном репозитории.

Вот что происходит шаг за шагом:

1. Удаление существующих веток/тегов на удаленном репозитории: Самое важное, git push --mirror сначала удаляет все ветки и теги, которые существуют в удаленном репозитории, но не существуют в локальном репозитории. Это происходит перед отправкой новых данных. Это критично для понимания: если вы случайно удалили ветку локально и запустите git push --mirror, она будет удалена и на удаленном репозитории!
2. Отправка всех веток: Она отправляет все локальные ветки (включая ветки, которые были удалены в удаленном репозитории, но все еще существуют локально) в удаленный репозиторий. Она отправляет изменения каждой ветки, существующей в локальном репозитории.
3. Отправка всех тегов: Аналогично веткам, она отправляет все локальные теги в удаленный репозиторий, включая новые теги, и обновляет существующие. Удаленные теги, отсутствующие локально, также удаляются.
4. Перезаписывает конфигурацию хуков (hooks) (если настроено): В некоторых сценариях, в зависимости от конфигурации, может также перезаписать удаленные хуки, соответствующие локальным.

Когда это полезно:

• Создание зеркальных копий репозитория: Основная цель - создать точную резервную копию репозитория, включая структуру веток и тегов.
• Миграция репозитория: Когда необходимо перенести репозиторий на другой сервер, можно использовать git push --mirror для создания точной копии на новом сервере.

Почему это опасно:

• Потеря данных: Если случайно удалена ветка локально, а затем выполнена git push --mirror, ветка будет безвозвратно удалена и на удаленном репозитории. Это может привести к потере важной работы.
• Влияние на других разработчиков: git push --mirror может нарушить работу других разработчиков, которые работают с удаленным репозиторием, особенно если она удаляет ветки, над которыми другие работают.
• Не подходит для обычной работы: Это не команда, которую следует использовать для обычной отправки изменений. Для этого следует использовать git push.

В заключение: Используйте git push --mirror с особой осторожностью и только когда абсолютно уверены, что понимаете последствия. Перед использованием рекомендуется сделать резервную копию удаленного репозитория.