当前位置：首页 > news >正文

如何创建并使用极狐GitLab 部署令牌？

news 来源：原创 2025/4/28 5:54:57

极狐GitLab 是 GitLab 在中国的发行版，关于中文参考文档和资料有：

极狐GitLab 中文文档
极狐GitLab 中文论坛
极狐GitLab 官网

部署令牌 (BASIC ALL)

您可以使用部署令牌来启用部署任务的身份验证，而与用户账户无关。在大多数情况下，您使用来自外部主机的部署令牌，例如构建服务器或 CI/CD 服务器。
使用部署令牌，自动化任务可以：

克隆 Git 仓库。
从极狐GitLab 容器镜像库中提取和推送。
从极狐GitLab 软件包库中提取和推送。

部署令牌是一对值：

用户名：HTTP身份验证框架中的 username。默认用户名格式为 gitlab+deploy-token-{n}。您可以在创建部署令牌时指定自定义用户名。
令牌：HTTP 身份验证框架中的 password。

您可以将部署令牌对以下端点进行 HTTP 身份验证：

极狐GitLab 软件包库公共 API。
Git 命令。

您可以在项目或群组级别创建部署令牌：

项目部署令牌：权限仅适用于项目。
组部署令牌：权限适用于群组中的所有项目。

默认情况下，部署令牌不会过期。您可以选择在创建时设置到期日期。到期发生在该日期的 UTC 午夜。
WARNING:
如果启用了外部授权，则不能将新的或现有的部署令牌用于 Git 操作和软件包库操作。

范围

部署令牌的范围决定了它可以执行的操作。

范围	描述
`read_repository`	使用 `git clone` 对仓库进行只读访问。
`read_registry`	对项目容器镜像库中镜像的只读访问权限。
`write_registry`	对项目容器镜像库中镜像的写入访问（推送）权限。
`read_package_registry`	对项目的软件包库的只读访问权限。
`write_package_registry`	对项目的软件包库的写入权限。

极狐GitLab 部署令牌

在群组级别对 gitlab-deploy-token 的支持引入于 15.1 版本，功能标志为 ci_variable_for_group_gitlab_deploy_token。默认启用。
功能标志 ci_variable_for_group_gitlab_deploy_token 删除于 15.4 版本。

极狐GitLab 部署令牌是一种特殊类型的部署令牌。如果您创建一个名为 gitlab-deploy-token 的部署令牌，部署令牌会自动作为变量公开给 CI/CD 作业，以便在 CI/CD 流水线中使用：

CI_DEPLOY_USER：用户名
CI_DEPLOY_PASSWORD：令牌

例如，要使用极狐GitLab 令牌登录到极狐GitLab 容器镜像库：

docker login -u $CI_DEPLOY_USER -p $CI_DEPLOY_PASSWORD $CI_REGISTRY

NOTE:
在 15.0 及更早版本中，gitlab-deploy-token 部署令牌的特殊处理不适用于群组部署令牌。要使群组部署令牌可用于 CI/CD 作业，请将 设置 > CI/CD > 变量 中的 CI_DEPLOY_USER 和 CI_DEPLOY_PASSWORD CI/CD 变量设置为群组部署令牌的名称和令牌。

极狐GitLab 公共 API

部署令牌不能与极狐GitLab 公共 API 一起使用。但是，您可以将部署令牌与某些端点一起使用，例如来自软件包库的端点。有关详细信息，请参阅软件包库身份验证。

创建部署令牌

创建部署令牌以自动执行可独立于用户账户运行的部署任务。
先决条件：

您必须至少具有项目或群组的维护者角色。

1.在左侧边栏中，选择 搜索或转到，然后：

对于项目部署令牌，选择您的项目。
对于群组部署令牌，选择您的群组。

2.在左侧边栏中，选择 设置 > 仓库。
3.展开 部署令牌。
4.填写字段，然后选择所需的范围。
5.选择 创建部署令牌。

记录部署令牌的值。离开或刷新页面后，无法再次访问。

撤销部署令牌

不再需要令牌时将其撤消。
先决条件：

您必须至少具有项目或群组的维护者角色。

要撤销部署令牌：

1.在左侧边栏中，选择 搜索或转到，然后：

对于项目部署令牌，选择您的项目。
对于组部署令牌，选择您的群组。

2.在左侧边栏中，选择 设置 > 仓库。
3.展开 部署令牌。
4.在 可用部署令牌 部分，通过您要撤销的令牌，选择撤销。

克隆仓库

您可以使用部署令牌来克隆仓库。
先决条件：

具有 read_repository 范围的部署令牌。

使用部署令牌克隆仓库的示例：

git clone https://<username>:<deploy_token>@gitlab.example.com/tanuki/awesome_project.git

从容器镜像库中拉取镜像

您可以使用部署令牌从容器镜像库中提取镜像。
先决条件：

具有 read_registry 范围的部署令牌。

使用部署令牌从容器镜像库中提取镜像的示例：

docker login -u <username> -p <deploy_token> registry.example.com
docker pull $CONTAINER_TEST_IMAGE

将镜像推送到容器镜像库

您可以使用部署令牌将镜像推送到容器镜像库。
先决条件：

具有 write_registry 范围的部署令牌。

使用部署令牌将镜像推送到容器镜像库的示例：

docker login -u <username> -p <deploy_token> registry.example.com
docker push $CONTAINER_TEST_IMAGE

从软件包库中拉取软件包

您可以使用部署令牌从软件包库中拉取包。
先决条件：

具有 read_package_registry 范围的部署令牌。

对于您选择的包类型，请按照部署令牌的身份验证说明进行操作。
从极狐GitLab 库安装 NuGet 包的示例：

nuget source Add -Name GitLab -Source "https://gitlab.example.com/api/v4/projects/10/packages/nuget/index.json" -UserName <username> -Password <deploy_token>
nuget install mypkg.nupkg

推送软件包到软件包库

您可以使用部署令牌将包推送到极狐GitLab 软件包库。
先决条件：

具有 write_package_registry 范围的部署令牌。

对于您选择的包类型，请按照部署令牌的身份验证说明进行操作。
将 NuGet 包发布到软件包库的示例：

nuget source Add -Name GitLab -Source "https://gitlab.example.com/api/v4/projects/10/packages/nuget/index.json" -UserName <username> -Password <deploy_token>
nuget push mypkg.nupkg -Source GitLab