标签 (BASIC ALL)

在 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. 选择 创建标签