如何在跨操作系统本地测试时覆盖Facter的OS事实，实现macOS环境下Puppet模块的Hiera查找验证

先纠正你自定义事实里的两个关键语法错误——这正是导致事实没生效的核心原因：

1. 修复自定义事实的语法问题 #

你的os.rb里有两处明显错误：

• 拼写错误：confine :kernal => 'Darwin'里的kernal应该是kernel（少了一个字母'e'）
• 语法错误：has_weight = 1_000不符合Facter的DSL规范，应该写成has_weight 1000（去掉等号）

修复后的完整自定义事实代码（路径保持${module_repository}/.myfacts/os.rb）：

Facter.add(:os) do
  confine :kernel => 'Darwin'
  has_weight 1000
  setcode do
    {
      architecture: 'amd64',
      distro: {
        codename: 'focal',
        description: 'Ubuntu 20.04.3 LTS',
        id: 'Ubuntu',
        release: {
          full: '20.04',
          major: '20.04',
        },
      },
      family: 'Debian',
      hardware: 'x86_64',
      name: 'Ubuntu',
      release: {
        full: '20.04',
        major: '20.04',
      },
      selinux: {
        enabled: false,
      },
    }
  end
end

2. 验证自定义事实是否生效 #

在模块根目录执行以下命令，确认Facter正确加载自定义事实：

facter --custom-dir="./.myfacts" os

此时应该返回你定义的Ubuntu系统事实，而非macOS的默认值。

3. 在PDK控制台中测试Hiera查找 #

要让PDK控制台使用这个自定义OS事实，启动时需指定自定义事实目录：

pdk console --custom-facts-dir="./.myfacts"

进入控制台后，直接测试Hiera查找逻辑即可，比如：

# 替换成你实际要测试的Hiera键名
lookup('your_hiera_key_name')

这样Hiera会基于你覆盖后的os.family、os.distro.id等事实，正确加载data/os/Debian.yaml或对应Ubuntu的数据文件。

额外提示 #

has_weight 1000已经远高于默认事实的优先级（通常低于100），足以覆盖默认的os事实。如果仍不生效，可以尝试将权重调至更高（比如10000），不过一般1000就足够了。

内容的提问来源于stack exchange，提问作者Todd A. Jacobs