解释说明
设置模型对环境的依赖,模型开发者需要提供包名、安装方式、版本约束。当模型配置文件中定义了dependencies参数,配置了依赖包,选择元模型后,运行时依赖将自动罗列已配置的安装依赖包。
当前仅支持pip安装依赖包方式,默认pip源为pypi.org中的包,请在pypi.org中查看是否有对应版本的包并查看包安装限制。
当前支持线下wheel包安装(wheel包必须与模型文件放在同一目录)。
常见问题
模型配置文件中的安装包依赖参数“dependencies”如何编写?
模型配置文件中的“dependencies”,表示配置模型推理代码需要的依赖包,需要提供依赖包名、安装方式和版本约束的信息。依赖参数编写应遵循以下原则:
- 安装包存在前后依赖关系。例如您在安装“mmcv-full”之前,需要完成“Cython”、“pytest-runner”、“pytest”的安装,在配置文件中,您需要把“Cython”、“pytest-runner”、“pytest”写在“mmcv-full”的前面。
- 当依赖包无法完成线上安装时,可以使用线下wheel包安装(wheel包必须与模型文件放在同一目录)。
- “dependencies”支持多个“dependency”结构数组以list形式填入。
详细示例代码,可参考导入模型时,模型配置文件中的安装包依赖参数如何编写?
pip下载安装包失败,如何处理?
创建模型构建失败,提示pip下载包失败。一般有如下几个原因:
- pip源中不存在该安装包。当前默认pip源为pypi.org中的包,请在pypi.org中查看是否有对应版本的包并查看包安装限制。
- 下载的包与对应基础镜像架构不匹配,如arm系统下载了x86的包,python2版本的pip下载了python3的包。查看待安装包的安装限制和前置依赖等,排查是否满足相关要求。具体基础镜像运行环境请参见推理基础镜像列表。
- 安装pip包有先后依赖关系,请按规范编写模型配置文件中的dependencies参数。