molecule converge忽略正常可用角色的原因咨询

问题场景 #

执行molecule converge时，converge.yml中定义的appname角色被完全跳过，仅appname_sudo角色正常运行。重命名appname角色后即可正常执行，直接用Ansible运行剧本时两个角色均正常，开启MOLECULE_DEBUG=1也无跳过原因输出。相关剧本内容：

---
- name: Converge
  hosts: all
  roles:
    - role: appname
      become: true
      become_user: username
    - role: appname_sudo
      become: true

可能的原因及排查要点 #

• 角色名称与Molecule内置命名冲突：Molecule有内置的变量、模块或默认角色命名规则，若角色名（如appname）恰好与这些内置项重名，会被内部逻辑跳过。尝试给角色名添加前缀（如myapp_appname）验证是否解决。
• Molecule配置的角色过滤规则：检查molecule.yml的provisioner段，是否存在roles_path、tags、skip_tags或playbooks相关的过滤配置，是否无意中排除了appname角色。比如部分配置会限定仅运行指定路径或名称的角色。
• 角色目录结构不符合Molecule要求：Molecule对角色结构的校验比Ansible更严格，若appname角色缺少核心文件（如tasks/main.yml），Ansible可能允许空角色执行，但Molecule会直接跳过。虽然重命名后能运行，但仍可检查角色目录的完整性。
• Molecule缓存残留：Molecule会缓存运行状态，若之前的异常运行残留了错误状态，可能导致角色被误判跳过。执行molecule cleanup清理缓存后，重新运行molecule converge测试。
• Molecule使用的Ansible配置差异：Molecule默认使用独立的Ansible配置（通常在.molecule/ansible.cfg），可能与你直接运行Ansible时的配置不同。检查该文件中的roles_path设置，确认是否因路径问题导致Molecule无法找到appname角色，而重命名后刚好匹配路径规则。

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