MLRun中mlrun.auto_mount()与mount_v3io()的区别及适用场景

核心差异 #

• 适配逻辑完全不同
  mount_v3io() 是专门为Iguazio平台自研的v3io分布式存储写的专属挂载方法，逻辑硬绑定v3io存储协议，不会判断当前运行环境类型。auto_mount() 是通用挂载入口，会自动检测当前运行环境：跑在Iguazio平台上就底层调用mount_v3io()挂载v3io存储，跑在本地Docker环境就自动配置本地目录映射，跑在第三方K8s集群就自动匹配已配置的PVC、CSI存储（比如NFS、云盘、S3存储网关等）。
• 配置成本不同
  mount_v3io() 需要手动传入v3io访问密钥、待挂载的远端v3io路径、本地挂载点等参数，漏填、错填都会导致挂载失败。auto_mount() 绝大多数场景下不需要传任何参数，会自动读取当前环境的存储凭证、项目默认路径配置，自动完成常用目录的挂载，不需要手动做参数映射。
• 兼容性不同
  mount_v3io() 只有在部署了v3io服务的Iguazio环境下能正常运行，本地开发机、自建裸金属MLRun集群、公有云自建MLRun环境调用这个方法都会直接挂载失败。auto_mount() 做了全环境适配，同一份代码不用改挂载配置，就能在本地调试、测试集群、生产平台多环境无缝跑通。
• 可控粒度不同
  mount_v3io() 支持所有v3io专属的配置项，比如自定义缓存策略、跨项目路径授权挂载、连接并发数调整等细粒度控制。auto_mount() 只会走默认挂载配置，不会暴露这些v3io专属的底层调优参数，也不会自动挂载非通用的特殊路径。

场景选型 #

• 优先选mlrun.auto_mount()的场景：
  • 需要同一份代码在本地开发、测试、生产多环境迁移复用，不想针对不同环境单独修改挂载逻辑，这也是MLRun官方推荐的默认用法
  • 刚接触MLRun，不想花时间梳理不同存储的挂载参数、凭证配置逻辑，无参调用auto_mount()就能覆盖90%以上的常规存储访问需求
  • 开发开源MLRun模板、公共项目，需要适配不同用户的MLRun部署环境，不能硬编码平台专属逻辑
• 选mlrun.mount_v3io()的场景：
  • 确定代码只会运行在Iguazio托管平台，需要精细化控制v3io挂载规则，比如自定义挂载点、单独挂载某个指定的v3io子目录
  • 需要挂载v3io的特殊路径，比如平台公共数据集目录、其他租户授权的跨项目路径，这些路径不在auto_mount()的默认挂载列表里
  • 需要做v3io存储性能调优，要调整缓存策略、连接参数等v3io专属配置，这些参数只能通过mount_v3io()传入

补充：在标准Iguazio平台环境下，auto_mount()默认配置的挂载效果和手动调用无特殊参数的mount_v3io()完全一致，前者只是多做了环境判断和默认参数自动填充的封装。

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