funkypenguin/concourse-chartmuseum-resource

Concourse CI 的 ChartMuseum 资源

该资源用于与ChartMuseum（或集成ChartMuseum的Harbor）交互，实现Helm图表的获取、验证和发布，适用于Concourse CI流水线，常与Helm资源配合完成Kubernetes集群的自动化部署。

核心功能

• 版本检查: 检测指定Helm图表的新版本，支持SemVer版本范围过滤。
• 图表获取: 下载图表及其元数据、溯源文件，可自定义输出文件名。
• 图表发布: 上传更新后的图表，支持强制覆盖、版本覆盖、GPG签名等扩展功能。

使用场景

• 自动化管理Helm图表的版本生命周期，集成到CI/CD流水线中。
• 与Harbor/ChartMuseum配合，实现图表的安全存储与分发。
• 配合Helm资源完成Kubernetes应用的自动化部署与更新。

配置说明

安装

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

yaml
resource_types:
- name: chartmuseum
  type: docker-image
  source:
    repository: cathive/concourse-chartmuseum-resource
    tag: latest # 为确保构建可重现，建议使用特定标签而非"latest"

源配置（Source Configuration）

• server_url: 必填。ChartMuseum或Harbor的API地址。例如ChartMuseum为https://chartmuseum.yourdomain.com/api/charts；Harbor为https://harbor.yourdomain.com/api/chartrepo/<项目名>/charts。
• chart_name: 必填。目标图表名称。
• version_range: 可选。SemVer版本范围（如=1.2.0、^2.0.0）。
• basic_auth_username: 可选。认证用户名（需与basic_auth_password同时使用）。
• basic_auth_password: 可选。认证密码（需与basic_auth_username同时使用）。
• harbor_api: 可选。设置为true以适配Harbor的API差异。

"In"操作参数

• target_basename: 可选。自定义输出文件的基础名称。

"Out"操作参数

• chart: 必填。待上传的图表压缩包路径或文件夹（文件夹将自动打包）。
• force: 可选。强制覆盖已存在的版本（需ChartMuseum未启用--disable-force-overwrite）。
• version: 可选。覆盖Chart.yaml中的版本号。
• version_file: 可选。从文件读取版本号覆盖Chart.yaml。
• sign: 可选。启用GPG签名（需同时提供key_data或key_file）。
• key_data: 可选。GPG密钥数据（sign为true时使用）。
• key_file: 可选。GPG密钥文件路径（sign为true时使用）。
• key_passphrase: 可选。GPG密钥密码（sign为true时使用）。