az vm run-command在GitHub Actions中运行异常 无法获取正确退出码

• az vm run-command invoke 默认返回的$?是Azure CLI进程自身的退出码：只要CLI成功和Azure平台通信、拿到了VM返回的执行结果载荷，无论VM内部运行的脚本是成功还是失败，CLI都会返回0。你之前直接取$?拿不到脚本真实退出码是产品设计行为，不是故障。
• 管道拼接grep触发node报错的原因：当grep没有匹配到目标内容时，grep会返回非0退出码，GitHub Actions托管runner预装的Azure CLI版本比Azure Cloud Shell的版本旧，存在未处理的Promise rejection缺陷——管道下游命令返回非0状态时，会直接触发CLI进程抛出你看到的node运行时错误，和VM内的脚本执行是否成功没有关系。Cloud Shell中CLI始终保持最新版本，该缺陷已经被修复，因此相同命令可以正常运行。

优先选择避开管道解析的方案，稳定性最高，完全适配GitHub Actions流水线场景：

1. 先将run-command的完整JSON输出存入变量，不直接拼接管道，从根源上避免触发旧版CLI的bug
2. 先校验CLI自身的执行状态，排除鉴权失败、资源不存在、网络不通这类平台侧错误
3. 从JSON结果中提取VM内部脚本的真实退出码、标准输出、标准错误内容，再做业务逻辑判断（比如你需要的nodetool关键字匹配）

可直接复用的流水线脚本片段：

# 执行run-command，暂存完整输出
run_result=$(az vm run-command invoke \
  -g myRG \
  -n myVM \
  --command-id RunShellScript \
  --scripts "/home/azureuser/cassandra-script.sh" \
  -o json)
cli_exit_code=$?

# 校验CLI调用是否正常
if [ $cli_exit_code -ne 0 ]; then
  echo "Azure CLI调用run-command失败，错误输出："
  echo "$run_result"
  exit 1
fi

# 解析VM侧脚本执行结果
provision_state=$(echo "$run_result" | jq -r '.value[0].code')
script_detail=$(echo "$run_result" | jq -r '.value[0].message | fromjson')
script_exit_code=$(echo "$script_detail" | jq -r '.exitCode')
script_stdout=$(echo "$script_detail" | jq -r '.stdout')
script_stderr=$(echo "$script_detail" | jq -r '.stderr')

# 输出调试信息
echo "=== 脚本执行信息 ==="
echo "资源预配状态: $provision_state"
echo "脚本退出码: $script_exit_code"
echo "标准输出:"
echo "$script_stdout"
echo "标准错误:"
echo "$script_stderr"

# 自定义业务判断：匹配nodetool关键字
if ! echo "$script_stdout" | grep -q "nodetool"; then
  echo "错误：输出中未匹配到nodetool关键字"
  exit 1
fi

# 最终判断脚本是否执行成功
if [ "$provision_state" != "ProvisioningState/succeeded" ] || [ $script_exit_code -ne 0 ]; then
  echo "VM内脚本执行失败"
  exit 1
fi

如果不想做JSON解析，也可以先在流水线步骤中升级Azure CLI到最新版，对齐Cloud Shell的运行环境，修复管道触发的Promise报错：

# 升级Azure CLI到最新版（适用于Ubuntu类GitHub Runner）
az upgrade --yes --all

注意：即使升级CLI版本，$?依然只会返回CLI进程自身的退出码，不会返回VM内部脚本的退出码，仍然需要从命令输出中提取脚本的真实执行状态，不能直接靠$?判断脚本成功或失败。不建议长期使用管道拼接grep的判断方式，grep无匹配时返回的非0退出码很容易和真实的命令执行错误混淆，提升排查成本。

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