codesuki/concourse-helm-resource

Concourse Helm资源镜像

该镜像作为Concourse CI/CD平台的资源类型，用于将Helm Chart部署到Kubernetes集群，实现自动化的应用发布流程。

安装方法

在Concourse管道中添加资源类型：

yaml
resource_types:
- name: helm
  type: docker-image
  source:
    repository: codesuki/concourse-helm-resource

源配置（Source Configuration）

• cluster_url: 必填。Kubernetes Master API服务的URL。
• cluster_ca: 可选。Base64编码的PEM格式CA证书，当cluster_url为https时必填。
• token: 可选。Kubernetes的Bearer令牌，当cluster_url为https且无token_path或admin_key/admin_cert时必填。
• token_path: 可选。包含Kubernetes Bearer令牌的文件路径，当cluster_url为https且无token或admin_key/admin_cert时必填。
• admin_key: 可选。Base64编码的PEM格式管理员私钥，当cluster_url为https且无token或token_path时必填。
• admin_cert: 可选。Base64编码的PEM格式管理员证书，当cluster_url为https且无token或token_path时必填。
• release: 可选。发布名称（字符串，非文件），默认由Helm自动生成。
• namespace: 可选。Chart安装的Kubernetes命名空间，默认值为default。
• helm_init_server: 可选。若集群未安装Helm则自动安装，默认值为false。
• tiller_namespace: 可选。Tiller运行（或安装）的Kubernetes命名空间，默认值为kube-system。
• tiller_service_account: 可选。Tiller使用的服务账户名称（仅当helm_init_server为true时生效）。
• repos: 可选。需初始化的Helm仓库数组，每个仓库包含name、url（必填）及可选的username和password。
• helm_host: 可选。Tiller的地址，跳过Helm发现流程（仅当helm_init_server为false时生效）。

核心功能

check: 检查新版本

返回发布的任何新修订版（无论当前状态），需在源配置中指定release才能生效。

in: 不支持

out: 部署Helm Chart

将Helm Chart部署到Kubernetes集群，需确保集群已安装Tiller。

参数说明

• chart: 必填。Helm Chart文件（以.tgz结尾）或Chart名称（如stable/mysql）。
• namespace: 可选。命名空间名称或包含名称的文件路径，默认值取自源配置。
• release: 可选。发布名称或包含名称的文件路径，默认值取自源配置。
• values: 可选。包含values.yaml的文件路径，支持数组形式设置多个值文件。
• override_values: 可选。覆盖values.yaml的参数数组，每个条目包含key及value（直接设置）或path（从文件读取），hide: true可隐藏日志输出，encode: true可对值进行Base64编码。
• override_strings: 可选。覆盖values.yaml的字符串参数数组，使用--set-string强制字符串类型，结构同override_values。
• version: 可选。Chart版本（仅当chart为名称而非文件时生效）。
• delete: 可选。删除发布而非安装，需指定发布名称，默认值为false。
• purge: 可选。彻底清除发布（需与delete同时设置），默认值为false。
• replace: 可选。替换同名已删除的发布，默认值为false。
• force: 可选。必要时通过删除/重建强制更新资源，默认值为false。
• devel: 可选。允许安装开发版Chart（如预发布版本），默认值为false。
• wait_until_ready: 可选。等待Chart中所有资源就绪的秒数，默认值0表示不等待。
• recreate_pods: 可选。升级时重建所有Pod，默认值为false。

使用场景

• CI/CD管道中自动化部署Kubernetes应用
• 多环境（开发、测试、生产）的Helm Chart版本管理
• 批量配置覆盖与安全参数注入（如隐藏敏感值）

示例

部署Chart（Out操作）

定义资源：

yaml
resources:
- name: myapp-helm
  type: helm
  source:
    cluster_url: https://kube-master.domain.example
    cluster_ca: _base64编码的CA证书_
    admin_key: _base64编码的私钥_
    admin_cert: _base64编码的证书_
    repos:
      - name: some_repo
        url: https://somerepo.github.io/charts

添加到任务：

yaml
jobs:
  # ...
  plan:
  - put: myapp-helm
    params:
      chart: source-repo/chart-0.0.1.tgz
      values: source-repo/values.yaml
      override_values:
      - key: replicas
        value: 2
      - key: version
        path: version/number # 从version/number文件读取值
      - key: secret
        value: ((my-top-secret-value)) # 从Vault等凭据后端获取
        hide: true # 在输出中隐藏值