skyscrapers/concourse-helm-resource

Concourse Helm资源镜像

镜像概述

Concourse-helm-resource是Concourse CI/CD平台的专用资源类型，用于将Helm Chart部署到Kubernetes集群。它支持Tiller模式和无Tiller模式，提供灵活的集群认证、仓库管理和参数配置能力，帮助团队实现Kubernetes应用的自动化发布流程。

核心功能

• 支持Helm Chart的部署、升级、删除操作
• 兼容Tiller模式与无Tiller模式（Tillerless）
• 提供多种Kubernetes集群认证方式（Token、证书、kubeconfig）
• 支持Helm仓库初始化与插件安装
• 允许通过values文件或覆盖参数自定义Chart配置
• 包含调试、测试、版本控制等辅助功能

使用场景

• CI/CD管道中自动化部署Kubernetes应用
• 多环境（开发、测试、生产）的Helm Chart版本管理
• 需要审计和追溯的Kubernetes应用发布流程
• 无Tiller环境下的Helm部署需求

配置说明

资源类型配置

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

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

源配置（Source Configuration）

• cluster_url: 可选，Kubernetes Master API地址。使用kubeconfig_path时无需设置，否则为必填项。
• cluster_ca: 可选，Base64编码的PEM格式CA证书。当cluster_url为HTTPS时必填。
• token: 可选，Kubernetes Bearer Token。当cluster_url为HTTPS时，需提供token、token_path或admin_key/admin_cert中的一种。
• token_path: 可选，包含Kubernetes Bearer Token的文件路径。
• admin_key: 可选，Base64编码的PEM格式管理员私钥。
• admin_cert: 可选，Base64编码的PEM格式管理员证书。
• release: 可选，Helm Release名称（字符串），默认由Helm自动生成。
• namespace: 可选，Chart部署的Kubernetes命名空间，默认值为default。
• tillerless: 可选，是否启用无Tiller模式，默认值false。
• helm_init_server: 可选，是否自动安装Tiller到集群，默认值false（无Tiller模式不支持）。
• repos: 可选，Helm仓库列表，每个仓库需包含name、url（必填），以及可选的username和password。
• plugins: 可选，Helm插件列表，每个插件需包含url（必填）和可选的version。

行为（Behavior）

• check: 检查Release的新修订版本，需指定release和cluster_url。
• in: 不支持。
• out: 部署Helm Chart到集群，需提前安装Tiller（无Tiller模式除外）。

Out参数

• chart: 必填，Helm Chart文件（.tgz后缀）或Chart名称（如stable/mysql）。
• values: 可选，包含values.yaml配置的文件，支持数组形式的多文件。
• override_values: 可选，覆盖values.yaml的参数数组，支持直接值、文件路径、隐藏敏感信息等。
• delete: 可选，是否删除Release，默认值false。
• test: 可选，是否测试Release，默认值false。

部署示例

资源定义

yaml
resources:
- name: myapp-helm
  type: helm
  source:
    cluster_url: https://kube-master.example.com
    cluster_ca: _Base64编码的CA证书_
    admin_key: _Base64编码的管理员私钥_
    admin_cert: _Base64编码的管理员证书_
    repos:
      - name: my-repo
        url: https://my-charts.example.com

Job配置

yaml
jobs:
  - name: deploy-myapp
    plan:
    - get: source-repo
    - put: myapp-helm
      params:
        chart: source-repo/charts/myapp-0.1.0.tgz
        values: source-repo/values/prod.yaml
        override_values:
        - key: replicas
          value: 3
        - key: image.tag
          path: source-repo/version.txt
          type: string
        - key: secret.key
          value: ((my-secret-value))
          hide: true