GitLab CI/CD流水线Helm命令缺失问题及适配镜像咨询

问题概述 #

已完成GitLab CI/CD与Kubernetes集群的代理连接，当前流水线使用bitnami/kubectl:latest镜像可正常执行kubectl命令，但执行helm时提示helm: command not found。以下针对你的三个疑问逐一解答：

1. 存在同时支持kubectl与Helm的镜像吗？ #

当然有，这类预集成常用K8s工具的镜像可直接使用，省去手动安装步骤：

• bitnami/kubectl-helm：Bitnami官方维护的镜像，同时预装kubectl和Helm，版本匹配度高、稳定性好。
• alpine/k8s：轻量型Alpine镜像，包含kubectl、Helm、kustomize等多种K8s工具，适合追求镜像体积小的场景。
• 你也可以自行构建自定义镜像，比如基于bitnami/kubectl基础镜像，通过apk add helm或curl安装Helm，但使用现成镜像效率更高。

2. 如何在集群内执行这些Helm命令？ #

有两种主流方式：

• 直接在CI Runner镜像中执行：这是最常用的方式。只要CI镜像包含Helm，且已配置好K8s集群上下文（你当前已完成），就可以像执行kubectl一样直接运行helm命令，通过集群代理连接操作K8s集群。
• 通过Kubernetes Job执行：如果需要从集群内部视角执行命令（比如访问集群内部服务），可以在CI脚本中提交一个临时Job到K8s集群，Job使用包含Helm的镜像，执行完后自动销毁。示例Job YAML如下：

apiVersion: batch/v1
kind: Job
metadata:
  name: helm-deploy-kong
  namespace: kong
spec:
  template:
    spec:
      containers:
      - name: helm
        image: bitnami/kubectl-helm:latest
        command: ["helm", "upgrade", "--install", "kong", "kong/kong", "--namespace", "kong"]
      restartPolicy: Never
  backoffLimit: 4

在CI脚本中用kubectl apply -f job.yaml提交，再用kubectl wait job/helm-deploy-kong --for=condition=complete等待执行完成。

3. 能否在脚本中使用多个镜像？ #

可以，GitLab CI提供两种实现方式：

• 拆分多阶段Job：将需要不同工具的步骤拆分为独立Job，每个Job使用对应镜像。比如一个Job用bitnami/kubectl做集群状态验证，另一个Job用bitnami/kubectl-helm做Helm部署。示例配置：

verify-cluster:
  stage: deploy
  image: bitnami/kubectl:latest
  entrypoint: ['']
  script:
    - kubectl config use-context test-project/kong:kong-agent
    - kubectl get pods -n kong

deploy-kong:
  stage: deploy
  needs: [verify-cluster]
  environment: production
  image: bitnami/kubectl-helm:latest
  entrypoint: ['']
  script:
    - helm version
    - helm upgrade --install kong kong/kong --namespace kong

• Docker-in-Docker方式：如果Runner配置了Docker-in-Docker权限，可以在一个Job中通过docker run调用其他镜像执行命令，但这种方式复杂度高，需要额外配置，一般不推荐。

修改后的流水线示例 #

使用bitnami/kubectl-helm镜像替换原镜像，即可同时执行kubectl和Helm命令：

deploy-job:      
  stage: deploy  
  environment: production
  image:
    name: bitnami/kubectl-helm:latest
    entrypoint: ['']
  script:
    - echo "Deploying Kong application..."
    - kubectl config get-contexts
    - kubectl config use-context test-project/kong:kong-agent
    - kubectl get pods -n kong
    - helm version
    - helm upgrade --install kong kong/kong --namespace kong --create-namespace
    - echo "Kong successfully deployed."

内容的提问来源于stack exchange，提问作者lxodowd