标签

在 Git 中，标签标记代码仓库历史中的一个重要节点。 Git 支持两种类型的标签：

  • 轻量级标签指向特定的提交，不包含其他信息，也称为软标签。您可以根据需要创建或删除它们。
  • 注释的标签包含元数据，可以签名来进行验证，并且不能更改。

标签的创建或删除可以用作自动化的触发器，包括：

当您创建一个发布时，极狐GitLab 也会创建一个标签来标记发布点。许多项目将注释的发布标签与稳定分支结合在一起。考虑自动设置部署或发布标签。

要防止用户使用 git push 删除标签，请创建一个推送规则。

在极狐GitLab UI 中，每个标签显示：

Example of a single tag

  • 标签名称（）。
  • 可选。如果标签是受保护的，显示一个受保护徽章。
  • 提交 SHA（），链接到提交内容。
  • 提交标题和创建日期。
  • 可选。发布的链接（）。
  • 可选。如果流水线已运行，则显示当前流水线状态。
  • 源代码和关联标签的产物的下载链接。
  • 创建发布 () 的链接。
  • 删除标签的链接。

查看项目的标签

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 在左侧边栏中，选择 代码 > 标签。

在提交列表中查看有标签的提交

引入于 15.10 版本。

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 在左侧边栏中，选择 代码 > 提交。

  3. 具有标签的提交，标有标签图标 () 和标签名称。以下示例显示标签为 v1.26.0 的提交：

    A tagged commit in the Commits view

要查看此标签中的提交列表，请选择标签名称。

创建标签

您可以从命令行或极狐GitLab UI 创建标签。

命令行

要从命令行创建轻量级或注释的标签，并将其推送到上游：

  1. 要创建轻量级标签，请运行命令 git tag TAG_NAME，将 TAG_NAME 更改为您想要的标签名称。

  2. 要创建注释的标签，请使用 git tag 的一个版本运行命令： 

    # In this short version, the annotated tag's name is "v1.0",
# and the message is "Version 1.0".
git tag -a v1.0 -m "Version 1.0"

# Use this version to write a longer tag message
# for annotated tag "v1.0" in your text editor.
git tag -a v1.0
  3. 使用 git push origin --tags 将您的标签推送到上游。

UI

要从 UI 创建标签：

  1. 在左侧边栏中，选择 搜索或转到 并找到您的项目。
  2. 在左侧边栏中，选择 代码 > 标签。
  3. 选择 新建标签。
  4. 提供一个 标签名称。
  5. 选择现有分支名称、标签或提交 SHA。
  6. 可选。添加 消息 可以创建注释的标签，或留空可以创建轻量级标签。
  7. 选择 创建标签。