如何为Salt Runner模块安装并管理外部Python依赖？

一、安装外部依赖的核心方法 #

Salt Runner模块运行在Salt Master节点上，只需在Master对应的Python环境中安装依赖即可：

• 直接用pip安装：pip install external_library
  注意要匹配Salt进程使用的Python环境——如果Salt用系统Python运行，就用系统级pip；如果是虚拟环境，先激活环境再执行命令。
• 部分带原生扩展的依赖，也可以用Master的系统包管理器安装，比如Debian/Ubuntu用apt-get install python3-external-library，RHEL/CentOS用dnf install python3-external-library。

二、类似requirements.txt的依赖管理方案 #

SaltStack没有原生集成自动依赖拉取机制，但可以手动实现批量管理：

• 维护一个requirements-runner.txt文件，按pip格式列出依赖：

  external_library>=1.0.0
  another_dependency==2.3.4
  

  执行pip install -r requirements-runner.txt完成批量安装。
• 用Salt状态文件自动化管理Master依赖：

  runner-dependencies:
    pip.installed:
      - pkgs:
        - external_library>=1.0.0
        - another_dependency==2.3.4
  

  运行salt-call state.apply runner-dependencies就能自动安装或更新依赖。
• 若将自定义Runner打包成Salt扩展（salt-extensions），可在pyproject.toml的dependencies字段声明依赖，用户安装扩展时会自动拉取所需包。

三、依赖有效性验证 #

安装完成后，先在Master上执行python -c "import external_library"确认依赖能正常导入，再运行自定义Runner（比如salt-run my_custom_runner.func）测试功能是否正常。

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