GitHub Actions部署Helm Chart到DigitalOcean集群：kubeconfig无效问题

解决方案 #

这个报错的核心是kubeconfig文件格式异常，无法被Kubernetes工具正确解析为合法的YAML/JSON结构，大概率和doctl kubernetes cluster kubeconfig save的执行逻辑或后续kubeconfig的处理有关，以下是可行的解决步骤：

• 检查kubeconfig的有效性与权限
  在save kubeconfig步骤后添加调试命令，确认文件内容是否为合法配置，同时修正过松的文件权限：

  - name: Debug kubeconfig
    run: |
      cat /home/runner/.kube/config
      ls -l /home/runner/.kube/config
      chmod 600 /home/runner/.kube/config
  

• 移除Helm Action的kubeconfig覆盖参数
  WyriHaximus/github-action-helm3的overrule_existing_kubeconfig参数可能会错误替换或损坏原有kubeconfig，尝试移除该参数及指定的kubeconfig路径，让Helm使用默认路径的配置：

  - name: Deploy to staging
    uses: WyriHaximus/github-action-helm3@v3
    with:
      exec: helm upgrade --install app helm/ -f $GITHUB_WORKSPACE/charts/VALUES_LOCATION.yaml --set image.tag=$(echo $GITHUB_SHA | head -c7) --namespace app
  

• 改用直接导出kubeconfig的方式
  替换doctl kubernetes cluster kubeconfig save为直接导出配置到文件，避免默认路径下的文件合并冲突：

  - name: Export DigitalOcean kubeconfig
    run: doctl kubernetes cluster kubeconfig show --expiry-seconds 1200 cluster-name > /home/runner/.kube/config
  

• 提前验证集群连接
  在部署步骤前添加kubectl验证命令，确认kubeconfig可以正常连接集群：

  - name: Verify cluster connection
    run: kubectl cluster-info
  

  如果这一步也报错，需要检查cluster-name是否正确，或者DigitalOcean access token是否拥有集群的访问权限。

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