Hiera无法识别环境文件夹中新文件的问题求助

核心问题 #

将common.yaml中的配置拆分到环境特定文件夹（如data/development/pi_cameras/）后，Hiera在节点执行puppet agent时无法识别新文件中的配置键，但在服务器手动执行puppet lookup能正常返回值。旧EC2实例的同结构配置可正常识别，Hiera配置未做修改。

关键排查方向与解决步骤 #

1. 检查Puppet Master运行用户的文件权限 #

手动执行puppet lookup使用的是当前系统用户权限，但Puppet Master服务通常以puppet用户运行。需确认该用户对新的pi_cameras文件夹及内部文件有读取权限：

# 查看文件夹权限
ls -ld data/development/pi_cameras/
# 查看文件权限
ls -l data/development/pi_cameras/*.yaml
# 修复权限（若存在权限问题）
chown -R puppet:puppet data/development/pi_cameras/
chmod -R 640 data/development/pi_cameras/*.yaml
chmod 750 data/development/pi_cameras/

2. 确认节点的实际环境匹配 #

节点的环境可能与你指定的development不符，导致Hiera读取了错误的环境文件夹。可通过以下方式验证：

• 在节点上执行：puppet agent --configprint environment
• 在服务器上查看节点配置：puppet node show 240422-26
  确保节点环境与配置文件所在的development目录完全一致（路径大小写敏感）。

3. 验证新YAML文件的语法正确性 #

YAML语法错误（如缩进混乱、特殊字符未转义）可能导致Puppet Master编译目录时解析失败，即使手动lookup能勉强读取。用Puppet自带工具验证：

puppet parser validate data/development/pi_cameras/*.yaml

修复所有语法错误后，重启Puppet Master服务。

4. 清理Puppet Master缓存 #

Master可能缓存了旧的Hiera数据，导致新配置未被加载：

# 停止Puppet Server服务
systemctl stop puppetserver
# 清理缓存目录
rm -rf /opt/puppetlabs/server/data/puppetserver/cache/*
# 重启服务
systemctl start puppetserver

5. 排查层级优先级冲突 #

检查更高层级的配置文件（如nodes/240422-26.yaml或development.yaml）中是否存在同名键pi_cameras.software.controller.pi_camera_without_hat.gpio_blitz，且值被设为undef或空。Hiera层级中优先级更高的文件会覆盖低层级配置，即使使用deep合并策略，若高层级键存在且值为空，也会导致lookup结果不符合预期。

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