linkyard/concourse-helm-resource

Concourse的Helm资源

从Concourse部署到https://github.com/kubernetes/helm%E3%80%82

安装

将资源类型添加到您的管道：

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

源配置

• cluster_url: 可选。Kubernetes Master API服务的URL。使用kubeconfig_path参数时不要设置，否则为必填项。
• 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）
• tillerless: 可选。设为true以使用无Tiller模式（默认：false）。参见<[***]>。
• helm_init_server: 可选。如果集群中尚未安装helm，则安装helm。（默认：false）。使用无Tiller模式时不支持。
• tiller_namespace: 可选。Tiller运行（或将要安装到）的Kubernetes命名空间。（默认：kube-system）
• tiller_cert: 可选。Tiller的证书（仅在tls_enabled和helm_init_server为true时适用）。
• tiller_key: 可选。安全安装Tiller时为Tiller创建的密钥（仅在tls_enabled和helm_init_server为true时适用）。
• tiller_service_account: 可选。Tiller将使用的服务账户名称（仅在helm_init_server为true时适用）。
• helm_ca: 可选。用于为Tiller客户端和服务器颁发证书的私有CA（仅在tls_enabled为true时适用）。
• helm_cert: 可选。客户端证书（仅在tls_enabled为true时适用）。
• helm_key: 可选。安全安装Tiller时为客户端创建的密钥（仅在tls_enabled为true时适用）。
• tls_enabled: 可选。对所有与Tiller的交互使用TLS。（默认：false）。使用无Tiller模式时不支持。
• helm_history_max: 可选。限制修订的最大数量。（默认：0 = 无限制）
• helm_host: 可选。Tiller的地址。跳过helm发现过程。（仅在helm_init_server为false时适用）。
• repos: 可选。要初始化的Helm仓库数组，每个仓库定义为包含name、url（必填）、username和password（可选）属性的对象。
• plugins: 可选。要安装的Helm插件数组，每个定义为包含url（必填）、version（可选）属性的对象。
• stable_repo: 可选。覆盖默认的Helm稳定仓库<[***]>。在无互联网访问环境中运行helm部署时很有用。
• kubeconfig_namespace: 可选。将kubeconfig上下文命名空间用作helm命名空间。（默认：false）
• kubeconfig_tiller_namespace: 可选。将kubeconfig上下文命名空间用作tiller命名空间。（默认：false）
• tracing_enabled: 可选。为此资源启用极详细的跟踪。在开发资源本身时有用。可能会显示机密信息。（默认：false）
• helm_init_wait: 可选。初始化helm服务器时，使用--wait选项。（默认：false）
• helm_setup_purge_all: 可选。删除并清除所有helm发布。请谨慎使用。（默认：false）

行为

check: 检查新发布

返回发布的任何新修订版，无论其当前状态如何。要使check工作，源中必须指定发布和集群URL。

in: 不支持

out: 部署helm chart

将Helm chart部署到Kubernetes集群。集群上必须已安装Tiller。

参数

• chart: 必填。包含要部署的helm chart的文件（以.tgz结尾）或chart名称（例如stable/mysql）。
• namespace: 可选。包含命名空间名称的文件或命名空间名称。（默认：取自源配置）。
• release: 可选。包含发布名称的文件或发布名称。（默认：取自源配置）。
• values: 可选。包含部署的values.yaml的文件。支持使用数组设置多个值文件。
• override_values: 可选。可覆盖values.yaml中定义的值的数组。数组中的每个条目是一个包含key和value或path的映射。Value直接设置，而path读取该路径下文件的内容。hide: true参数确保值不被记录，而是替换为***HIDDEN***。type: string参数确保Helm始终将值视为字符串（使用Helm的--set-string选项；当值变化且可能看起来像数字时很有用，例如Git提交哈希）。
• token_path: 可选。包含Kubernetes Bearer令牌的文件路径。如果cluster_url为https，则此参数、token或admin_key/admin_cert为必填项。
• version: 可选。要部署的chart版本，可以是文件或值。仅当chart不是文件时适用。
• delete: 可选。删除发布而不是安装它。需要name。（默认：false）
• test: 可选。测试发布而不是安装它。需要release。（默认：false）
• purge: 可选。删除时清除发布。（默认：false）
• replace: 可选。用相同名称替换已删除的发布。（默认：false）
• force: 可选。必要时通过删除/重新创建强制资源更新。（默认：false）
• devel: 可选。允许安装chart的开发版本。在想要安装预发布chart（即1.0.2-rc1）而无需指定版本时很有用。（默认：false）
• debug: 可选。使用debug标志 dry run helm安装，记录插值后的chart模板。（默认：false）
• wait_until_ready: 可选。设置等待chart中所有资源就绪的秒数。（默认：0表示不等待）。
• check_is_ready: 可选。要求wait_until_ready设为默认值。应用--wait且无超时。（默认：false）
• recreate_pods: 可选。升级时将导致所有pod重新创建。（默认：false）
• show_diff: 可选。显示升级现有成功发布时应用的差异。设置devel时不使用。（默认：false）
• exit_after_diff: 可选。显示差异但不实际安装/升级。（默认：false）
• reuse_values: 可选。升级时，重用上次发布的值。（默认：false）
• wait: 可选。允许部署任务在继续下一个任务前休眠X秒。允许pod重启并变得稳定，在pod之间存在依赖关系时很有用。（默认：0）
• kubeconfig_path: 可选。包含kubeconfig的文件。覆盖集群、令牌和管理员配置的源配置。

示例

Out

定义资源：

yaml
resources:
- name: myapp-helm
  type: helm
  source:
    cluster_url: https://kube-master.domain.example
    cluster_ca: _base64编码的CA pem_
    admin_key: _base64编码的key pem_
    admin_cert: _base64编码的certificate 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 # 在输出中隐藏值
      - key: image.tag
        path: version/image_tag # 从version/number读取值
        type: string            # 确保Helm将其解释为字符串（而非数字）