GitLab CI/CD流水线部署OpenShift时Helm命令无法执行的解决方法

核心原因 #

GitLab CI的每个script条目都是独立的shell会话，你第一个脚本块里修改的PATH不会传递到第二个块。另外，alpine/helm镜像的Helm可执行文件路径可能不在默认PATH范围内，导致shell找不到命令。

具体解决步骤 #

方法1：合并脚本块，确保环境变量持续生效 #

把PATH配置、OpenShift登录和Helm命令放在同一个脚本块里，让环境变量在整个执行流程中生效：

onboard-dev:
  stage: release
  tags: 
    - my-tag
  image:
    name: alpine/helm
    entrypoint: [""]
  script:
    - |
        # 自动查找镜像内Helm的路径
        HELM_PATH=$(which helm || find / -type f -name helm 2>/dev/null)
        if [ -z "$HELM_PATH" ]; then
          echo "镜像中未找到Helm可执行文件"
          exit 1
        fi
        # 将Helm所在目录加入系统路径
        PATH=$PATH:$(dirname "$HELM_PATH")
        # 登录OpenShift并切换项目
        oc login --token=$TOKEN  --insecure-skip-tls-verify=true --server=$MY_SERVER
        oc project dev
        # 执行Helm部署
        helm upgrade --install chart-name helm/charts --namespace dev

注：helm upgrade --install本身就包含了“不存在则安装，存在则升级”的逻辑，无需单独执行helm install。

方法2：直接使用Helm绝对路径执行 #

先在本地拉取镜像确认Helm的绝对路径：

docker run --rm alpine/helm which helm

假设输出为/usr/bin/helm，直接在CI脚本中用绝对路径调用：

onboard-dev:
  stage: release
  tags: 
    - my-tag
  image:
    name: alpine/helm
    entrypoint: [""]
  script:
    - |
        oc login --token=$TOKEN  --insecure-skip-tls-verify=true --server=$MY_SERVER
        oc project dev
    - |
        /usr/bin/helm upgrade --install chart-name helm/charts --namespace dev

方法3：更换官方维护的Helm镜像 #

改用官方helm/helm镜像，它的Helm可执行文件默认在系统PATH中，无需额外配置：

onboard-dev:
  stage: release
  tags: 
    - my-tag
  image:
    name: helm/helm:latest
    entrypoint: [""]
  script:
    - |
        oc login --token=$TOKEN  --insecure-skip-tls-verify=true --server=$MY_SERVER
        oc project dev
    - |
        helm upgrade --install chart-name helm/charts --namespace dev

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