Как создать аннотированный тег?

Аннотированный тег в Git создается командой git tag -a, в отличие от легковесного тега, создаваемого командой git tag без опции -a. Аннотированные теги хранят больше информации, включая имя тегера, email, дату создания и сообщение.

Как создать аннотированный тег:

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

git checkout main
git pull origin main

Затем используйте команду git tag -a:

git tag -a v1.0 -m "Релиз версии 1.0: Исправлены ошибки и добавлены новые функции"

Где:

• v1.0 - имя тега. Рекомендуется использовать семантическое версионирование.
• -a - опция, указывающая на создание аннотированного тега.
• -m - опция, позволяющая добавить сообщение к тегу (комментарий). Без -m откроется редактор, где можно будет ввести сообщение.

Просмотр информации о теге:

Чтобы посмотреть информацию о созданном теге, используйте команду git show:

git show v1.0

Вы увидите информацию о коммите, на который указывает тег, а также метаданные тега (тегер, дата и сообщение).

Отправка тега на удаленный репозиторий:

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

git push origin v1.0

Чтобы отправить все теги, используйте:

git push origin --tags

Краткое сравнение аннотированных и легковесных тегов:

• Аннотированные теги: Содержат информацию о теггере, дату, сообщение. Рекомендуются для публичных релизов.
• Легковесные теги: Просто указатель на коммит. Удобны для личного использования и временных пометок.

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