sk88ks/concourse-helm-resource

Concourse的Helm资源

从Concourse CI向Kubernetes Helm部署应用。

安装

将资源类型添加到你的流水线：

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

源配置

• cluster_url：必填。Kubernetes主节点API服务的URL。
• cluster_ca：可选。Base64编码的PEM证书。如果cluster_url是https则必填。
• token：可选。Kubernetes的Bearer令牌。如果cluster_url是https，此参数、token_path或admin_key/admin_cert三者之一必填。
• token_path：可选。包含Kubernetes Bearer令牌的文件路径。如果cluster_url是https，此参数、token或admin_key/admin_cert三者之一必填。
• admin_key：可选。Base64编码的PEM密钥。如果cluster_url是https且未提供token或token_path则必填。
• admin_cert：可选。Base64编码的PEM证书。如果cluster_url是https且未提供token或token_path则必填。
• release：可选。发布名称（字符串，非文件）。默认由Helm自动生成。
• namespace：可选。Chart将安装到的Kubernetes命名空间。默认是default。
• helm_init_server：可选。如果集群中未安装Helm则自动安装。默认false。
• tiller_namespace：可选。Tiller运行（或将要安装到）的Kubernetes命名空间。默认kube-system。
• tiller_service_account：可选。Tiller使用的服务账户名称（仅当helm_init_server为true时生效）。
• repos：可选。要初始化的Helm仓库数组，每个仓库是包含name和url属性的对象。

行为

check：检查新发布版本

返回该发布的所有新修订版本，无论其当前状态如何。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的映射：value直接设置值，path读取指定路径文件的内容；hide: true参数确保值不被日志记录，替换为***HIDDEN***。
• version：可选。要部署的Chart版本。仅当chart不是文件时生效。
• delete：可选。删除发布而非安装。需要指定name。默认false。
• purge：可选。当delete为true时清除发布。需要指定name。默认false。
• replace：可选。用相同名称替换已删除的发布。默认false。
• devel：可选。允许安装Chart的开发版本，适用于安装预发布Chart（如1.0.2-rc1）而无需指定版本。默认false。
• wait_until_ready：可选。设置等待Chart中所有资源就绪的秒数。默认0（不等待）。
• recreate_pods：可选。升级时重建所有Pod。默认false。

示例

Out

定义资源：

yaml
resources:
- name: myapp-helm
  type: helm
  source:
    cluster_url: https://kube-master.domain.example
    cluster_ca: _base64编码的CA pem_
    admin_key: _base64编码的密钥pem_
    admin_cert: _base64编码的证书pem_
    repos:
      - name: some_repo
        url: https://somerepo.github.io/charts

添加到任务：

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: version
        path: version/number # 从version/number读取值
      - key: secret
        value: ((my-top-secret-value)) # 从Vault等凭据后端获取
        hide: true # 在输出中隐藏值