如何通过Azure Pipeline将ACR镜像部署至App Service？部署未生效排查

针对你遇到的Pipeline执行成功但Web App显示“正在运行并等待内容”的问题，你可以从以下几个方向排查：

• 验证容器拉取的权限配置
  仅设置DOCKER_CUSTOM_IMAGE_NAME不足以让App Service拉取私有ACR镜像，必须确保配置了以下三个关键应用设置：

  • DOCKER_REGISTRY_SERVER_URL：设置为你的ACR地址（如https://xxxx.azurecr.io）
  • DOCKER_REGISTRY_SERVER_USERNAME：ACR的管理员用户名或有权限拉取镜像的服务主体用户名
  • DOCKER_REGISTRY_SERVER_PASSWORD：对应用户名的密码或服务主体密钥
    你可以在Azure门户的App Service“配置”->“应用程序设置”里检查这三个参数是否正确配置。

• 确认镜像本身的可用性与兼容性

  • 本地尝试拉取并运行该ACR镜像，检查容器是否能正常启动，且业务端口（如80、8080）是否正确暴露。如果本地启动都失败，说明镜像本身存在问题。
  • Windows容器镜像存在OS版本兼容性问题，App Service的Windows HyperV容器宿主有特定的OS版本（如Windows Server 2019），确保你的镜像基于相同或更低版本的Windows Server Core构建，避免版本不兼容导致启动失败。

• 检查部署任务的细节与缓存问题

  • 虽然你使用了latest标签，但App Service可能会缓存该标签的镜像，导致即使镜像更新也不会重新拉取。建议在Pipeline中使用唯一的镜像标签（如Git Commit ID、时间戳）替代latest，确保每次部署都能触发镜像更新。
  • 查看AzureRmWebAppDeployment@4任务的详细日志，确认是否有“Successfully updated web app container settings”这类提示，若没有，可能任务参数存在隐性问题，尝试显式指定DockerImageTag为具体版本。

• 查看App Service的容器日志
  这是最直接的排查方式：在Azure门户进入你的Web App，依次点击“日志”->“容器日志”，查看是否有拉取镜像失败、容器启动报错的具体信息（如权限拒绝、端口冲突、依赖缺失等），这些日志会直接告诉你问题所在。

• 添加强制重启步骤
  即使容器配置更新成功，有时候App Service不会自动重启容器。可以在Pipeline的部署任务后添加一个Azure CLI任务，强制重启Web App：

  az webapp restart --name <你的WebApp名称> --resource-group <你的资源组名称>
  

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