cathive/concourse-chartmuseum-resource

Concourse CI的ChartMuseum资源镜像

该镜像为Concourse CI提供ChartMuseum资源，用于与运行中的ChartMuseum实例（或使用ChartMuseum底层的Harbor）交互，实现Helm Charts的获取、验证和发布。建议与Helm资源配合使用，以完成Kubernetes集群的Helm部署。

核心功能

• 检查新版本：根据SemVer版本范围检测指定Helm Chart的更新
• 获取与验证：下载Chart包、元数据及校验文件，并支持自定义输出文件名
• 发布更新：上传Chart包（支持强制覆盖、版本覆盖、GPG签名、依赖更新等）

使用场景

• 在Concourse CI流水线中自动化管理Helm Charts的版本生命周期
• 配合Helm资源实现Kubernetes应用的持续部署流程
• 与Harbor集成管理私有Chart仓库

配置说明

资源类型安装

在Concourse CI流水线中添加资源类型：

yaml
resource_types:
- name: chartmuseum
  type: docker-image
  source:
    repository: cathive/concourse-chartmuseum-resource
    tag: latest # 建议使用具体版本（如v0.10.0）确保构建可重现

源配置（Source Configuration）

• server_url：必填，ChartMuseum/Harbor的API地址（ChartMuseum示例：https://chartmuseum.yourdomain.com/api/charts；Harbor示例：https://harbor.yourdomain.com/api/chartrepo/<项目名>/charts）
• chart_name：必填，目标Chart的名称
• version_range：可选，SemVer版本范围（如^2.0.0、~0.2.3）
• basic_auth_username/basic_auth_password：可选，Basic认证的用户名/密码（需同时提供）
• harbor_api：可选，设为true以适配Harbor的API差异

行为说明

check：检测Chart新版本

根据源配置中的版本范围，定期检查指定Chart的可用新版本。

in：获取Chart并验证

将Chart的元数据JSON、.tgz包文件和校验文件写入目标目录，可通过target_basename参数自定义输出文件名。

out：推送Chart更新

关键参数：

• chart：必填，Chart包路径或文件夹（文件夹将自动打包为.tgz）
• force：可选，强制覆盖已存在的版本（需ChartMuseum未启用--disable-force-overwrite）
• version/version_file：可选，覆盖Chart.yaml中的版本（前者直接输入，后者从文件读取）
• sign：可选，启用GPG签名（需同时提供key_data/key_file和key_passphrase）
• dependency_update：可选，设为true以更新Chart依赖（如有依赖时必填）