Iguazio创建Jupyter服务运行时报mlrun未安装错误咨询

常见根因 #

• 创建Jupyter服务时选错基础镜像：平台仅在专门的ML/数据科学预置镜像、Demo专用镜像中预装了mlrun，若选择纯Python基础镜像、未集成mlrun的自定义镜像，环境内不会自带该依赖
• 服务初始化流程异常：集群资源不足、存储挂载失败、权限配置错误会导致平台预置的环境初始化脚本执行中断，预装依赖包没有完成部署
• 环境配置缺失：Jupyter服务没有正确关联平台MLRun服务端点、内置包源配置，会导致初始化阶段自动拉取mlrun的流程被跳过
• 版本适配冲突：平台升级后，旧demo依赖的mlrun版本和当前环境预装版本不匹配，import时会抛出类似未安装的报错

排查解决步骤 #

1. 先验证环境实际状态
   打开Jupyter对应环境的终端，执行命令检查包安装状态：
   pip list | grep mlrun
   若命令无返回结果，说明环境内确实未安装mlrun；若返回了版本号但import报错，属于版本冲突或Python路径配置问题。
2. 核对服务基础配置
   • 回到Iguazio UI的Jupyter服务配置页，确认所选镜像为平台官方标注集成MLRun的官方镜像，不要使用未验证的自定义镜像
   • 检查服务资源配额，确认CPU、内存不低于平台要求的最低阈值（通常为2核4G），资源不足会导致初始化脚本超时中断
   • 检查服务绑定的权限角色，确认角色具备拉取平台内置包源、访问MLRun服务的权限，不要使用无相关权限的自定义角色
3. 修复当前运行环境
   若不想重建服务，可直接在当前环境执行修复操作：
   • 先在平台MLRun服务概览页查询当前平台对应的mlrun版本号，安装时必须选择完全一致的版本，避免API不兼容
   • 配置平台内置PyPI源执行安装，不要直接从公网拉取未知版本：
     pip install mlrun==<对应版本号> --index-url <平台内置PyPI源地址>
   • 安装完成后重启Jupyter内核，执行import mlrun验证是否导入正常
4. 重建服务（修复无效时使用）
   若上述操作仍无法解决问题，删除当前异常的Jupyter服务后重新创建：
   • 创建时直接选择平台官方提供的Demo专用预置环境镜像，这类镜像已经提前预装了所有demo运行所需的依赖
   • 创建过程中保持默认的初始化脚本、环境变量、权限配置不变，不要随意修改默认参数
   • 服务显示启动成功后等待2-3分钟，待后台初始化流程完全执行完毕后，再打开demo文件运行

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