如何让GitHub Actions在步骤日志含Error时强制标记失败？

问题描述 #

我有一个GitHub Actions任务，包含如下步骤：

- name: Deploy to EKS
  uses: tensor-hq/eksctl-helm-action@main
  with:
    eks_cluster: ${{ env.CLUSTER_NAME }}
    command: |-
       helm upgrade --install test a-super-chart -n test-ns --set somevalue=someValue 

当执行的helm命令出现异常时（比如空值或其他导致Helm安装/升级失败的情况），该步骤显示为成功，但日志中存在错误信息，例如：

Error: failed to parse .github/values_for_stg_alb_ingress.yaml: 
error converting YAML to JSON: yaml: invalid map key: map[interface {}]interface {}
{".Values.ingress.ingressClassName | default \"alb\"":interface {}(nil)}

请问是否有办法让此类场景下的工作流标记为失败？

解决方案 #

原因分析 #

出现这个问题的核心原因是tensor-hq/eksctl-helm-action这个第三方Action没有正确捕获Helm命令的退出状态码，导致即使Helm命令执行失败，Action仍返回成功状态，进而工作流不会标记为失败。

可行解决方法 #

方法1：改用直接run步骤执行Helm命令

GitHub Actions的run步骤会自动捕获命令的退出码，只要命令返回非0值，步骤就会标记为失败，进而终止工作流。示例配置如下：

- name: Deploy to EKS
  run: |
    # 确保已正确配置KUBECONFIG以访问EKS集群
    helm upgrade --install test a-super-chart -n test-ns --set somevalue=someValue
  env:
    # 如果需要通过eksctl获取kubeconfig，可提前添加步骤配置KUBECONFIG环境变量
    KUBECONFIG: ${{ steps.configure-kubeconfig.outputs.kubeconfig }}

方法2：在Action的命令中强制捕获失败状态

如果必须使用tensor-hq/eksctl-helm-action，可以在command中添加shell命令来强制捕获Helm的失败状态：

• 方式A：启用set -e，让脚本在任何命令失败时立即退出

- name: Deploy to EKS
  uses: tensor-hq/eksctl-helm-action@main
  with:
    eks_cluster: ${{ env.CLUSTER_NAME }}
    command: |-
       set -e
       helm upgrade --install test a-super-chart -n test-ns --set somevalue=someValue 

• 方式B：手动检查Helm命令的退出码，失败时主动退出

- name: Deploy to EKS
  uses: tensor-hq/eksctl-helm-action@main
  with:
    eks_cluster: ${{ env.CLUSTER_NAME }}
    command: |-
       helm upgrade --install test a-super-chart -n test-ns --set somevalue=someValue 
       if [ $? -ne 0 ]; then
         exit 1
       fi

总结 #

最可靠的方案是改用run步骤直接执行Helm命令，避免依赖第三方Action的退出码处理逻辑。如果坚持使用目标Action，添加set -e或手动检查退出码的方式可以有效让工作流在Helm命令失败时标记为失败。

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