ilyasotkov/concourse-helm-resource

Concourse的Helm资源

该镜像用于从Concourse CI/CD管道向通用Kubernetes集群（使用kubeconfig文件）或Google Kubernetes Engine（GKE）集群（使用GCP服务账户JSON密钥）部署https://github.com/kubernetes/helm。

与linkyard/concourse-helm-resource的区别

本资源是https://github.com/linkyard/concourse-helm-resource的增强分支，主要差异如下：

• 支持通过kubeconfig文件认证Kubernetes集群
• 支持通过gcloud_project、gcloud_cluster、gcloud_auth、gcloud_zone获取GKE集群凭证
• 使用原生Helm --wait标志判断任务状态（已合并https://github.com/linkyard/concourse-helm-resource/pull/7）
• 支持通过ca_cert、client_cert、client_key实现TLS认证的Tiller

组件版本

向管道添加资源类型

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

yaml
resource_types:
- name: helm
  type: docker-image
  source:
    repository: ilyasotkov/concourse-helm-resource
    tag: 1.1.1

源配置

认证方式

支持两种认证方式，二选一：

• kubeconfig方式（若不使用gcloud_auth则必填）：kubeconfig字段填写kubeconfig文件内容
• GCP服务账户方式（若不使用kubeconfig则必填）：
  • gcloud_project：GCP项目名称
  • gcloud_cluster：GKE集群名称
  • gcloud_zone：GCP集群所在计算区域
  • gcloud_auth：GCP JSON私钥文件内容

可选参数

• release：发布名称（字符串，非文件，默认由Helm自动生成）
• namespace：部署Helm chart的Kubernetes命名空间（默认：default）
• helm_init_server：是否在集群中安装Tiller（默认：false）
• tiller_namespace：Tiller运行（或安装）的命名空间（默认：kube-system）
• tiller_service_account：Tiller使用的服务账户名称（仅当helm_init_server为true时生效）
• repos：初始化的Helm仓库数组，每个仓库包含name和url属性
• ca_cert：验证Tiller服务器证书的CA证书
• client_cert：Helm认证Tiller的客户端证书
• client_key：Helm认证Tiller的私钥

行为

check：检查新发布版本

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

in：不支持

out：部署Helm chart

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

参数

• chart：必填，Helm chart文件（以.tgz结尾）或chart名称（如stable/mysql）
• release：可选，包含发布名称的文件（默认取自源配置）
• values：可选，包含values.yaml的文件，支持数组形式设置多个值文件
• override_values：可选，覆盖values.yaml的数组，每个条目包含：
  • key：值的键
  • value：直接设置的值，或path：读取文件内容作为值
  • hide: true：隐藏日志中的值（替换为***HIDDEN***）
• version：可选，部署的chart版本（仅当chart不是文件时生效）
• delete：可选，删除发布而非安装（需指定name，默认：false）
• purge：可选，删除发布时是否清理（需指定name，默认：false）
• replace：可选，替换同名已删除的发布（默认：false）
• devel：可选，允许安装开发版本chart（如1.0.2-rc1，默认：false）
• wait_until_ready：可选，等待资源就绪的秒数（默认：0，不等待）
• recreate_pods：可选，升级时重建所有pod（默认：false）

示例

完整示例管道：https://github.com/ilyasotkov/concourse-pipelines/blob/master/pipelines/gitlab-flow-semver.yml

Out操作示例

定义资源（kubeconfig方式）：

yaml
resources:
- name: helm-release
  type: helm
  source:
    kubeconfig: |
      apiVersion: v1
      kind: Config
      preferences: {}
      contexts:
      - context:
          cluster: development
          namespace: ramp
          user: developer
        name: dev-ramp-up
    repos:
      - name: some_repo
        url: https://somerepo.github.io/charts

定义资源（GKE方式）：

yaml
- name: helm-release
  type: helm
  source:
    gcloud_project: my-project-696969
    gcloud_cluster: k8s-cluster
    gcloud_zone: europe-west1
    gcloud_auth: |
      {
      "type": "service_account",
      "project_id": "XXX",
      "private_key_id": "XXX",
      "private_key": "XXX",
      "client_email": "XXX",
      "client_id": "XXX",
      "auth_uri": "XXX",
      "token_uri": "XXX",
      "auth_provider_x509_cert_url": "XXX",
      "client_x509_cert_url": "XXX"
      }
    ca_cert: ((helm-auth.ca))
    client_cert: ((helm-auth.cert))
    client_key: ((helm-auth.key))
    repos:
    - name: my-charts
      url: https://my-charts.github.io/charts

添加到任务：

yaml
jobs:
  # ...
  plan:
  - put: release-app
    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 # 在输出中隐藏值