awachowski/concourse-helm3-resource

Concourse Helm3资源镜像

镜像概述

本镜像为Concourse CI的Helm3资源工具，用于在Concourse流水线中部署Helm Chart（仅支持Helm3版本）。基于linkyard/concourse-helm-resource的工作，支持连接Kubernetes集群（包括AWS EKS），可配置Helm仓库、插件及自定义部署参数。

核心功能

• 部署/删除Helm Chart到Kubernetes集群
• 支持Kubernetes集群的多种认证方式（token、证书、AWS IAM认证等）
• 配置自定义Helm仓库及插件
• 覆盖Chart的values参数（支持文件、直接值、隐藏敏感信息等）
• 支持AWS EKS集群的IAM角色假设及kubeconfig自动生成

使用场景

• Concourse CI流水线中的Helm Chart持续部署
• Kubernetes应用的自动化发布与更新
• AWS EKS集群上的应用部署与管理
• 需要自定义Helm配置的CI/CD流程

配置说明

Resource Type定义

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

Source Configuration

基础配置

• cluster_url: Kubernetes Master API地址（使用kubeconfig_path时无需设置）
• cluster_ca: 集群CA证书PEM（Base64编码可选，insecure_cluster为false时必填）
• insecure_cluster: 跳过TLS验证（cluster_ca为空时必填）
• token/token_path: Kubernetes Bearer Token（HTTPS集群时必填，二选一）
• admin_key/admin_cert: 管理员证书PEM（Base64编码，HTTPS集群且无token时必填）
• release: Helm release名称（默认自动生成）
• namespace: 部署的Kubernetes命名空间（默认default）
• repos: Helm仓库列表（每个仓库需包含name和url，可选username/password）
• plugins: Helm插件列表（每个插件需包含url，可选version）

AWS EKS配置

• use_aws_iam_authenticator: 启用AWS IAM认证（连接EKS时使用）
• assume_aws_role: 假设AWS IAM角色（启用IAM认证时可选）
• aws_region: AWS区域（默认us-east-1，启用IAM认证或角色假设时必填）
• aws_eks_cluster_name: EKS集群名称（启用IAM认证或use_awscli_eks_auth时必填）
• use_awscli_eks_auth: 使用AWS CLI生成kubeconfig（无需手动配置cluster_url和cluster_ca）

Behavior

• check: 检查Helm release状态（不支持动态release）
• in: 不支持
• out: 部署Helm Chart（仅Helm3）

Out参数说明

• chart: 必填，Helm Chart文件（.tgz）、本地目录或仓库中的Chart名称
• namespace: 部署命名空间（默认取source配置）
• create_namespace: 自动创建命名空间（默认false）
• release: release名称（默认取source配置）
• values: values.yaml文件（支持数组）
• override_values: 覆盖values的参数（支持直接值、文件路径、隐藏敏感信息等）
• test: 测试release（需指定release，默认false）
• delete: 删除release（需指定release，默认false）
• kubeconfig_path: kubeconfig文件路径（覆盖source中的集群配置）

部署示例

基础Kubernetes集群部署

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_admin_key"
    admin_cert: "base64_encoded_admin_cert"
    repos:
      - name: my_repo
        url: https://my-repo.github.io/charts

jobs:
- name: deploy-myapp
  plan:
  - get: source-repo
    trigger: true
  - 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: secret.key
          value: ((my_secret))
          hide: true

AWS EKS集群部署

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

resources:
- name: fluentd-chart
  type: helm
  source:
    use_awscli_eks_auth: "true"
    aws_eks_cluster_name: my-eks-cluster
    assume_aws_role: "arn:aws:iam::***:role/eks-deploy-role"
    aws_region: "cn-north-1"
    repos:
      - name: fluentd
        url: https://fluent.github.io/helm-charts
    namespace: kube-system
    release: fluentd

jobs:
- name: deploy-fluentd
  plan:
  - get: values
    trigger: true
  - put: fluentd-chart
    params:
      chart: fluentd/fluentd-cloudwatch
      values: values/fluentd-values.yaml
      recreate_pods: true