线上Puppet部署时采用的是版本3.4.3，最近发现客户端经常有一些warning提示，从提示信息看出涉及到跨版本的功能变化，因此对版本进行了一个有计划的升级。
puppetlabs的最新版本为3.6.2。开始升级之前参考了官方的Release Notes(3.5,3.6)和其他人的文档(PUPPET 3.6.1 UPDATES)。
首先将yum仓库同步到yum.puppetlabs.com的最新状态，方便后续使用。
升级分为master和agent两部分，分别进行调整。
master调整
master有两个明显的变化
-
environmentpath支持 - Package模块中引入的
allow_virtual
environmentpath调整
关于environmentpath，配置文件改动比较小，只需修改puppet.conf中的[master]部分
+ environmentpath = $confdir/environments
- modulepath = $confdir/modules:/usr/share/puppet/modules
- manifestdir = $confdir/manifests
早期版本的envorinment支持通过在puppet.conf中额外的[production]和[testing]部分实现。需要删除puppet.conf中自定义的environment部分。
同时需要对目录进行调整，这部分工作量稍大，也在可接受的范围内。以下示例中星号(*)标记的目录对应调整即可。
调整之前目录结构为
.
├── auth.conf
├── autosign.conf
├── puppet.conf
├── manifests
│ ├── production *
│ └── testing *
├── modules
│ ├── production *
│ └── testing *
├── reports
├── ssl
├── var
└── yaml
调整之后目录结构为
.
├── auth.conf
├── autosign.conf
├── puppet.conf
├── environments
│ ├── production
│ │ ├── manifests *
│ │ └── modules *
│ └── testing
│ ├── manifests *
│ └── modules *
├── reports
├── ssl
├── var
└── yaml
allow_virtual调整
这是一个新增的特性，相关背景可参考PDP-897。由于默认值变化，如果不配置agent会收到一个warning信息。
修改environments/production/manifests/site.pp和environments/testing/manifests/site.pp
+ Package {
+ allow_virtual => true,
+ }
软件包升级
通过gem升级安装puppet-3.6.2
gem install puppet --version 3.6.2
安装后重新启动puppet master即可。
agent调整
master端设置的allow_virtual是新增的一个特性，如果agent不支持，会报错，将agent的puppet版本并重启进程即可。
Error: Failed to apply catalog: Invalid parameter allow_virtual
理论上直接升级客户端puppet到3.6.2版本即可完成。不过在升级后发现使用puppet agent --genconfig生成的配置文件仍然会有warning。
Warning: Setting manifest is deprecated in puppet.conf. See http://links.puppetlabs.com/env-settings-deprecations
(at /usr/lib/ruby/site_ruby/1.8/puppet/settings.rb:1067:in `each')
Warning: Setting modulepath is deprecated in puppet.conf. See http://links.puppetlabs.com/env-settings-deprecations
(at /usr/lib/ruby/site_ruby/1.8/puppet/settings.rb:1067:in `each')
Warning: Setting templatedir is deprecated. See http://links.puppetlabs.com/env-settings-deprecations
(at /usr/lib/ruby/site_ruby/1.8/puppet/settings.rb:1071:in `each')
Warning: Setting manifestdir is deprecated. See http://links.puppetlabs.com/env-settings-deprecations
(at /usr/lib/ruby/site_ruby/1.8/puppet/settings.rb:1071:in `each')
直接根据提示取消指定的配置项即可消除警告。这里使用一个脚本进行修改。
#!/bin/bash
for s in manifest modulepath templatedir manifestdir
do
grep "^ $s = " /etc/puppet/puppet.conf
sed -i -e "/^ $s = /s/^/#/" /etc/puppet/puppet.conf
done
使用调整后的配置文件启动puppet agent -t，可以看到成功运行并且不再有warning。