Linux消费计划的Azure Event Grid触发函数如何部署本地模型文件并指定路径？

方法一：随代码包一起部署（适合小/中型模型） #

这是最直接的方式，把模型文件整合到函数项目结构内，部署时一并上传至Azure。

• 步骤1：组织项目结构
  在函数项目根目录下创建专门的模型存放文件夹（比如models），将所有模型文件放入其中。示例结构：

  YourFunctionProject/
  ├── EventGridTrigger/
  │   ├── function.json
  │   └── index.py (或对应语言的代码文件)
  ├── models/
  │   ├── model1.bin
  │   └── model2.onnx
  └── host.json
  

• 步骤2：部署时包含模型文件
  无论使用Azure CLI、VS Code Azure插件还是GitHub Actions等部署方式，只要基于项目根目录执行全量部署，models文件夹及其中的文件都会被自动上传。
  示例Azure CLI命令：

  func azure functionapp publish <your-function-app-name>
  

• 步骤3：代码中获取模型路径
  根据编程语言，通过函数运行时上下文或环境变量定位函数应用根目录，再拼接模型文件路径：

  • Python：
    Linux消费计划中函数应用根目录固定为/home/site/wwwroot，直接拼接路径即可：

    import os
    model_path = os.path.join("/home/site/wwwroot", "models", "model1.bin")
    

  • C#：
    利用ExecutionContext获取函数应用根目录：

    using System.IO;
    public static async Task Run(..., ExecutionContext context)
    {
        string modelPath = Path.Combine(context.FunctionAppDirectory, "models", "model1.bin");
        // 加载模型逻辑
    }
    

方法二：挂载Azure Files存储（适合大型模型） #

如果模型文件体积超过Linux消费计划本地存储5GB的限制，可将模型存储在Azure Files中，再挂载到函数应用的本地路径。

• 步骤1：准备Azure Files资源

  1. 创建一个Azure标准存储账户。
  2. 在存储账户内创建文件共享（比如model-share），将模型文件上传至该共享。

• 步骤2：配置函数应用挂载

  1. 进入Azure门户的函数应用页面，选择「配置」→「路径映射」→「添加挂载」。
  2. 填写挂载信息：
     • 名称：自定义名称（比如models-mount）。
     • 挂载路径：指定函数应用内的本地路径（比如/home/site/models）。
     • 存储账户：选择已创建的存储账户。
     • 文件共享：选择之前创建的model-share。
     • 访问密钥：自动填充存储账户的访问密钥（或使用托管身份授权）。
  3. 保存配置，函数应用会自动重启生效。

• 步骤3：代码中访问模型
  直接使用指定的挂载路径访问模型文件即可，比如Python中：

  model_path = os.path.join("/home/site/models", "model1.bin")
  

注意事项 #

• Linux消费计划本地存储（/home/site/wwwroot）总容量限制为5GB，超量模型建议使用Azure Files挂载。
• 确保模型文件权限正确：随代码部署的文件默认拥有可读权限；Azure Files挂载的文件，函数运行身份需具备存储账户的读取权限。
• 部署后可通过Kudu工具（https://<your-function-app-name>.scm.azurewebsites.net）的「Debug console」→「Bash」查看文件是否存在于指定路径，验证部署结果。

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