Puppet代理报找不到'tomcat/web.xml.el9.erb'模板的问题求助

一、无服务器权限时追踪模板引用的方法 #

• 本地执行调试命令：在Windows代理上运行 puppet agent --test --debug --verbose，查看完整执行日志。日志会输出类的加载顺序、资源调用链，从中可以定位到间接触发uos_tomcat/web.xml.el9.erb的类。
• 检查本地缓存模块：Windows代理的Puppet模块缓存路径为 C:\ProgramData\PuppetLabs\puppet\cache\modules，找到uos_tomcat模块，遍历其中的manifest文件，搜索web.xml.el9.erb的引用位置。
• 对比项目配置差异：梳理两个项目的Puppet配置文件，找出类依赖的不同点，排查哪个项目的配置引入了调用该模板的tomcat相关类。

二、覆盖或阻止使用该模板的可行方法 #

• 资源优先级覆盖：如果你的类在加载顺序中靠后，可以重新定义对应的文件资源。比如原资源用template('uos_tomcat/web.xml.el9.erb')生成文件，你可以在自己的类中用file资源指定正确的模板或静态内容，Puppet会优先采用后加载的资源定义。
• 规避问题类继承：若该模板是通过类继承引入的，在你的类中避免继承整个tomcat类，改为直接包含所需的子类，排除调用错误模板的部分。
• 注意：如果模板调用是核心tomcat模块的硬编码逻辑，覆盖操作需要管理员配合调整模块参数。

三、要求管理员在服务器上检查的内容 #

• 定位报错代码行：查看/etc/puppetlabs/code/environments/common/shared/tomcat/manifests/init.pp第1638行的代码，确认触发该模板引用的条件逻辑（比如是否根据OS版本、项目标识等变量动态选择模板）。
• 检查模块完整性：确认服务器上uos_tomcat模块是否存在，以及web.xml.el9.erb模板文件是否缺失或路径错误。
• 核对环境依赖配置：检查common环境的模块是否被两个项目环境继承，确认是否有项目专属类修改了tomcat模板的调用参数。
• 检查节点分类配置：确认你的代理节点是否被错误分配了包含该模板调用的类，或者是否有全局类被意外应用到节点上。

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