求助：使用私有Docker镜像部署Azure Durable Function遇服务不可用

正确的镜像地址格式 #

私有Docker Hub镜像的正确格式是 <docker-hub用户名>/<镜像名>:标签，比如 myusername/my-func-image:latest，无需添加 docker.io 或 https:// 前缀，但必须显式指定注册表服务器信息才能拉取私有镜像。

完整的CLI配置命令 #

之前的命令缺少私有仓库的注册表服务器参数，导致Azure无法完成认证拉取镜像，执行以下完整命令：

az functionapp config container set \
  --name <你的函数应用名> \
  --resource-group <你的资源组名> \
  --docker-custom-image-name <docker-id>/<image>:latest \
  --docker-registry-server-url https://index.docker.io/v1/ \
  --docker-registry-server-user <你的Docker Hub用户名> \
  --docker-registry-server-password <你的Docker Hub密码/访问令牌>

注意：如果你的Docker Hub账号开启了2FA，必须使用**个人访问令牌（Personal Access Token）**替代密码，令牌需配置read:packages权限。

后续验证与操作步骤 #

1. 重启函数应用
   配置完成后强制重启，确保新的容器配置生效：

   az functionapp restart --name <你的函数应用名> --resource-group <你的资源组名>
   

2. 检查部署日志
   在Azure门户进入函数应用的日志（Log Stream），重点查看：

   • 是否成功拉取镜像（无认证失败、镜像不存在等错误）
   • 容器是否正常启动（无端口冲突、依赖缺失等启动失败日志）

3. 验证Dockerfile正确性
   确保你的Dockerfile基于Azure Functions官方Python镜像，并正确安装Playwright及浏览器依赖：

   FROM mcr.microsoft.com/azure-functions/python:4-python3.10
   
   ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
       AzureFunctionsJobHost__Logging__Console__IsEnabled=true
   
   COPY requirements.txt /
   RUN pip install -r /requirements.txt
   
   # 安装Playwright浏览器二进制文件及系统依赖
   RUN playwright install chromium
   RUN playwright install-deps chromium
   
   COPY . /home/site/wwwroot
   

常见问题排查 #

• 服务不可用：大概率是容器启动失败，检查日志中是否有Playwright依赖缺失、端口配置错误（Azure Functions默认使用8080端口，不要修改）。
• 镜像拉取失败：确认镜像已推送到私有仓库，本地可通过docker pull <docker-id>/<image>:latest测试拉取，同时检查用户名/令牌权限是否足够。
• 认证错误：使用Docker Hub个人访问令牌替代密码，避免2FA或密码特殊字符导致的认证失败。

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