Azure DevOps推送容器镜像至Azure Function的流水线故障求助

核心问题分析 #

你的YAML流水线存在三个关键错误，直接导致部署异常：

1. 部署任务选型错误：使用的AzureFunctionApp@1任务仅适用于代码包部署，而你要部署的是Docker镜像，必须改用AzureFunctionAppContainer@1任务。
2. 冗余Artifact操作：Build阶段的PublishBuildArtifacts和Deploy阶段的DownloadBuildArtifacts完全多余——容器镜像已推送至ACR，部署时直接从ACR拉取即可，无需传递空的构建产物。
3. ACR地址不完整：变量containerRegistry仅填写了avhc，需改为完整的ACR登录服务器名称（格式：{acr-name}.azurecr.io），否则Function App无法定位镜像。

修正后的YAML流水线 #

# Docker
# Build and push an image to Azure Container Registry
trigger:
  branches:
    include:
      - main

resources:
- repo: self

variables:
  # Container registry service connection established during pipeline creation
  dockerRegistryServiceConnection: acr
  imageRepository: avhcrepo
  # 修正为完整的ACR登录服务器地址
  containerRegistry: avhc.azurecr.io
  dockerfilePath: '$(Build.SourcesDirectory)/Dockerfile'
  tag: 'latest'

  # Agent VM image name
  vmImageName: 'ubuntu-latest'

stages:
- stage: Build
  displayName: Build and push stage
  jobs:
  - job: Build
    displayName: Build
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: Docker@2
      displayName: Build and push an image to container registry
      inputs:
        command: buildAndPush
        repository: $(imageRepository)
        dockerfile: $(dockerfilePath)
        containerRegistry: $(dockerRegistryServiceConnection)
        tags: |
          $(tag)

- stage: Deploy
  displayName: Deploy stage
  jobs:
  - job: Deploy
    displayName: Deploy
    pool:
      vmImage: $(vmImageName)
    steps:
    - task: AzureFunctionAppContainer@1
      displayName: Deploy Azure Function from Container
      inputs:
        azureSubscription: 'Demo Cybriant Subscription(fdbcdaa8-f501-435c-ac25-39179b43db0b)'
        appType: 'functionAppLinux'
        appName: 'demo-avhealthcheck'
        # 指定ACR中的完整镜像地址
        imageName: '$(containerRegistry)/$(imageRepository):$(tag)'
      condition: and(succeeded(), ne(variables['Build.Reason'], 'PullRequest'))

额外检查点（Dockerfile规范） #

若修正后仍出现依赖缺失或Runtime异常，需确保Dockerfile符合Azure Function容器镜像要求：

• 基于官方Azure Function基础镜像（如mcr.microsoft.com/azure-functions/python:4-python3.10）
• 正确复制requirements.txt并执行依赖安装命令
• 设置FUNCTIONS_WORKER_RUNTIME等必要环境变量

示例Dockerfile：

FROM mcr.microsoft.com/azure-functions/python:4-python3.10

ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
    FUNCTIONS_WORKER_RUNTIME=python

COPY requirements.txt /
RUN pip install --upgrade pip && pip install -r /requirements.txt

COPY . /home/site/wwwroot

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