如何通过Azure CLI在GitHub Actions中执行git fetch && git checkout并解决失效问题？

问题场景 #

现有如下GitHub Actions部署配置文件./github/workflows/staging-deploy.yml：

name: Deploy on Staging VM
on:
  pull_request:
    branches:
      - staging
    types:
      - closed

permissions:
      id-token: write
      contents: read
      
jobs: 
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
    - name: 'Az CLI login'
      uses: azure/login@v1
      with:
          creds: ${{ secrets.AZURE_CREDENTIALS }}
    - name: 'Run Azure CLI commands'
      run: |
          az vm run-command invoke -g rclco-app -n rclco-app-staging-vm --command-id RunShellScript --scripts "cd /app && git config --global --add safe.directory /app && git fetch && git checkout staging && sudo systemctl restart backend"

执行该Action时，GitHub显示执行成功，但Git拉取代码、重启服务的预期效果未实现。将脚本替换为--scripts "cd /app && mkdir testdir"时，/app/testdir可成功创建，且执行过程中提示$HOME未设置。

问题分析 #

1. Git全局配置依赖$HOME变量：git config --global命令需要读写用户主目录下的.gitconfig文件，当$HOME未设置时，该命令会静默失败，导致后续git fetch、git checkout无法正常执行。
2. 命令执行无日志反馈：原脚本未添加任何输出日志，无法定位具体哪一步出现问题，只能看到整体执行成功的提示。

解决方案 #

1. 手动设置$HOME并调整Git配置 #

修改Azure CLI执行的脚本，手动指定HOME路径，同时可以选择使用仓库级配置替代全局配置，避免依赖用户主目录：

az vm run-command invoke -g rclco-app -n rclco-app-staging-vm --command-id RunShellScript --scripts "export HOME=/root && cd /app && git config --add safe.directory /app && git fetch && git checkout staging && sudo systemctl restart backend"

• export HOME=/root：手动设置主目录为root用户的默认路径，确保git config --global能找到配置文件（如果仍需使用全局配置）
• git config --add：去掉--global，直接给当前仓库添加安全目录配置，无需依赖全局配置文件

2. 添加执行日志便于排查 #

在脚本中增加日志输出，明确每一步的执行状态，方便定位问题：

az vm run-command invoke -g rclco-app -n rclco-app-staging-vm --command-id RunShellScript --scripts "export HOME=/root && cd /app && echo '当前工作目录:'$(pwd) && git config --add safe.directory /app && echo 'Git安全目录配置完成' && git fetch && echo '远程代码拉取完成' && git checkout staging && echo '切换到staging分支完成' && sudo systemctl restart backend && echo 'Backend服务重启完成' && sudo systemctl status backend --no-pager"

通过echo输出每一步的结果，最后增加systemctl status命令，验证服务是否确实重启成功。

3. 验证仓库权限 #

确保/app目录及其下的Git仓库对执行命令的用户拥有足够权限，可在脚本开头添加权限检查：

--scripts "cd /app && echo '目录权限:'$(ls -ld /app) && echo '仓库权限:'$(ls -ld /app/.git) && export HOME=/root && git config --add safe.directory /app && git fetch && git checkout staging && sudo systemctl restart backend"

如果权限不足，可提前通过chown或chmod命令调整权限。

验证方法 #

修改脚本后重新触发GitHub Actions，查看执行日志：

• 若所有echo输出均正常显示，说明每一步命令执行成功
• 查看systemctl status的输出，确认服务状态为active (running)

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