Rocky 9系统中Puppet出现'osfamily'未知变量错误求助

问题场景 #

在Rocky 9系统的Puppet Server（8.5.0版本）上执行命令：

puppet apply /etc/puppetlabs/code/environments/production/manifests/print_text.pp

运行以下manifest时触发错误：

if $osfamily == 'RedHat' {
   notice("A test message")
}

错误提示：

Error: Evaluation Error: Unknown variable: 'osfamily'. (file: /etc/puppetlabs/code/environments/production/manifests/print_text.pp, line: 1, column: 4) on node mgmtserver.mydomain.com

已知puppet facts osfamily和facter osfamily均可正常返回RedHat，且当前主机仅运行puppetserver.service，未启动puppet.service。

解决方法 #

1. 显式加载facts运行命令 #

直接执行puppet apply时，默认不会自动注入顶级facts变量（如$osfamily），需通过--loadfacts参数强制加载本地facts：

puppet apply --loadfacts /etc/puppetlabs/code/environments/production/manifests/print_text.pp

2. 改用$facts哈希引用变量 #

Puppet 4及以后版本推荐通过$facts哈希访问facts值，替代直接使用顶级变量。修改manifest内容为：

if $facts['osfamily'] == 'RedHat' {
   notice("A test message")
}

这种写法无需额外参数，puppet apply会自动尝试读取$facts哈希中的值（前提是facter功能正常）。

3. 检查Puppet配置的facts开关 #

查看/etc/puppetlabs/puppet/puppet.conf的[main]或[agent]段，确认是否存在nofacts=true这类禁用facts加载的配置。如果有，将其改为nofacts=false或直接删除，然后重启puppetserver服务：

systemctl restart puppetserver.service

4. 临时手动传递facts值（仅测试用） #

如果上述方法无效，可通过--fact参数临时指定osfamily的值：

puppet apply --fact osfamily=RedHat /etc/puppetlabs/code/environments/production/manifests/print_text.pp

该方法仅适合临时测试，不建议长期使用。

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