访问仓库
仓库(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 服务器地址。详见迁移外部镜像。
拉取镜像
直接拉取 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
常见问题
无法拉取 Docker Hub 镜像
由于运营商网络原因,会导致您拉取 Docker Hub 镜像时下载失败。建议您在生产环境中谨慎使用依赖于 Docker Hub 的容器镜像。
无法推送镜像至租户私有镜像仓库
请检查开发机是否已启用「Docker 容器」功能。如未启用,可前往开发机详情页,通过「改配」按钮启用「Docker 容器」功能。
租户私有镜像仓库有存储空间限制。详见租户私有镜像仓库。
如何处理镜像构建失败
如果镜像中心显示构建失败,请联系无问芯穹技术支持团队。
如何从公网推送镜像至租户私有镜像仓库
镜像中心 Registry 的通用地址为 cr.infini-ai.com
,仅提供内网访问。如需从公网推送镜像至租户私有镜像仓库,请使用镜像中心提供的公网地址。
详见迁移外部镜像。