适用场景
容器镜像仓库适合以下场景：- 在 CKS 集群中部署容器化业务前，集中保存业务镜像。
- 将团队构建的镜像按项目和标签管理，供开发、测试或生产环境拉取。
- 保存 Helm Chart，用于复用 Kubernetes 应用部署配置。
- 将外部仓库中的镜像导入 GPU 云服务，或将 GPU 云服务中的镜像同步到其他地域或外部仓库。
- 通过审计日志、Webhook 和保留策略回溯操作、联动下游系统并清理历史制品。
核心概念
地域和仓库地址
镜像仓库按地域提供服务，不同地域对应不同仓库地址。推送、拉取和同步镜像时，请使用镜像所在地域或目标地域对应的仓库地址。项目
项目用于组织一组容器镜像或 Helm Chart，也是镜像路径中的组成部分。推送前，先确认目标地域和项目；拉取时，通常需要使用仓库地址、项目名称、镜像或 Chart 名称及版本信息。 项目可配置成员和访问范围。涉及业务镜像、内部组件或其他敏感内容时，建议在创建项目时同步确认访问范围。制品
容器镜像和 Helm Chart 都属于镜像仓库中的制品。您可以通过 Docker 推送和拉取容器镜像，通过 Helm 推送和拉取 Chart。需要清理历史版本时，可以配置制品保留策略。复制规则
复制规则用于在不同仓库之间流转镜像。根据镜像流向选择不同模式：- 从外部仓库导入镜像到 GPU 云服务时，使用 Pull Mode。
- 将 GPU 云服务中的镜像同步到其他地域或外部仓库时，使用 Push Mode。
治理和追踪
镜像仓库提供保留策略、Webhook 和审计日志。- 保留策略用于清理不再需要的历史制品。
- Webhook 用于在制品发生变化时通知下游系统。
- 审计日志用于查询镜像仓库中的操作记录。
使用路径
1
准备项目和成员
推送 Docker 镜像或 Helm Chart 前，先在目标地域创建项目。项目是镜像路径中的组成部分，也用于管理制品的访问范围。如果团队成员、CI/CD 流程或自动化任务需要访问项目中的制品，请为项目添加成员并配置权限。详情请参见管理镜像仓库项目和成员。
2
推送和拉取制品
根据制品类型选择对应的推送和拉取方式。
- Docker 镜像：使用 Docker 登录仓库，将本地镜像推送到项目中，或在本地环境、CI/CD 流程、CKS 集群中拉取使用。详情请参见推送和拉取容器镜像。
- Helm Chart：使用 Helm 登录仓库，将 Chart 按版本推送到项目中，或在其他环境中拉取指定版本。详情请参见推送和拉取 Helm Chart。
3
复制镜像
如果镜像需要在不同仓库或地域之间流转，请根据镜像流向选择复制方式。
- 导入外部仓库的镜像时，使用 Pull Mode。详情请参见导入外部仓库镜像。
- 将镜像同步到其他地域或外部仓库时，使用 Push Mode。详情请参见同步镜像到其他地域或仓库。
4
治理和追踪制品
镜像进入项目后，可以根据保留、联动和审计需求配置治理能力。
- 需要清理不再使用的历史制品时，配置镜像仓库制品保留策略。
- 需要在制品变化后通知下游系统时，配置镜像仓库 Webhook。
- 需要回溯项目、制品或复制相关操作时，查看镜像仓库审计日志。