arrivalmobility/concourse-s3-helm-chart-resource

S3-based Helm Chart仓库的Concourse资源镜像

镜像概述

该镜像为Concourse CI/CD平台提供专用资源类型，用于与基于S3的Helm Chart仓库交互。通过集成此资源，可在流水线中实现Helm Chart的自动化同步、版本管理和分发，简化基于S3存储的Helm仓库运维流程。

核心功能与特性

• Chart同步管理：支持从本地或远程源将Helm Chart同步至S3仓库，反之亦然
• 索引自动更新：自动生成和更新Helm仓库索引文件（index.yaml），维护Chart版本元数据
• 版本控制机制：跟踪S3仓库中Chart版本变化，支持版本过滤和选择
• Concourse原生集成：实现Concourse标准资源操作（check/in/out），无缝融入CI/CD流水线
• 灵活存储配置：支持AWS S3及S3兼容存储服务（如MinIO），可配置访问密钥、区域和自定义端点

使用场景与适用范围

• CI/CD流水线中自动构建并推送Helm Chart至S3仓库
• 多环境（开发/测试/生产）Helm Chart版本管理与隔离
• 基于Git变更触发S3仓库Chart自动更新
• 实现Helm Chart版本化发布与回滚流程
• 与Helm部署步骤联动，构建完整的Chart交付链路

使用方法与配置说明

资源类型定义

在Concourse pipeline中首先定义资源类型：

yaml
resource_types:
- name: s3-helm-repo
  type: docker-image
  source:
    repository: <镜像仓库地址>  # 替换为实际镜像仓库地址

资源配置

定义具体资源实例，配置S3仓库连接信息：

yaml
resources:
- name: my-s3-helm-repo
  type: s3-helm-repo
  source:
    bucket: my-helm-charts  # S3存储桶名称
    region: ap-southeast-1  # S3区域
    access_key_id: ((s3-access-key))  # S3访问密钥ID（建议使用Concourse变量管理）
    secret_access_key: ((s3-secret-key))  # S3密钥（建议使用Concourse变量管理）
    index_file: index.yaml  # 索引文件名，默认index.yaml
    endpoint: https://s3.example.com  # 自定义S3端点（S3兼容存储时使用，可选）

操作说明

1. Check操作

自动检测S3仓库中Chart版本变化，触发流水线执行：

yaml
jobs:
- name: chart-update-job
  plan:
  - get: my-s3-helm-repo
    trigger: true  # 当检测到版本变化时自动触发

2. In操作

从S3仓库拉取指定版本Chart至工作目录：

yaml
jobs:
- name: deploy-chart
  plan:
  - get: my-s3-helm-repo
    version: {tag: "1.2.3"}  # 指定拉取的Chart版本
  - task: deploy
    config:
      inputs:
      - name: my-s3-helm-repo  # 拉取的Chart文件位于此目录
      run:
        path: helm
        args: ["install", "my-release", "my-s3-helm-repo/my-chart-1.2.3.tgz"]

3. Out操作

将本地Chart打包并推送至S3仓库，更新索引文件：

yaml
jobs:
- name: build-and-push-chart
  plan:
  - get: chart-source  # 从Git仓库获取Chart源代码
    trigger: true
  - task: package-chart
    config:
      inputs:
      - name: chart-source
      outputs:
      - name: packaged-charts
      run:
        path: sh
        args:
        - -c
        - |
          helm package chart-source/my-chart -d packaged-charts/
  - put: my-s3-helm-repo
    params:
      chart_dir: packaged-charts/  # 包含.tgz格式Chart文件的目录
      version_file: chart-source/VERSION  # 版本号文件路径（可选，覆盖Chart.yaml版本）
      force: false  # 是否覆盖已有版本，默认false

配置参数说明

Source参数（资源配置）

Out操作参数