Azure Functions Core Tools Docker镜像

镜像概述和主要用途

该Docker镜像提供了一个预配置的容器化环境，用于部署、开发和测试Azure Function Apps。基于Azure Functions Python基础镜像（4-python3.10），集成了Azure Functions Core Tools 4、Azure CLI和.NET SDK 6.0，解决了直接在主机安装时占用空间大（原安装约2.5GB，含依赖后更大）的问题，适用于需要在隔离环境中执行func publish等命令的场景，尤其适合CI/CD流水线。

核心功能和特性

• 集成核心工具：包含Azure Functions Core Tools 4，支持本地开发、测试和发布Azure函数
• Azure CLI支持：预装Azure CLI（Python包），用于Azure资源管理和身份验证（az login）
• .NET运行时：内置.NET SDK 6.0，支持.NET函数的部署需求
• 容器化隔离：提供独立环境，避免主机环境依赖冲突，简化跨环境一致性

使用场景和适用范围

• CI/CD流水线：在自动化部署流程中执行func azure functionapp publish发布Azure函数
• 本地开发测试：在容器内调试和测试Azure函数，避免本地环境配置干扰
• 多环境一致性：确保开发、测试、生产环境中工具版本一致，减少"在我机器上能运行"问题

详细使用方法和配置说明

镜像构建

1. Dockerfile内容

   # 基于Azure Functions Python基础镜像
   FROM mcr.microsoft.com/azure-functions/python:4-python3.10
   
   # 安装Azure CLI
   RUN pip3 install azure-cli
   
   # 安装Azure Functions Core Tools 4
   RUN apt-get update && \
     apt-get install -y curl gpg lsb-release && \
     curl [***] | gpg --dearmor > microsoft.gpg && \
     mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg && \
     echo "deb [arch=amd64] [***] -rs | cut -d'.' -f 1)/prod $(lsb_release -cs) main" > /etc/apt/sources.list.d/dotnetdev.list && \
     apt-get update && \
     apt-get install -y azure-functions-core-tools-4
   
   # 安装.NET SDK 6.0
   RUN wget [***] -O packages-microsoft-prod.deb && \
     dpkg -i packages-microsoft-prod.deb && \
     rm packages-microsoft-prod.deb && \
     rm /etc/apt/sources.list.d/mssql-release.list && \
     apt-get update && \
     apt-get install -y dotnet-sdk-6.0
   

2. 构建命令

   在Dockerfile所在目录执行：

   docker build -t func .
   

   构建完成后可通过docker images | grep func查看镜像，默认标签为latest，大小约3.43GB。

使用方法

基本运行与发布流程

1. 启动容器

   挂载本地函数代码目录并进入交互终端：

   docker run -ti --rm -v $(pwd):/apps -w /apps func bash
   

   • -ti：交互式终端
   • --rm：退出后自动删除容器
   • -v $(pwd):/apps：挂载本地当前目录到容器内/apps，便于访问函数代码
   • -w /apps：设置工作目录为/apps

2. Azure身份验证

   在容器内执行az login完成Azure账号登录：

   az login
   

   （根据提示完成登录，支持设备登录或服务主体登录）

3. 发布函数到Azure

   使用func命令发布函数应用：

   func azure functionapp publish <function_app_name>
   

   其中<function_app_name>替换为目标Azure Function App的名称。

调试配置

如需调试发布过程，可设置环境变量CLI_DEBUG=1开启调试模式：

export CLI_DEBUG=1
func azure functionapp publish <function_app_name>

注意事项

• 镜像大小：当前构建后镜像大小约3.43GB，主要由于集成了Azure CLI（约1GB）、Azure Functions Core Tools（约1.5GB）和.NET SDK，可考虑多阶段构建或精简基础镜像以减小体积
• 依赖兼容性：基于Debian系统，确保函数代码依赖与Python 3.10、.NET 6.0兼容
• 网络要求：构建和运行时需访问Microsoft包源和Azure服务，确保网络通畅