ventx/helm3-ci

helm3-ci

用于Helm Charts持续集成（CI） 流水线的多架构镜像，集成各类工具和插件。

Docker Hub

https://hub.docker.com/r/ventx/helm3-ci

镜像信息

• 操作系统：Ubuntu
• 版本：22.04 LTS ("Jammy")

支持架构

• linux/amd64
• linux/arm64

安装的系统包（apt）

• ca-certificates
• curl
• git
• gnupg
• jq
• make
• openssh-client
• python3-pip
• tzdata
• wget

安装的Go二进制工具

• https://github.com/helm/chart-testing
• helm
• https://github.com/norwoodj/helm-docs
• kubeval
• https://github.com/kubernetes/kubectl
• https://github.com/kubernetes-sigs/kustomize
• https://github.com/mikefarah/yq

安装的Python3包（pip）

• yamale
• yamllint

Helm插件

• https://github.com/jkroepke/helm-secrets
• https://github.com/helm-unittest/helm-unittest

核心功能与特性

1. 全面工具链集成：整合Helm3及周边生态工具，覆盖从Chart lint、测试到部署验证的全流程需求
2. 多架构支持：同时支持amd64和arm64架构，适配不同硬件环境
3. CI友好设计：预装Git、SSH客户端等CI必备组件，可直接集成到各类CI/CD系统（Jenkins、GitLab CI、GitHub Actions等）
4. 配置验证能力：通过kubeval、yamllint等工具提供YAML/Kubernetes配置验证
5. 文档自动化：集成helm-docs实现Chart文档自动生成

使用场景

• Helm Chart语法检查与 lint
• Chart单元测试（通过helm-unittest）
• Kubernetes配置文件验证（通过kubeval）
• Helm Chart文档自动生成（通过helm-docs）
• 加密Helm Secrets管理（通过helm-secrets）

使用方法

基础使用

查看Helm版本：

bash
docker run --rm ventx/helm3-ci:2.5.0 helm version

运行Chart测试：

bash
docker run --rm -v $(pwd):/charts ventx/helm3-ci:2.5.0 ct lint --charts /charts/my-chart

在CI流程中集成（以GitHub Actions为例）

yaml
name: Helm CI
on: [push]

jobs:
  helm-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Helm lint and test
        uses: docker://ventx/helm3-ci:2.5.0
        with:
          args: |
            helm repo add stable [***]
            helm lint ./charts/my-chart
            helm-docs -d ./charts/my-chart
            kubeval ./charts/my-chart/templates/*.yaml