Puppet Agent应用清单报错求助：Docker模块部署异常

首先，核心问题大概率是版本兼容性不匹配：你使用的Puppet 3.8.7属于较旧的3.x分支，而你安装的garethr-docker 5.3.0模块，其官方要求的Puppet版本是>=4.0.0 <6.0.0，两者完全不兼容，这是导致Agent应用配置报错的主要原因。

下面是具体的排查和解决步骤：

1. 确认版本兼容性 #

你可以在Puppet Master上查看已安装模块的metadata来验证这一点：

cat /etc/puppet/modules/docker/metadata.json | grep -A 3 "requirements"

输出里应该会看到类似这样的版本要求：

"requirements": [
{
"name": "puppet",
"version_requirement": ">=4.0.0 <6.0.0"
}
]

这直接说明该模块无法在Puppet 3.8.7环境中正常工作。

2. 解决方案：安装兼容Puppet 3的模块版本 #

你需要卸载当前的5.3.0版本，替换为支持Puppet 3的旧版本（比如3.11.0，该版本明确支持Puppet 3.4+）：

• 卸载现有模块：

puppet module uninstall garethr-docker

• 安装兼容版本：

puppet module install garethr-docker --version 3.11.0

3. 验证配置兼容性 #

安装完成后，检查你的site.pp配置是否适配旧版本模块：

node 'test02.edureka.com' { 
  include 'docker' 
  docker::image { 'ubuntu': 
    image_tag => 'precise' 
  } 
}

garethr-docker 3.x分支是支持image_tag参数的，所以这段配置无需修改，但如果后续还有报错，可以查看模块目录下的README.md文档确认参数用法。

4. 额外排查点 #

• 确保Agent节点的Puppet版本也为3.8.7，Master和Agent版本不一致也可能引发问题；
• 检查模块依赖是否安装完整：运行puppet module list查看是否有缺失的依赖，若有则按照提示安装对应版本的依赖模块。

完成以上操作后，在Agent节点重新执行puppet agent -t，应该就能正常应用配置了。

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