无法通过Azure从GitHub仓库配置CI/CD的问题求助

问题概述 #

通过Azure门户部署中心配置GitHub Actions CI/CD时，无法提交YML工作流文件；手动提交YML则出现身份验证问题，门户提示：

Basic authentication is disabled for your app.

但已确认App Service的基础身份验证处于启用状态，环境为Linux系统的Free (F1) App Service Plan（名称ASP-intrinsicrg-a16e）。

解决步骤 #

• 检查部署凭据配置
  进入Azure门户目标App Service资源，导航至「部署中心」>「凭据」，确认已设置独立的部署用户名和部署密码（此凭据与Azure门户登录凭据不同），未设置则手动配置新凭据。

• 验证GitHub Actions密钥与工作流

  1. 在Azure门户App Service的「概述」页点击「获取发布配置文件」，下载完整配置文件；
  2. 进入GitHub仓库的「Settings」>「Secrets and variables」>「Actions」，添加名为AZURE_WEBAPP_PUBLISH_PROFILE的密钥，值为发布配置文件的全部内容；
  3. 确保YML工作流的部署步骤引用正确密钥，示例片段：

     - name: Deploy to Azure Web App
       uses: azure/webapps-deploy@v2
       with:
         app-name: '<你的App Service名称>'
         publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
         package: .
     

• 重置基础身份验证状态
  即使显示已启用，仍尝试刷新配置：

  1. 进入App Service>「配置」>「常规设置」，将「基础身份验证」设为「禁用」并保存；
  2. 等待1-2分钟后，重新设为「启用」并保存，解决门户状态不同步问题。

• 排查Free SKU限制
  Free (F1) SKU存在功能限制，可临时升级至Basic (B1) SKU测试：

  1. 进入App Service Plan>「缩放」>「更改SKU」，选择Basic层B1规格并保存；
  2. 重新尝试部署中心配置流程，测试完成后可降级回Free SKU（注意：降级可能导致短暂停机）。

• 确认Azure与GitHub的授权权限

  1. 进入Azure门户「Azure Active Directory」>「企业应用程序」，搜索「GitHub Actions」；
  2. 确认该应用拥有目标App Service的「Contributor」或更高权限；
  3. 权限不足时，在App Service>「访问控制(IAM)」>「添加角色分配」，为「GitHub Actions」应用分配「Contributor」角色。

内容的提问来源于stack exchange，提问作者Michał Turczyn