hstenzel/concourse-helm-resource

Concourse Helm资源镜像

镜像概述

本镜像作为Concourse CI/CD管道的Helm资源类型，实现从Concourse向Kubernetes集群部署Helm图表的自动化流程，支持灵活的集群连接配置、仓库管理及部署参数调整。

核心功能

1. 支持Kubernetes集群连接配置（如API地址、证书、令牌等）
2. 可初始化自定义Helm仓库和安装插件
3. 提供Tillerless模式和TLS加密通信选项
4. 支持部署参数覆盖、释放删除/测试等操作
5. 兼容kubeconfig文件配置，简化集群访问

使用场景

适用于CI/CD流水线中Kubernetes应用的自动化部署，例如：

• 代码提交后自动构建镜像并通过Helm部署到测试集群
• 版本发布时向生产集群推送指定版本的Helm图表
• 批量管理多环境下的Helm释放

配置说明

源配置（Source Configuration）

主要参数包括：

• cluster_url：Kubernetes Master API地址（可选，使用kubeconfig时无需设置）
• cluster_ca：Base64编码的集群CA证书（可选，HTTPS时需提供）
• token/token_path：Kubernetes访问令牌（可选，HTTPS时需提供）
• repos：Helm仓库数组（可选，包含名称、URL及认证信息）
• tillerless：是否启用Tillerless模式（默认false）

部署参数（Out Parameters）

关键参数包括：

• chart：必填，Helm图表文件路径或仓库名称（如stable/mysql）
• values：values.yaml文件路径（可选，支持多文件数组）
• override_values：覆盖值数组（可选，支持直接值、文件路径、隐藏敏感信息等）
• delete：是否删除释放（默认false）
• test：是否测试释放（默认false）

部署示例

1. 添加资源类型到流水线

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

2. 定义Helm资源

yaml
resources:
- name: myapp-helm
  type: helm
  source:
    cluster_url: https://kube-master.example.com
    cluster_ca: _base64_encoded_ca_pem_
    admin_key: _base64_encoded_key_pem_
    admin_cert: _base64_encoded_cert_pem_
    repos:
      - name: custom-repo
        url: https://my-charts.example.com

3. 流水线任务计划

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: secret
        value: ((my-secret))
        hide: true
      - key: image.tag
        path: version/image_tag
        type: string