Теги¶

Работа с тегами¶

Теги используются в Системе для маркировки важных событий в истории репозитория. В системе реализовано два типа тегов:

Легкие — для определенных коммитов (не содержат никакой дополнительной информации). Также известны как «мягкие». Создаются и удаляются по мере необходимости.
Аннотированные — содержат метаданные, могут заверяться в целях верификации и не могут изменяться.

Создание и удаление тегов может являться триггером процессов автоматизации:

Использование веб-хука для автоматизации действий, например, рассылки уведомлений в Slack.
Сигнализация о необходимости обновления зеркала репозитория.
Запуск CI/CD- пайплайна (if: $CI_COMMIT_TAG).

При создании релиза Система также создает тег, чтобы зафиксировать этот момент. Во многих проектах аннотированный тег релиза сочетается со стабильной веткой. Рассмотрите возможность автоматической установки тегов для развертывания или релизов.

В интерфейсе Системы о каждом теге отображается следующая информация:

Имя тега.
Значок защищенного тега (опционально).
SHA коммита (ссылка на коммит).
Заголовок коммита и дата его создания.
Ссылка на релиз (опционально).
При наличии запущенного пайплайна его статус (опционально).
Ссылка на скачивание исходного кода и артефактов, связанных с тегом.
Кнопка Создать релиз.
Кнопка удаления тега.

Просмотр тегов проекта¶

Выберите Поиск и переход... слева в меню и найдите проект.
Выберите Код > Теги. Отобразятся все теги проекта.

Просмотр тегированных коммитов в списке коммитов¶

Выберите Поиск и переход... слева в меню и найдите проект.
Выберите Код > Коммиты.
Тегированные коммиты отмечаются соответствующей иконкой с именем тега. На картинке ниже — v1.3.

Чтобы просмотреть перечень коммитов в данном теге, нажмите на имя тега.

Создание тега¶

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

Создание тега из командной строки¶

Чтобы создать легкий тег, выполните команду git tag TAG_NAME, где TAG_NAME — имя создаваемого тега.

Для создания аннотированного тега выполните в командной строке одну из следующих команд:

\# Укороченная версия — имя аннотированного тега —"v1.0",
\# и сообщение "Version 1.0".
git tag -a v1.0 -m "Version 1.0"
\# Используйте эту версию, чтобы оставить более длинное сообщение
\# для аннотированного тега "v1.0" в текстовом редакторе.
git tag -a v1.0

Отправьте тег в репозиторий, выполнив команду git push origin --tags.

Создание тега в пользовательском интерфейсе¶

Выберите Поиск и переход... слева в меню и найдите проект.
Выберите Код > Теги.
Нажмите Новый тег.
В поле Название тега укажите имя тега.
В поле Создать из выберите имя существующей ветки, тега или SHA коммита.
При необходимости, чтобы создать аннотированный тег, в поле Сообщение оставьте сообщение или оставьте это поле пустым, если создается облегченный тег.
Нажмите Создать тег.