通过Azure容器镜像部署Azure Functions时运行时不可达求助

问题现象 #

使用Azure容器注册表（ACR）镜像部署Azure Function时，出现运行时不可达问题。Kudu中的Docker日志显示：

Pull Image successful, Time taken: 0 Minutes and 1 Seconds
2022-12-13T07:40:49.911Z INFO - Starting container for site
2022-12-13T07:40:49.912Z INFO - docker run -d --expose=80 --name <function_app>_0_e2779bae -e DOCKER_CUSTOM_IMAGE_NAME=/: -e WEBSITES_ENABLE_APP_SERVICE_STORAGE=false -e WEBSITE_SITE_NAME=<function_app> -e WEBSITE_AUTH_ENABLED=False -e PORT=80 -e WEBSITE_ROLE_INSTANCE_ID=0 -e WEBSITE_HOSTNAME=<function_app>.azurewebsites.net -e WEBSITE_INSTANCE_ID= -e WEBSITE_USE_DIAGNOSTIC_SERVER=False <image_path>

2022-12-13T07:40:49.913Z INFO  - Logging is not enabled for this container.
Please use https://aka.ms/linux-diagnostics to enable logging to see container logs here.
2022-12-13T07:40:50.683Z INFO  - Initiating warmup request to container <function_app>_0_e2779bae_msiProxy for site <function_app>
2022-12-13T07:40:50.692Z INFO  - Container <function_app>_0_e2779bae_msiProxy for site <function_app> initialized successfully and is ready to serve requests.
2022-12-13T07:40:50.693Z INFO  - Initiating warmup request to container <function_app>_0_e2779bae for site <function_app>
2022-12-13T07:40:50.706Z ERROR - Container <function_app>_0_e2779bae for site <function_app> has exited, failing site start
2022-12-13T07:40:50.712Z ERROR - Container <function_app>_0_e2779bae didn't respond to HTTP pings on port: 80, failing site start. See container logs for debugging.
2022-12-13T07:40:50.718Z INFO  - Stopping site <function_app> because it failed during startup.

已配置正确的Docker镜像URL、用户名及密码，但容器启动后立即退出，无法响应端口80的HTTP探测。

排查与解决步骤 #

• 启用容器日志收集
  当前日志未启用容器内部日志，无法定位具体退出原因。在Azure门户进入目标应用服务，依次打开「监控」->「日志」，启用容器日志功能。之后重新启动应用，即可在Kudu或门户日志中查看容器内部的启动日志，明确失败根源。

• 验证容器镜像的端口配置
  确认镜像内的Azure Function服务是否正确监听PORT环境变量指定的端口（此处为80）：

  • 检查Dockerfile是否包含EXPOSE 80指令；
  • 确认Function应用的配置中，绑定端口与环境变量PORT一致（例如Python Function需确保启动命令绑定到该端口，.NET Function需配置正确的HTTP端口）。

• 本地测试容器镜像
  在本地环境运行容器，模拟Azure的启动参数：

  docker run -p 8080:80 -e PORT=80 <你的镜像路径>
  

  访问http://localhost:8080/api/[你的函数名称]，验证容器是否能正常启动并响应请求，排除镜像本身的问题。

• 指定容器启动命令
  如果镜像未定义默认启动命令，需在应用服务的「应用设置」中添加WEBSITES_CONTAINER_START_COMMAND，指定正确的Function启动命令。例如：

  • Python Function：func start --host-port 80
  • .NET Function：dotnet <你的Function程序集>.dll --urls http://0.0.0.0:80

• 确认ACR镜像拉取权限
  虽然已配置用户名密码，仍需确认应用服务具备ACR的镜像拉取权限：

  • 检查ACR的「访问控制（IAM）」是否为应用服务的服务主体分配了「AcrPull」角色；
  • 使用Azure CLI测试拉取镜像，验证凭据有效性：

    az acr login --name <你的ACR名称>
    docker pull <你的镜像路径>
    

• 检查应用服务SKU
  确保应用服务使用的SKU支持容器部署（如B1及以上），免费层（F1）可能存在资源限制导致容器启动失败。

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