syseleven/helm-operator

镜像概述

本镜像为Weaveworks Flux helm-operator的分支版本，专门针对HelmAddon自定义资源定义（CRD）进行优化，旨在通过Kubernetes CRD机制简化Helm图表的部署、更新与生命周期管理。它继承了Flux helm-operator的核心能力，并增强了对HelmAddon资源的支持，适用于需要通过声明式配置管理Helm应用的Kubernetes环境。

核心功能与特性

• HelmAddon CRD支持：通过自定义HelmAddon资源定义，以声明式方式配置和管理Helm图表
• 与Flux生态集成：兼容Flux的GitOps工作流，支持从Git仓库自动同步Helm配置
• 生命周期管理：自动化处理Helm发布的安装、升级、回滚及卸载操作
• 配置灵活性：支持自定义values配置、命名空间隔离及依赖管理
• 状态监控：提供Helm发布状态的实时反馈，便于问题排查与运维

使用场景与适用范围

• GitOps工作流：在基于Git的持续部署流程中，通过CRD声明Helm应用配置
• 多环境管理：针对开发、测试、生产等多环境，通过HelmAddon资源实现差异化配置
• 大规模集群部署：在包含多个微服务的Kubernetes集群中，集中管理Helm图表部署
• 自动化运维：减少手动操作，通过CRD变更触发Helm应用自动更新

使用方法

前提条件

• Kubernetes集群（1.16+）
• 已安装Helm 3+
• 已部署Flux（若使用GitOps功能）

部署步骤

1. 安装HelmAddon CRD

bash
kubectl apply -f https://raw.githubusercontent.com/[仓库地址]/master/config/crd/bases/helm.fluxcd.io_helmaddons.yaml

2. 部署镜像

使用kubectl部署

创建部署文件helm-operator-deployment.yaml：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: helm-operator
  namespace: flux
spec:
  replicas: 1
  selector:
    matchLabels:
      app: helm-operator
  template:
    metadata:
      labels:
        app: helm-operator
    spec:
      containers:
      - name: helm-operator
        image: [镜像名称]:[标签]
        args:
        - --watch-namespace=default
        - --log-level=info
        env:
        - name: HELM_VERSION
          value: "v3"
        - name: KUBECONFIG
          value: "/etc/kubernetes/kubeconfig"
        volumeMounts:
        - name: kubeconfig
          mountPath: /etc/kubernetes
          readOnly: true
      volumes:
      - name: kubeconfig
        secret:
          secretName: kubeconfig

应用部署：

bash
kubectl apply -f helm-operator-deployment.yaml -n flux

3. 创建HelmAddon资源示例

创建example-helmaddon.yaml：

yaml
apiVersion: helm.fluxcd.io/v1
kind: HelmAddon
metadata:
  name: nginx-ingress
  namespace: default
spec:
  chart:
    repository: https://kubernetes.github.io/ingress-nginx
    name: ingress-nginx
    version: 4.0.10
  values:
    controller:
      replicaCount: 2
      service:
        type: LoadBalancer

应用资源：

bash
kubectl apply -f example-helmaddon.yaml

验证部署

检查HelmAddon状态：

bash
kubectl get helmaddons -o wide

检查Helm发布状态：

bash
helm list -n default

配置参数

环境变量

命令行参数