GitHub Actions中az functionapp部署命令异常排查求助

核心问题分析 #

1. azure/CLI@v1动作平台限制：该动作的v1版本强制要求使用Linux runner，这是日志中Error: Please use Linux based OS as a runner.的直接原因，导致部署脚本无法在Windows runner上正常执行。
2. Windows环境下zip命令不兼容：你使用的是Linux风格的zip -r命令，但Windows自带的zip工具语法完全不同，会导致压缩失败，进而中断部署流程。
3. 环境变量引用潜在问题：Windows runner脚本中环境变量的引用逻辑与Linux存在差异，若处理不当会引发参数传递错误。

具体修复方案 #

方案1：切换到Linux Runner部署（推荐） #

即便你的Function App是Windows环境，部署操作本身是跨平台的。使用Linux runner可彻底规避Windows与Linux脚本的兼容性问题，修改如下：

deployFunction:
    runs-on: ubuntu-latest
    needs: buildFunction
    steps:
    - name: Download artifact from build job
      uses: actions/download-artifact@v3
      with:
        name: functionapp
        path: ${{ env.AZURE_FUNCTIONAPP_PACKAGE_PATH }}
    - name: Azure Login
      uses: azure/CLI@v1
      with:
        azcliversion: 2.47.0
        inlineScript: |
          az login --service-principal \
          -u ${{ secrets.DEPLOYMENT_AZURE_CLIENT_ID }} \
          -p ${{ secrets.DEPLOYMENT_AZURE_CLIENT_SECRET }} \
          -t ${{ secrets.DEPLOYMENT_AZURE_TENANT_ID }}
    - name: Deploy to Azure Function
      uses: azure/CLI@v1
      with:
        azcliversion: 2.47.0
        inlineScript: |
          zip -r functionapp.zip .
          groupName=${{ env.AZURE_GROUP_NAME }}
          az functionapp deployment source config-zip -g $groupName -n ${{env.AZURE_FUNCTION_NAME}} --src functionapp.zip

方案2：坚持使用Windows Runner的修复步骤 #

若必须使用Windows runner，需替换不兼容的命令与动作：

1. 替换登录动作：用支持Windows的azure/login替代azure/CLI@v1完成服务主体登录：

- name: Azure Login
  uses: azure/login@v1
  with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}

需提前在GitHub Secrets中创建AZURE_CREDENTIALS，格式为包含clientId、clientSecret、tenantId、subscriptionId的JSON字符串。

2. 替换压缩命令：用PowerShell原生命令完成压缩：

- name: Deploy to Azure Function
  shell: pwsh
  run: |
    Compress-Archive -Path .\* -DestinationPath functionapp.zip -Force
    $groupName = "${{ env.AZURE_GROUP_NAME }}"
    az functionapp deployment source config-zip -g $groupName -n "${{env.AZURE_FUNCTION_NAME}}" --src functionapp.zip

3. 规范环境变量引用：在PowerShell脚本中用"${{ env.VAR_NAME }}"格式引用GitHub Actions环境变量，避免语法错误。

额外验证步骤 #

• 部署完成后，查看Azure Function App的部署中心日志，确认部署记录及具体错误信息。
• 可在GitHub Actions中添加步骤打印压缩包内容，验证functionapp.zip是否包含所有发布后的函数文件。

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