Molecule执行任务与Handler时PATH路径来源及异常问题排查

问题现象 #

• 角色A依赖角色B，B包含一个作为Handler的任务，该任务通过command模块调用/usr/sbin目录下的可执行文件
• converge阶段：B作为Handler运行时，命令可正常执行，此时环境变量PATH为/sbin:/bin:/usr/sbin:/usr/bin
• side-effect阶段：重新运行角色A（及依赖的B）时，任务因找不到可执行文件失败，此时PATH为/opt/conda/condabin:/usr/local/bin:/usr/bin
• 手动通过molecule login --host <hostname>登录目标主机后，PATH包含/usr/sbin，命令可正常执行

核心原因 #

Molecule在不同阶段执行Ansible任务时，SSH连接的上下文存在差异，直接导致PATH环境变量不一致：

1. Converge阶段的Handler执行：Handler继承了主任务的执行上下文，使用的是Ansible初始化SSH连接时的系统默认PATH，通常包含/usr/sbin这类系统管理路径。
2. Side-effect阶段的任务执行：Side-effect是独立的Ansible运行流程，Molecule会重新建立SSH连接。部分Vagrant镜像（尤其是预装conda的镜像）在非交互式SSH会话中，不会加载完整的系统环境配置，导致PATH被重置为不包含/usr/sbin的版本。
3. 交互式Shell登录：手动登录时会触发读取~/.bashrc、/etc/profile等配置文件，这些文件会自动将/usr/sbin等路径添加到PATH中，因此能正常找到命令。

解决方案 #

针对该问题，可采用以下几种修复方式：

• 使用命令绝对路径：直接在command模块中指定可执行文件的完整路径（如/usr/sbin/your-command），彻底规避PATH依赖问题。
• 显式指定环境变量：在执行命令的任务或Handler中，通过environment参数手动设置包含/usr/sbin的PATH：

  - name: 运行目标命令
    command: your-command
    environment:
      PATH: "/sbin:/bin:/usr/sbin:/usr/bin:/opt/conda/condabin:/usr/local/bin"
    become: true
  

• 调整SSH连接配置：在Molecule的molecule.yml中，配置Ansible使用交互式Shell执行任务，确保加载完整环境变量：

  provisioner:
    name: ansible
    config_options:
      ssh_connection:
        pipelining: false
        executable: /bin/bash -l
  

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