访问仓库

仓库（Repository）是集中存放镜像的地方。注册服务器（Registry）是管理仓库的具体服务器，每个服务器上可以有多个仓库，而每个仓库下面有多个镜像。

智算云平台的镜像中心提供了 Docker Registry 服务，向租户提供镜像仓库服务。

Docker Hub

由于运营商网络原因，会导致您拉取 Docker Hub 镜像时下载失败。建议您在生产环境中谨慎使用依赖于 Docker Hub 的容器镜像。

智算云平台不提供官方加速服务。您可以自行使用第三方镜像加速服务。

NOTE

• 平台暂不提供 registry-mirrors 配置修改能力。
• 平台暂不提供 docker pull、docker run、docker build 的 proxies 配置修改能力。

租户私有仓库

购买预付费资源（包两年/包年/包月/包日）的租户将在智算云平台的 Docker Registry 服务上获得私有的租户镜像仓库，用于存放租户的自定义镜像。平台自动为租户生成租户的镜像仓库地址，免费提供 200 GiB 的存储空间。

不同可用区有独立的 Docker Registry 服务器，但通用地址为 cr.infini-ai.com。您可以在平台内网使用该通用地址。

例如，对于租户私有仓库镜像地址 cr.infini-ai.com/te-c7va2fg6uawxdzkf/alpine:latest 来说：

• cr.infini-ai.com 是智算云平台 Docker Registry 服务器地址。
• te-c7va2fg6uawxdzkf 是租户的私有仓库名称，与租户 ID 相同。
• alpine:latest 是镜像名称和镜像标签。

如果需要从公网向智算云平台的租户私有镜像仓库推送镜像，则需要使用与可用区对应的 Docker Registry 服务器地址。详见迁移外部镜像。

NOTE

当前仅向够买包年包月资源的客户提供租户私有镜像仓库服务。如您的租户账号中不存在包年包月资源池，暂无法使用租户私有镜像仓库。您可以前往智算云平台的资源池页面检查您的租户资源池状态。

拉取镜像

直接拉取 Docker Hub 镜像时，会检查本地是否存在指定的镜像，不存在就从 Docker Hub Registry。由于运行商网络限制，会导致镜像下载失败：

# 检查本地是否存在指定的镜像，不存在就从 registry 下载
# 但无法直接拉取 Docker Hub 镜像
docker run ubuntu:22.04 /bin/echo 'Hello world'

请改为从智算云平台的镜像中心拉取预置镜像，或拉取租户私有仓库中的自定义镜像。

例如，拉取平台预置的 Ubuntu 镜像：

# 登入开发机后操作
docker pull cr.infini-ai.com/infini-ai/ubuntu:22.04-20240429

拉取平台预置的 CUDA 镜像：

#拉取平台预置的 CUDA 镜像
docker pull cr.infini-ai.com/infini-ai/cuda:12.2.2-cudnn8-devel-ubuntu20.04

NOTE

• 由于运营商网络限制，会导致您拉取 Docker Hub 镜像时下载失败。您可以自行使用第三方镜像加速服务。
• 平台暂不提供 registry-mirrors 配置修改能力。
• 平台暂不提供 docker pull、docker run、docker build 的 proxies 配置修改能力。

推送至租户镜像仓库

在平台内网中，您可以通过已开启 「Docker 容器」功能的开发机推送镜像至租户私有镜像仓库，作为自定义镜像。

例如，在启用了「Docker 容器」功能的开发机上，平台默认已完成登录，无需执行 docker login 即可推送到租户私有镜像仓库：

# 拉取 quay.io 的镜像作为示例
docker pull quay.io/coreos/etcd:v3.5.5
# 修改镜像标签，使用租户 ID 作为私有镜像仓库的地址
docker tag quay.io/coreos/etcd:v3.5.5 te-c7va2fg6uawxdzkf/etcd:v3.5.5
# 推送镜像至租户私有镜像仓库，开发机内默认登录租户私有镜像仓库，无需 docker login
docker push cr.infini-ai.com/te-c7va2fg6uawxdzkf/etcd:v3.5.5

NOTE

• 如果您所属租户在不同可用区均购买了资源，请注意租户在不同可用区的镜像仓库的存储网络相互隔离，暂不支持同步（但共用同一个内网地址）。例如，可用区 A 向 cr.infini-ai.com/te-b914754427352251 推送镜像，平台自动映射到可用区 A 的镜像仓库，可用区 B 无法使用该镜像。
• 如果您有镜像 tar 包，可上传至开发机后使用 docker load 加载镜像，再推送到租户镜像仓库。详见迁移外部镜像。
• 支持从公网向租户私有仓库推送镜像，请使用镜像中心提供的公网地址。详见迁移外部镜像。

常见问题

无法拉取 Docker Hub 镜像

由于运营商网络原因，会导致您拉取 Docker Hub 镜像时下载失败。建议您在生产环境中谨慎使用依赖于 Docker Hub 的容器镜像。

无法推送镜像至租户私有镜像仓库

请检查开发机是否已启用「Docker 容器」功能。如未启用，可前往开发机详情页，通过「改配」按钮启用「Docker 容器」功能。

当前仅向够买包年包月资源的客户提供租户私有镜像仓库服务。如您的租户账号中不存在包年包月资源池，暂无法使用租户私有镜像仓库。您可以前往智算云平台的资源池页面检查您的租户资源池状态。

如何处理镜像构建失败

如果镜像中心显示构建失败，请联系无问芯穹技术支持团队。

如何从公网推送镜像至租户私有镜像仓库

镜像中心 Registry 的通用地址为 cr.infini-ai.com，仅提供内网访问。如需从公网推送镜像至租户私有镜像仓库，请使用镜像中心提供的公网地址。

详见迁移外部镜像。