基于容器的Azure DevOps代理构建Azure函数应用报错求助

问题原因 #

你遇到的错误是因为Azure Functions SDK 4.1.1依赖的部分.NET构建组件/运行时，mcr.microsoft.com/dotnet/sdk:7.0基础镜像里没有预装，导致构建阶段的版本校验失败。

替代Packer VHD的容器化方案 #

容器本身就是轻量的依赖打包方案，完全可以替代Packer制作VHD的思路——直接定制包含所有必要依赖的Azure DevOps代理镜像，步骤如下：

1. 编写定制Dockerfile #

基于你使用的.NET 7 SDK镜像，补充安装Azure Functions构建所需的工具和依赖：

FROM mcr.microsoft.com/dotnet/sdk:7.0

# 定义版本变量
ENV AGENT_VERSION=2.220.5
ENV FUNCTIONS_CORE_TOOLS_VERSION=4.x

# 安装系统依赖工具
RUN apt-get update && apt-get install -y --no-install-recommends \
    curl \
    wget \
    unzip \
    && rm -rf /var/lib/apt/lists/*

# 安装Azure Functions Core Tools（Functions构建必备）
RUN wget -q https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb \
    && dpkg -i packages-microsoft-prod.deb \
    && apt-get update \
    && apt-get install -y azure-functions-core-tools-${FUNCTIONS_CORE_TOOLS_VERSION} \
    && rm packages-microsoft-prod.deb \
    && rm -rf /var/lib/apt/lists/*

# 创建代理运行用户
RUN useradd -m agentuser

# 下载并解压Azure DevOps代理
WORKDIR /home/agentuser
RUN curl -L -o vsts-agent.tar.gz https://vstsagentpackage.azureedge.net/agent/${AGENT_VERSION}/vsts-agent-linux-x64-${AGENT_VERSION}.tar.gz \
    && tar zxvf vsts-agent.tar.gz \
    && rm vsts-agent.tar.gz \
    && chown -R agentuser:agentuser /home/agentuser

# 切换到代理用户执行启动脚本
USER agentuser
CMD ["./run.sh"]

2. 构建并推送镜像 #

执行以下命令构建镜像：

docker build -t azdo-functions-agent:7.0 .

把镜像推送到你的私有镜像仓库（比如Azure容器注册表）：

docker tag azdo-functions-agent:7.0 <你的ACR域名>/azdo-functions-agent:7.0
docker push <你的ACR域名>/azdo-functions-agent:7.0

3. 更新Azure容器应用 #

用这个新构建的镜像替换原来的代理镜像，重新部署容器应用里的Azure DevOps代理。这个镜像已经预装了：

• .NET 7 SDK
• Azure Functions Core Tools 4.x
• Azure DevOps代理运行所需的全部组件

验证效果 #

重新触发Azure函数应用的构建任务，此时Microsoft.NET.Sdk.Functions.Build.targets能找到完整的依赖，不会再出现版本错误。

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