操作指南

1. 创建及删除

1.1 创建镜像仓库

在镜像仓库产品 UHub 页面，点击创建镜像仓库，输入镜像仓库名称以及备注，创建镜像仓库。如当前项目已有镜像仓库，请在镜像仓库名称下拉列表中选择新建镜像仓库。

• 镜像仓库名称必须为全局唯一（不能与其他用户、项目镜像仓库名称重合）
• 每个项目支持最多 8 个镜像仓库。

1.2 删除镜像仓库

点击镜像仓库控制台页面右上角删除镜像库按钮，进行镜像仓库删除；

• 仅支持删除空镜像仓库。如镜像仓库中仍有镜像，请先进行删除。

2. 账户和权限

环境准备： 在装有 docker (版本要求1.10 以上版本) 机器上通过 docker login 执行登录。

2.1 控制台账号

登录用户名 为 UCloud 平台注册的邮箱，密码 为控制台登录密码。

可通过Docker命令登录镜像仓库，通过域名访问服务：

docker login uhub.service.ucloud.cn -u user@ucloud.cn

2.2 独立密码

可在容器镜像库页面进行独立密码设置；独立密码的账号为UCloud 平台注册的邮箱，密码 为设置的独立密码。

• 独立密码与账号密码不一样时，两个账号密码可以同时使用；
• 独立密码与登录用户名进行绑定，而不是与镜像仓库进行绑定。
• 修改独立密码将适用于所有镜像仓库，支持在 UCloud 内网和外网登录使用。

3. 仓库访问设置

对外共享镜像库

• 镜像仓库默认为非公开，只能被主账户及对该镜像仓库所在项目有相应权限的子账户拉取。
• 如果你希望自己镜像被平台内其他用户拉取，可以将对外共享镜像库设置为公开。

外网访问

• 可以通过外网访问开关，禁止通过外网推送及拉取仓库镜像。
• 如果您的仓库权限为对外共享镜像库，则仅禁止公网推送，仍然具有公网拉取的权限。

4. 推送和拉取镜像

4.1 推送镜像

Step 1: 本地对镜像打一个tag:

docker tag {本地镜像名} uhub.service.ucloud.cn/{已创建镜像仓库}/{镜像}:tag

Step2：提交镜像到仓库:

docker push uhub.service.ucloud.cn/{已创建镜像仓库}/{镜像}:tag

4.2 拉取镜像

docker pull uhub.service.ucloud.cn/{已创建镜像仓库}/{镜像}:tag

5. 跨地域使用体验

UCloud公共镜像库为跨地域架构，在一个地域节点推送的镜像，在其他地域的节点都可以通过内网进行拉取。

如在华北一可用区C，推送镜像：

在上海二地域也可进行拉取到：

只要镜像推送完成，UCloud 平台内所有内网已经覆盖的地域都可以通过内网拉取到已经推送的镜像。

6. 使用限制

1. 单个镜像最多保留 800 个 Tag，超过 800 个后，一个月内未被拉取的 Tag 及相关镜像将会被删除，优先删除较早上传的镜像。

2. 镜像大小不做限制，但单层镜像超过 5G 将有推送失败的可能。

3. 外网拉取镜像速度限制为 1MB/s 每层。

4. 暂不支持内网拉取镜像的地域：福建。

最近更新时间：2025-03-06 02:32:04