GitHub Actions执行Bicep部署时出现间歇性文件缺失错误求助

在GitHub Actions中执行Bicep部署时，间歇性出现以下错误：

No such file or directory: '/home/runner/.azure/bin/bicep'

已在部署步骤中添加az bicep install命令，但问题仍间歇性出现，且YAML配置未做任何修改。相关部署代码块如下：

- name: Deploy Bicep
  env:
    AZURE_SUBSCRIPTION: ${{ secrets.AZURE_SUBSCRIPTION }}
  run: |
    az bicep install
    az stack sub create \
      --name deploy-stack-prod-usva \
      --location usgovvirginia \
      --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam

• 确保PATH包含Bicep安装路径
  az bicep install会将Bicep安装到/home/runner/.azure/bin，但该目录可能未被加入当前shell的PATH，导致后续az命令无法找到可执行文件。可以在安装后显式添加路径：

  az bicep install
  export PATH="$HOME/.azure/bin:$PATH"
  az stack sub create \
    --name deploy-stack-prod-usva \
    --location usgovvirginia \
    --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam
  

  或者直接在部署命令中指定Bicep的绝对路径：

  az bicep install
  az stack sub create \
    --name deploy-stack-prod-usva \
    --location usgovvirginia \
    --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam \
    --bicep-path /home/runner/.azure/bin/bicep
  

• 添加安装后验证步骤
  间歇性问题可能源于az bicep install偶尔执行不完整，可在安装后检查文件是否存在，确保后续命令仅在验证通过后执行：

  az bicep install
  if [ ! -f "/home/runner/.azure/bin/bicep" ]; then
    echo "Bicep binary not found after install, exiting"
    exit 1
  fi
  az stack sub create \
    --name deploy-stack-prod-usva \
    --location usgovvirginia \
    --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam
  

• 改用官方Azure CLI登录动作
  GitHub Actions官方的azure/login动作会自动配置Azure环境，部分版本已预安装Bicep，或能更稳定处理路径问题。先完成登录再执行部署：

  - name: Azure Login
    uses: azure/login@v1
    with:
      creds: ${{ secrets.AZURE_CREDENTIALS }}
      subscription-id: ${{ secrets.AZURE_SUBSCRIPTION }}
  
  - name: Install Bicep and Deploy
    run: |
      az bicep install
      az stack sub create \
        --name deploy-stack-prod-usva \
        --location usgovvirginia \
        --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam
  

• 清理旧文件后重新安装
  缓存的Bicep文件可能损坏，可在安装前删除旧文件避免冲突：

  rm -f /home/runner/.azure/bin/bicep || true
  az bicep install
  az stack sub create \
    --name deploy-stack-prod-usva \
    --location usgovvirginia \
    --parameters $GITHUB_WORKSPACE/bicep/parameters/main.bicepparam
  

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