如何让Bash脚本向GitLab流水线返回退出信号？

可以实现，问题出在你的Bash脚本没有正确将远程命令的失败状态传递给GitLab流水线。以下是问题分析和修复方案：

你的现有配置 #

GitLab流水线配置 #

install:
  stage: install
  
  script:
    - |
       echo "Dummy dry-run installation"
       chmod +x ./install-dry-run.sh
       ./install-dry-run.sh $SA_EMAIL $PROJECT_ID
  rules:
    - when: never

对应的Bash脚本 #

gcloud compute ssh ${instance_name} \
--quiet --tunnel-through-iap --zone=us-east4-c --ssh-key-expire-after=30s \
--project=${PROJECT_ID} \
--impersonate-service-account=${SA_EMAIL} \
--command="\
  if [ -f "/path/to/my/file.txt" ]; then echo 'Process successful'; else echo 'Process failed'; exit 1 > /dev/null; fi \
  " \
  -- -n

问题现象 #

当目标实例上的/path/to/my/file.txt不存在时，脚本会输出Process failed，但GitLab流水线并未标记为失败。

此前无效的尝试输出 #

Process failed
$ if [ $? -ne 0 ]; then # collapsed multi-line command
Installation successful

修复方案 #

1. 修正远程命令的退出逻辑 #

你脚本中的exit 1 > /dev/null完全多余（exit命令本身没有输出），更关键的是要确保gcloud compute ssh将远程命令的退出码作为自身的退出码返回（默认情况下gcloud会这么做，但要避免命令中的转义问题）。同时，让Bash脚本最终返回gcloud命令的退出码，确保GitLab能捕获到失败信号。

修改后的Bash脚本：

gcloud compute ssh ${instance_name} \
--quiet --tunnel-through-iap --zone=us-east4-c --ssh-key-expire-after=30s \
--project=${PROJECT_ID} \
--impersonate-service-account=${SA_EMAIL} \
--command="
  if [ -f \"/path/to/my/file.txt\" ]; then 
    echo 'Process successful'; 
  else 
    echo 'Process failed'; 
    exit 1; 
  fi
" \
-- -n

# 显式返回gcloud命令的退出码，确保脚本失败状态被传递
exit $?

2. 确保GitLab流水线捕获脚本退出码 #

GitLab流水线默认会根据脚本的退出码判断任务成功或失败，只要你的install-dry-run.sh返回非0值，流水线就会标记为失败。无需额外添加检查逻辑（如果之前的检查逻辑写得有问题，反而会覆盖正确的退出信号）。

原理说明 #

• gcloud compute ssh执行远程命令后，会将远程命令的退出码作为自己的退出码返回。
• Bash脚本的默认退出码是最后一条命令的退出码，显式添加exit $?可以明确传递这个状态。
• GitLab流水线会检查每个script步骤中命令的退出码，非0则标记该任务失败。

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