> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 推送和拉取容器镜像

> 了解如何获取仓库地址，并使用 Docker 推送和拉取容器镜像。

当您需要将业务镜像上传到容器镜像仓库，或在本地环境、CI/CD 流程、CKS 集群中使用镜像时，可以获取当前地域的仓库地址，并按 **推送 & 拉取** 中的命令完成推送和拉取。

## 操作前确认

* 当前账号具备目标项目或仓库的推送、拉取权限。
* 已在本地环境或计算环境安装 Docker。
* 如需推送镜像，已准备需要推送的本地镜像。

## 获取命令

1. 登录 [GPU 云服务控制台](https://console.siflow.cn/gpu-cloud/home)，进入 **存储 > 镜像仓库** 页面。

2. 在右上角选择地域。

   不同地域对应不同仓库地址。后续命令中的仓库地址请以当前地域展示的地址为准。

3. 单击 **推送 & 拉取**。

4. 在 **Docker** 页签，查看登录、推送和拉取命令。

   如需推送或拉取 Helm Chart，可切换到 **Helm** 页签查看相关说明。

## 登录仓库

在本地环境或计算环境中执行登录命令。

```bash theme={null}
docker login <REGISTRY_ENDPOINT> --username <USERNAME>
```

| 参数 | 说明 |
| - | - |
| `<REGISTRY_ENDPOINT>` | 当前地域展示的仓库地址。 |
| `<USERNAME>` | 当前账号在镜像仓库中的用户名。 |

登录后，按命令行提示输入密码或访问凭证。

示例：

```bash theme={null}
docker login registry.example.com --username zhangsan
```

## 推送镜像

1. 为本地镜像添加目标仓库地址、项目路径和标签。

   ```bash theme={null}
   docker tag <LOCAL_IMAGE>:<TAG> <REGISTRY_ENDPOINT>/<PROJECT>/<IMAGE>:<TAG>
   ```

   | 参数 | 说明 |
   | - | - |
   | `<LOCAL_IMAGE>` | 本地镜像名称。 |
   | `<TAG>` | 镜像标签。 |
   | `<REGISTRY_ENDPOINT>` | 当前地域展示的仓库地址。 |
   | `<PROJECT>` | 目标项目名称。 |
   | `<IMAGE>` | 推送到仓库后的镜像名称。 |

   示例：

   ```bash theme={null}
   docker tag resnet:1.0.0 registry.example.com/ai-demo/resnet:1.0.0
   ```

2. 推送镜像。

   ```bash theme={null}
   docker push <REGISTRY_ENDPOINT>/<PROJECT>/<IMAGE>:<TAG>
   ```

   示例：

   ```bash theme={null}
   docker push registry.example.com/ai-demo/resnet:1.0.0
   ```

   推送完成后，可在 **项目** 页签查看目标项目的仓库数量是否更新。需要回溯操作记录时，可查看 **审计日志**。

## 拉取镜像

在本地环境、CI/CD 流程或 CKS 集群节点中执行拉取命令。

```bash theme={null}
docker pull <REGISTRY_ENDPOINT>/<PROJECT>/<IMAGE>:<TAG>
```

| 参数 | 说明 |
| - | - |
| `<REGISTRY_ENDPOINT>` | 当前地域展示的仓库地址。 |
| `<PROJECT>` | 镜像所在项目名称。 |
| `<IMAGE>` | 镜像名称。 |
| `<TAG>` | 镜像标签。 |

示例：

```bash theme={null}
docker pull registry.example.com/ai-demo/resnet:1.0.0
```

如果拉取失败，先检查仓库地址、项目名称、镜像名称、标签，以及目标项目或仓库的拉取权限是否与目标镜像一致。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.