容器化的Azure Functions Core Tools环境,集成Azure CLI和.NET SDK 6.0,用于在CI/CD流水线等场景中部署、开发和测试Azure Function Apps,提供独立环境简化函数发布流程。
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函数,避免本地环境配置干扰
- 多环境一致性:确保开发、测试、生产环境中工具版本一致,减少"在我机器上能运行"问题
详细使用方法和配置说明
镜像构建
-
Dockerfile内容
dockerfile# 基于Azure Functions Python基础镜像 FROM ***-mcr.xuanyuan.run/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 https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg && \ mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg && \ echo "deb [arch=amd64] https://packages.microsoft.com/debian/$(lsb_release -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 https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -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 -
构建命令
在Dockerfile所在目录执行:
bashdocker build -t func .构建完成后可通过
docker images | grep func查看镜像,默认标签为latest,大小约3.43GB。
使用方法
基本运行与发布流程
-
启动容器
挂载本地函数代码目录并进入交互终端:
bashdocker run -ti --rm -v $(pwd):/apps -w /apps docker.xuanyuan.run/func bash-ti:交互式终端--rm:退出后自动删除容器-v $(pwd):/apps:挂载本地当前目录到容器内/apps,便于访问函数代码-w /apps:设置工作目录为/apps
-
Azure身份验证
在容器内执行
az login完成Azure账号登录:bashaz login(根据提示完成登录,支持设备登录或服务主体登录)
-
发布函数到Azure
使用
func命令发布函数应用:bashfunc azure functionapp publish <function_app_name>其中
<function_app_name>替换为目标Azure Function App的名称。
调试配置
如需调试发布过程,可设置环境变量CLI_DEBUG=1开启调试模式:
bashexport 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服务,确保网络通畅
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
docker pull alpine/func:<标签>
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务