# 设置标签

标签是语义版本的补充，用于更精细地标记和分发软件包。Armory 提供了软件包标签管理功能，您可以在发布软件包时指定软件包标签，也可以在发布后，为软件包添加或移除标签。本节重点介绍如何为已发布软件包添加和移除标签。

# 操作须知

• 每个软件包版本最多可添加 3 个标签，每个标签长度不能超过 50 个字符，并且应具有唯一性。
• 标签与语义版本共享命名空间。为了避免与现有版本号冲突，建议不要在标签中使用以数字或字母“v"开头的命名。
• 对于个人软件包，只有软件包所有者可以添加或移除标签；对于组织软件包，只有组织所有者、组织管理员和软件包管理员可以添加和移除标签。关于软件包权限的详细说明，请参见 权限概览。

# 前提条件

已 配置仓库地址。

# 操作步骤

1. 在开始搜索框或任意文件夹地址栏输入“cmd”，打开终端。

2. 在终端执行如下命令，查看当前生效的仓库地址是否为目标仓库。

    armory repo ls
   
   

   如果是目标仓库，则继续执行步骤 3；如果非目标仓库，则可以执行armory repo use命令，通过键盘上下键选择目标仓库，并按“Enter”键完成选择。

3. 执行armory login按提示输入用户名密码，或直接执行armory login -u <username> -p <password>，登录客户端。

4. 在终端执行armory tag 命令，为软件包添加或移除标签。下面以软件包名称为“@cloudnative_lab/armory-client”，版本为“1.0.0”，标签为“beta”为例进行介绍。

# 添加标签

1. 执行如下命令，为软件包添加标签。

   armory tag add <@namespace/package-name>@<version> <tag>
   

   参数说明如下：

   参数	是否必选	说明
   @namespace/package-name	是	完整的软件包名称，包含命名空间和软件包名，如 @cloudnative_lab/armory-client 表示 cloudnative_lab 组织命名空间下的 armory-client 软件包
   version	是	软件包版号，用于对不同版本的软件包设置标签，如 1.3.0
   tag	是	软件包标签，用于更精细地标记和分发软件包，如公开测试版的包可以标记为 beta

   

2. 添加成功后，执行armory tag ls命令，可以查看软件包版本和标签信息。

   armory tag ls <@namespace/package-name>
   
   

   也可以登录 Web 端，在软件包详情的版本界面，查看软件包标签。

# 移除标签

执行如下命令，移除软件包标签。

armory tag rm <@namespace/package-name>@<version> <tag>