Puppet问题：CentOS节点无法通过清单安装Vsftpd如何解决？

作为Puppet新手，你遇到的这个问题其实是很多入门用户都会踩的坑，先梳理下你的场景：
你编写的清单如下：

class vsftpd {
  if $::operatingsystem == 'CentOS' {
    package { "vsftpd": ensure => installed }
  }
}
node 'puppet.domain.example' { include vsftpd }
node 'centos2.domain.example' { include vsftpd }
node 'centos3.domain.example' { include vsftpd }

主节点执行puppet apply manifest.pp后正常安装了vsftpd，但centos2节点执行puppet agent无报错，却始终没装上这个包。

可能的原因及排查步骤 #

1. Agent节点的证书名称（certname）与清单中的node名称不匹配

这是最常见的问题。Puppet Agent默认会用节点的完全限定主机名作为certname，如果centos2的实际主机名不是centos2.domain.example，Master就不会把对应的node配置应用给它。

排查&解决：
在centos2节点上执行以下命令查看当前certname：

puppet agent --configprint certname

如果返回的名称和清单里的centos2.domain.example不一致，有两种处理方式：

• 直接修改清单里的node块名称，和Agent的实际certname保持一致；
• 修改Agent配置：编辑/etc/puppetlabs/puppet/puppet.conf，在[agent]段添加certname = centos2.domain.example，然后删除旧证书目录rm -rf /etc/puppetlabs/puppet/ssl，执行puppet agent -t重新请求证书，最后在Master端签认证书。

2. $::operatingsystem变量值不符合判断条件

你的类里只有当$::operatingsystem严格等于'CentOS'时才会触发安装，但极少数情况下Facter返回的操作系统名称可能有大小写差异（比如返回centos），或者节点实际并非CentOS系统。

排查&解决：
在centos2节点上执行：

facter operatingsystem

确认返回值是CentOS。如果不是，要么修改类里的判断条件（比如改成if $::operatingsystem =~ /CentOS/i忽略大小写），要么检查节点的操作系统是否符合预期。

3. Agent未正确拉取配置

有时候Agent虽然没报错，但可能没成功从Master获取到对应的类配置。可以通过日志和强制运行输出排查：

排查&解决：

• 查看Agent运行日志：tail -f /var/log/puppetlabs/puppet/puppet.log，搜索vsftpd关键词，看是否有应用类的记录，或者是否有跳过安装的原因说明；
• 强制运行Agent并查看详细输出：

puppet agent -t

如果输出里没有Applying class vsftpd的字样，说明节点没有匹配到对应的node块，或者类未被Master正确加载。

4. Master端清单路径或环境配置问题

确保你的manifest.pp放在Master的正确目录下（默认是/etc/puppetlabs/code/environments/production/manifests/），并且Master的环境配置正确。可以在Master上执行puppet parser validate manifest.pp验证清单语法是否无误。

总结 #

优先排查certname匹配问题，这是新手最容易忽略的点，再结合操作系统变量和Agent日志，基本就能定位到问题根源了。

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