使用puppet-r10k模块安装r10k时Ruby版本识别错误求助

问题核心 #

报错中提到的Ruby版本2.7.8.225是Puppet内嵌的Ruby环境版本，而非系统全局的Ruby3.0。因为puppet agent执行gem install时，调用的是/opt/puppetlabs/puppet/bin/gem，绑定的是Puppet自带的独立Ruby环境，和系统全局Ruby完全隔离。

解决方法 #

方法1：指定兼容Ruby2.7的r10k版本 #

最新版r10k依赖的faraday-net_http要求Ruby3.0+，但Puppet内嵌Ruby是2.7，因此需要安装支持Ruby2.7的旧版r10k：

• 在Hiera中添加配置，指定r10k版本：

r10k::install::version: '3.15.0'

（注：3.15.0是目前已知支持Ruby2.7的最高r10k版本，可根据实际情况调整）

• 重新执行puppet agent -t

方法2：手动在Puppet Ruby环境中安装依赖 #

之前安装faraday-net_http用的是系统全局gem，未作用于Puppet的Ruby环境，需针对Puppet内嵌环境操作：

1. 安装指定版本的依赖：

/opt/puppetlabs/puppet/bin/gem install faraday-net_http -v 3.0.2

2. 手动安装r10k：

/opt/puppetlabs/puppet/bin/gem install r10k

3. 再次执行puppet agent -t，此时模块会检测到r10k已安装，跳过安装步骤

方法3：升级Puppet到支持Ruby3+的版本 #

如果长期需要使用最新版r10k，可升级Puppet到内嵌Ruby3.0+的版本（如Puppet 7.20+或Puppet 8系列），升级后即可直接安装最新版r10k。

关键误区说明 #

• 你之前安装faraday-net_http时使用的是系统全局gem命令，未对Puppet的内嵌Ruby环境生效，因此无法解决问题。
• Hiera中的r10k::sources配置属于r10k的部署配置，和安装环节的Ruby版本报错无关，安装完成后该配置才会生效。

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