zoranjurc/kubernetes-resource

Concourse Helm部署资源镜像

镜像概述

该镜像提供Concourse CI/CD平台的资源类型，专门用于在Concourse管道中集成Helm包管理器的部署流程。通过此资源，用户可将Helm图表的部署、版本更新、回滚等操作自动化，实现Kubernetes应用的持续部署。

核心功能和特性

• Helm操作集成：支持Helm图表的部署（install）、更新（upgrade）、回滚（rollback）及卸载（uninstall）操作
• 版本控制：可指定Helm图表版本，确保部署版本一致性
• 配置自定义：支持通过values文件或参数覆盖图表默认配置
• 状态反馈：返回部署操作结果及状态信息，便于Concourse管道流程控制
• Kubernetes集成：自动处理与Kubernetes集群的认证和连接

使用场景

• 需通过Concourse管道自动化Kubernetes应用部署的团队
• 需要标准化Helm图表部署流程的CI/CD环境
• 要求支持版本回滚和部署状态跟踪的持续部署场景
• 多环境（开发、测试、生产）的Helm部署管理

使用方法

资源配置

在Concourse pipeline配置中，需将该资源定义为resource_types，并配置具体资源实例。

资源类型定义

yaml
resource_types:
- name: helm-resource
  type: docker-image
  source:
    repository: <该镜像仓库地址>
    tag: <镜像版本>

资源实例配置

yaml
resources:
- name: my-helm-deployment
  type: helm-resource
  source:
    # Helm仓库配置
    helm_repo: https://charts.example.com/
    chart_name: my-app
    chart_version: 1.2.3  # 可选，不指定则使用最新版本
    # Kubernetes集群配置（根据集群访问方式选择）
    kubeconfig: ((kubeconfig))  # 包含Kubernetes集群认证信息的secret
    # 或使用集群内访问配置（适用于Concourse部署在目标K8s集群内的场景）
    # in_cluster: true

示例Pipeline配置

以下为使用该资源进行Helm部署的Concourse job示例：

yaml
jobs:
- name: deploy-app
  plan:
  - get: source-code
    trigger: true
  - task: build-values
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine, tag: latest}
      inputs:
      - name: source-code
      outputs:
      - name: values-files
      run:
        path: sh
        args:
        - -c
        - |
          # 生成或修改values文件
          cp source-code/values-prod.yaml values-files/values.yaml
  - put: my-helm-deployment
    params:
      action: upgrade  # 可选值：install, upgrade, rollback, uninstall
      release_name: my-app-prod
      namespace: production
      values: values-files/values.yaml  # 自定义配置文件路径
      # 回滚操作需指定版本
      # rollback_version: 2

参数说明

Source参数

Params参数

环境变量说明