Azure Function自定义Docker镜像部署后，如何等待配置生效以执行测试？

针对你遇到的Azure Function配置容器镜像后，实际运行实例切换到新镜像存在延迟，导致集成测试命中旧镜像的问题，分享几个可靠的等待方案：

1. 轮询Function应用的实例状态 #

Azure Function的实例运行状态可以通过Azure CLI获取，核心是等待所有实例的镜像版本与目标镜像匹配，且处于就绪状态。

使用Azure CLI结合jq工具处理输出的示例脚本：

TARGET_IMAGE="your-registry/your-image:tag"
FUNCTION_APP_NAME="your-function-app"
RESOURCE_GROUP="your-resource-group"

# 循环轮询实例状态
while true; do
    # 获取当前运行的实例列表（包含状态和镜像信息）
    INSTANCES=$(az functionapp instance list --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --query "[].{State:state, Image:containerConfiguration.image}" -o json)
    
    # 检查所有实例是否都使用目标镜像且状态为READY
    ALL_READY=$(echo $INSTANCES | jq -e 'all(.State == "READY" and .Image == "'$TARGET_IMAGE'")')
    
    if [ "$ALL_READY" = "true" ]; then
        echo "所有实例已切换到新镜像并就绪"
        break
    fi
    
    echo "等待实例切换中..."
    sleep 5
done

2. 调用自定义健康检查端点 #

如果你的Function应用有HTTP触发的健康检查端点，可以在返回内容中加入当前运行的镜像版本标识（比如通过os.getenv("WEBSITE_IMAGE")读取Azure自动注入的环境变量），然后轮询该端点直到返回的版本与目标版本一致。

示例思路：

• 新增一个/health端点，返回包含镜像标签的JSON：

  import os
  import azure.functions as func
  
  def main(req: func.HttpRequest) -> func.HttpResponse:
      image_tag = os.getenv("WEBSITE_IMAGE").split(":")[-1]
      return func.HttpResponse(f'{{"image_tag": "{image_tag}"}}', mimetype="application/json")
  

• 部署后用脚本轮询：

  TARGET_TAG="your-image-tag"
  HEALTH_URL="https://your-function-app.azurewebsites.net/api/health"
  
  while true; do
      CURRENT_TAG=$(curl -s $HEALTH_URL | jq -r ".image_tag")
      if [ "$CURRENT_TAG" = "$TARGET_TAG" ]; then
          echo "新镜像已生效"
          break
      fi
      echo "等待健康检查返回目标版本..."
      sleep 3
  done
  

3. 利用部署槽交换（适用于多槽场景） #

如果你的Function应用使用了部署槽，可以先将新镜像部署到staging槽，等待槽内实例就绪后再执行槽交换，交换完成后生产槽会立即切换到新镜像：

1. 构建并推送镜像到容器仓库
2. 配置staging槽使用新镜像：

   az functionapp config container set --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --slot staging --docker-image-custom-name $TARGET_IMAGE
   

3. 用方案1的方法轮询staging槽的实例状态直到就绪
4. 执行槽交换：

   az functionapp deployment slot swap --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --slot staging --target-slot production
   

4. 结合部署状态与实例检查 #

使用az functionapp deployment show确认部署操作完成，再结合实例状态检查，双重确保新镜像生效：

FUNCTION_APP_NAME="your-function-app"
RESOURCE_GROUP="your-resource-group"
TARGET_IMAGE="your-registry/your-image:tag"

# 获取最新部署ID
DEPLOYMENT_ID=$(az functionapp deployment list --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --query "[0].id" -o tsv)

# 等待部署完成
while true; do
    DEPLOYMENT_STATUS=$(az functionapp deployment show --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --id $DEPLOYMENT_ID --query "status" -o tsv)
    if [ "$DEPLOYMENT_STATUS" = "succeeded" ]; then
        echo "部署操作已完成"
        break
    fi
    echo "等待部署完成..."
    sleep 4
done

# 再轮询实例状态（同方案1）
while true; do
    INSTANCES=$(az functionapp instance list --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP --query "[].{State:state, Image:containerConfiguration.image}" -o json)
    ALL_READY=$(echo $INSTANCES | jq -e 'all(.State == "READY" and .Image == "'$TARGET_IMAGE'")')
    
    if [ "$ALL_READY" = "true" ]; then
        echo "所有实例已切换到新镜像"
        break
    fi
    
    echo "等待实例切换中..."
    sleep 5
done

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