> ## 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.

# 容器镜像仓库概述

> 了解容器镜像仓库的适用场景、核心对象和使用路径。

容器镜像仓库是 GPU 云服务中用于保存、管理和分发容器镜像与 Helm Chart 的私有仓库。您可以将本地构建的镜像或 Chart 推送到指定地域的项目中，也可以从外部仓库导入镜像，供本地环境、CI/CD 流程或 CKS 集群拉取使用。

## 适用场景

容器镜像仓库适合以下场景：

* 在 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 流程或自动化任务需要访问项目中的制品，请为项目添加成员并配置权限。详情请参见[管理镜像仓库项目和成员](https://docs.siflow.cn/gpu-cloud/registry/create-view-container-registry-projects.md)。

**2. 推送和拉取制品**

根据制品类型选择对应的推送和拉取方式。

* Docker 镜像：使用 Docker 登录仓库，将本地镜像推送到项目中，或在本地环境、CI/CD 流程、CKS 集群中拉取使用。详情请参见[推送和拉取容器镜像](https://docs.siflow.cn/gpu-cloud/registry/push-pull-container-images.md)。
* Helm Chart：使用 Helm 登录仓库，将 Chart 按版本推送到项目中，或在其他环境中拉取指定版本。详情请参见[推送和拉取 Helm Chart](https://docs.siflow.cn/gpu-cloud/registry/push-pull-helm-charts.md)。

**3. 复制镜像**

如果镜像需要在不同仓库或地域之间流转，请根据镜像流向选择复制方式。

* 导入外部仓库的镜像时，使用 Pull Mode。详情请参见[导入外部仓库镜像](https://docs.siflow.cn/gpu-cloud/registry/import-external-container-images.md)。
* 将镜像同步到其他地域或外部仓库时，使用 Push Mode。详情请参见[同步镜像到其他地域或仓库](https://docs.siflow.cn/gpu-cloud/registry/sync-container-images.md)。

**4. 治理和追踪制品**

镜像进入项目后，可以根据保留、联动和审计需求配置治理能力。

* 需要清理不再使用的历史制品时，配置[镜像仓库制品保留策略](https://docs.siflow.cn/gpu-cloud/registry/configure-artifact-retention.md)。
* 需要在制品变化后通知下游系统时，配置[镜像仓库 Webhook](https://docs.siflow.cn/gpu-cloud/registry/configure-container-registry-webhook.md)。
* 需要回溯项目、制品或复制相关操作时，查看[镜像仓库审计日志](https://docs.siflow.cn/gpu-cloud/registry/view-container-registry-audit-logs.md)。


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