3. Chart仓库概述：Chart仓库的定义、仓库索引文件（index.yaml）结构、OCI与经典仓库对比

3.1 Chart仓库的定义与核心作用

Chart仓库（Chart Repository）是Helm生态中用于存储、版本管理和分发Helm Chart的标准化存储后端。它本质上是一个HTTP/HTTPS服务器，通过特定的目录结构和索引文件对外提供Chart的发现与下载能力。

在生产环境中，Chart仓库承担以下核心职责：

• Chart存储：以.tgz压缩包形式保存Chart的完整定义（模板、默认值、依赖等）。
• 版本管理：同一Chart可保留多个版本，支持回滚与渐进式发布。
• 元数据索引：通过index.yaml文件提供Chart名称、版本、描述、依赖关系等可搜索信息。
• 访问控制：结合反向代理或认证网关，实现私有仓库的权限管控。

3.2 仓库索引文件（index.yaml）结构

index.yaml是Chart仓库的核心元数据文件，位于仓库根目录。Helm客户端通过定期拉取该文件来获取仓库中所有Chart的完整清单。其结构采用YAML格式，遵循以下顶层字段：

每个Chart版本条目包含以下关键字段：

entries:
  nginx:
    - name: nginx
      version: 1.2.3
      apiVersion: v2
      appVersion: 1.21.0
      description: A simple NGINX deployment
      created: 2024-03-15T10:30:00Z
      urls:
        - nginx-1.2.3.tgz
      digest: sha256:abc123...
      type: application
      dependencies:
        - name: common
          version: ">=1.0.0"
          repository: "https://charts.example.com"
      annotations:
        category: web-server
      home: https://nginx.org
      sources:
        - https://github.com/nginxinc/helm-charts
      maintainers:
        - name: DevOps Team
          email: devops@example.com
      icon: https://nginx.org/favicon.ico
      kubeVersion: ">=1.19.0-0"
      keywords:
        - nginx
        - web
        - proxy

3.3 OCI与经典仓库对比

Helm支持两种Chart仓库协议：经典仓库（Classic Repository）和OCI（Open Container Initiative）仓库。两者在架构、存储模型和操作方式上存在显著差异。

3.3.1 经典仓库架构

经典仓库基于HTTP/HTTPS协议，使用index.yaml作为元数据索引，Chart以.tgz文件形式存储。Helm客户端通过解析索引文件定位Chart包并下载。

3.3.2 OCI仓库架构

OCI仓库将Chart作为OCI制品（Artifact）存储在符合OCI标准的容器镜像仓库中（如Harbor、Docker Hub、AWS ECR）。Chart被封装为OCI层，利用镜像仓库的标签、摘要和认证机制进行管理。

3.4 核心差异对比表

3.5 选型建议

以下场景推荐使用经典仓库：

• 需要离线环境下的Chart搜索与安装
• 团队使用Helm v3.7及以下版本
• 已有自建HTTP文件服务器（如Nginx、MinIO）
• 需要精细控制索引文件内容（如自定义annotations）

以下场景推荐使用OCI仓库：

• 基础设施已统一使用容器镜像仓库
• 需要利用镜像仓库的RBAC、审计、镜像扫描等安全能力
• 多集群场景下需要统一的制品分发管道
• 希望减少独立Chart仓库的运维成本

3.6 仓库操作示例

经典仓库添加与搜索：

# 添加经典仓库
helm repo add bitnami https://charts.bitnami.com/bitnami

# 更新本地索引缓存
helm repo update

# 搜索Chart
helm search repo nginx

# 安装Chart
helm install my-nginx bitnami/nginx --version 13.2.0

OCI仓库登录与安装：

# 登录OCI仓库
helm registry login registry.example.com --username admin

# 安装OCI Chart（直接引用仓库路径）
helm install my-app oci://registry.example.com/charts/my-app --version 1.0.0

# 推送Chart到OCI仓库
helm push my-app-1.0.0.tgz oci://registry.example.com/charts