mnsplatform/concourse-helm-resource

Kubernetes Helm资源镜像

本镜像为Concourse的资源类型，用于在https://kubernetes.io/集群上部署https://helm.sh/ Charts。

注意：需要在集群上安装https://docs.helm.sh/using_helm/#installing-tiller。

每个镜像标签对应容器内安装的Helm版本。

源配置（Source Configuration）

• cluster_url：必填。指向集群API服务器的地址，例如https://api.<your-domain>.com。注意：协议必须为HTTPS。
• cluster_ca：必填。Base64编码的PEM证书。
• token：可选。Bearer令牌。若未提供admin_cert则必填。
• admin_cert：可选。Base64编码的PEM证书。若未提供token则必填。
• admin_key：若指定admin_cert则必填。Base64编码的PEM密钥。
• namespace：必填。Chart安装的目标命名空间。
• release_name：必填。发布名称。注意：修改此值将创建新发布，旧发布不会被删除。

行为（Behaviour）

check：未实现

本资源主要用于部署，获取新版本无明显优势。

in：未实现

out：部署Helm Chart

使用Helm部署Chart，每次部署生成同一发布的新版本。

参数（Parameters）

• chart_dir：必填。包含Helm Chart的目录路径。
• set_values：可选。覆盖values.yaml中的值。示例：

  yaml
  set_values:
    key1: value1
  

• values_from_files：可选。从指定文件读取值覆盖values.yaml，适用于与https://github.com/concourse/semver-resource结合。示例：

  yaml
  # 用semver资源构建推送镜像
  values_from_files:
    docker_image_version: semver/version
  

• dry_run：可选。模拟安装，默认false。
• recreate_pods：可选。强制重建Pod，默认false。
• force：可选。必要时强制更新（删除/重建），默认false。
• wait_until_ready：可选。等待资源就绪后标记发布成功，默认false。
• timeout：可选。仅wait_until_ready生效，超时时间（秒），默认300。
• debug：可选。启用Helm调试，默认false。

示例

假设Helm Chart位于Git仓库的helm目录：

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

resources:
- name: helm
  type: helm
  source:
    cluster_url: # 集群API地址
    cluster_ca: # Base64编码的CA证书
    token: # Bearer令牌
    namespace: # 目标命名空间
    release_name: # 发布名称

- name: git-resource
  type: git
  source: # Git仓库配置

jobs:
- name: deploy-helm
  plan:
  - get: git-resource
  - put: helm
    params:
      chart_dir: repo/helm
      # 其他参数

致谢

本资源基于https://github.com/linkyard/concourse-helm-resource开发。