License: Attribution-NonCommercial-ShareAlike 4.0 International
本文出自 Suzf Blog。 如未注明，均为 SUZF.NET 原创。
转载请注明：http://suzf.net/post/101
Puppet Dasshboard是由支持Puppet开发的公司Puppetlabs创建的，是Ruby on Rails程序。可以作为一个ENC（外部节点分类器）以及一个报告工具，并且正在逐渐成为一个包含许多Puppet新功能的集成界面，例如审计和资源管 理功能。 Puppet Dashboard是一个Ruby on Rails程序，用于显示Puppet master和agent的相关信息。它允许你查看从一个或多个Puppet master汇总的图形和报告数据。它同时从一个或者多个Puppet master上收集来自于Puppet agent的资产数据（主机的Fact和其他信息）。最后，它能作为一个ENC来配置Puppet节点，并指定这些节点上的类和参数。
参考文档：
http://kisspuppet.com/2014/10/20/puppet_learning_ext8/
http://ruby-on-rails-book.kejyun.com/install/install-passenger.html
1 前期准备工作
Puppet Dashboard（1.2.3）程序目前版本只能安装在Ruby 1.8.x（Dashboard还不能工作在1.9.x下或者更新的版本下），只支持MySQL作为数据库后端。
Rake version 0.8.3 or newerMySQL database server version 5.xRuby-MySQL bindings version 2.7.x or 2.8.x
备注：更多详细信息请参考：http://docs.puppetlabs.com/dashboard/
2 安装相关软件包
# yum install ruby-mysql mysql-server puppet-dashboard
3 配置Dashboard（包括与数据库的结合部分）
3.1 创建管理Dashboard的MySQL数据库账号并授权
# /etc/rc.d/init.d/mysqld restart
# chkconfig mysqld on
# mysqladmin -uroot password xxx
#mysql uroot -p
mysql> create database dashboard_production character set utf8;
mysql> grant all on dashboard_production.* to 'dashboard'@'localhost' identified by "xxxx";
mysql> flush privileges;
#测试账号是否创建成功
mysql -udashboard -p -e "show processlist";
3.2 优化数据库配置文件my.cnf
# vim /etc/my.cnf
[mysqld]
# Allowing 32MB allows an occasional 17MB row with plenty of spare roommax_allowed_packet = 32M
# /etc/rc.d/init.d/mysqld restart #重启MySQL生效
3.3 编辑dashboard YAML配置文件（database.yml）来指定数据库
# vim /usr/share/puppet-dashboard/config/database.yml
production:
database: dashboard_production
username: dashboard
password: xxx
encoding: utf8 adapter: mysql
...
3.4 填充数据库
# cd /usr/share/puppet-dashboard/
# rake gems:refresh_specs
# rake RAILS_ENV=production db:migrate
#环境变量RAILS_ENV=production告诉Ruby on Rails我们工作在生产环境。每次你运行一个rake命令都需要使用合适的环境值来设置RAILS_ENV环境变量
3.5 查看是否导入成功
4 启动并运行Dashboard（WEBrick方式）
WEBrick有助于快速使用Dashboard，不过它不能很好地进行扩展，并且当有许多Puppet agent向Dashboard进行报告时，它的性能会非常差，因此不推荐使用。
4.1 关闭httpd服务
# /etc/rc.d/init.d/httpd stop #之前配置过使用httpd运行puppetmaster，需要关闭
4.2 启动puppetmaster服务
# /etc/rc.d/init.d/puppetmaster start
4.3 启动puppet-dashboard服务
# /etc/rc.d/init.d/puppet-dashboard start #启动dashboard Starting Puppet Dashboard: => Booting WEBrick=> Rails 2.3.17 application starting on http://0.0.0.0:3000 [ OK ]
4.4 通过浏览器访问http://172.16.7.81:3000
5 启动并运行Dashboard（Passenger方式）
5.1 使用Ruby Gem安装Passenger
# yum install ruby-devel ruby-libs rubygems libcurl-devel# yum install httpd httpd-devel apr-util-devel apr-devel mod_ssl
# gem install passenger
# passenger-install-apache2-module
注：安装过程会检查所需要的依赖包，若果发生错误，请按照passenger的提示安装
我这里缺少OpenSSL包，所以需要再重新安裝
# yum install openssl-devel -y
重新安装后再次执行passenger-install-apache2-module 安裝 Apache Passenger 套件即可，安装的过程需要编译apache 套件，所以需要一些时间
5.2 配置虚拟主机和passenger
# vim /etc/httpd/conf.d/passenger.conf
LoadModule passenger_module /usr/lib/ruby/gems/1.8/gems/passenger-4.0.19/buildout/apache2/mod_passenger.so
PassengerRoot /usr/lib/ruby/gems/1.8/gems/passenger-4.0.19
PassengerRuby /usr/bin/ruby PassengerHighPerformance on
PassengerMaxPoolSize 12
PassengerPoolIdleTime 1500
PassengerStatThrottleRate 120
# RailsAutoDetect On
Listen 8141
DocumentRoot "/usr/share/puppet-dashboard/public/"
<directory "/usr/share/puppet-dashboard/public/">
Options None AllowOverride AuthConfig
Order allow,deny
allow from all
ErrorLog /var/log/httpd/dashboard.error.log
LogLevel warn
CustomLog /var/log/httpd/dashboard.access.log combined
5.3 启动相关服务
# /etc/rc.d/init.d/puppetmaster stop #停掉puppetmaster服务Stopping puppetmaster: [ OK ]# /etc/rc.d/init.d/httpd restart
5.4 通过浏览器访问测试
http://172.16.7.81:8141/
6 集成Puppet Dashboard
6.1 手工导入现有的报告（方式一）
# cd /usr/share/puppet-dashboard/# rake RAILS_ENV=production reports:import #导入已经存在的报告
备注：默认节点报告会在/var/lib/puppet/reports/ 产生，如果路径发生变化，导入报告时需要在后面加上“REPORT_DIR=report路径”，reports更改路径可在puppet.conf中设置参数“reportdir = 新路径”，这种方式不够实时。
6.2 配置实施汇总puppet报告（方式二）
# 配置agent节点自动发送报告
[root@agent1 ~]# vim /etc/puppet/puppet.conf [agent]report = true #从2.7.0版本开始，报告系统会默认开启，不需要配置…
# 配置master 报告汇总[root@master puppet-dashboard]# vim /etc/puppet/puppet.conf[main] reports = http
reporturl = http://172.16.7.81:8141/reports
#定义为http报告处理器，除此之外还有store，log，tagmail，rrdgraph等报告处理器
#http报告处理器将puppet报告发送到一个HTTP URL和端口（Dashboard位置）。Puppet报告以被转储为HTTP Poort形式的YAML格式进行发送。 [root@master ~]# /etc/rc.d/init.d/httpd restart
6.3 开启后台处理报告进程
#运行“Delayed Job Workers”，使其在后台为我们处理报告日志
[root@master puppet-dashboard]# rake RAILS_ENV=production jobs:work &[1] 20577
6.4 修改dashboard时区【master】
Dashboard默认时区为UTC格式，我们这里需要更改为CST（Asia/Shanghai）格式
# vim /usr/share/puppet-dashboard/config/settings.yml
time_zone: 'Asia/Shanghai'…**备注**：设置的settings.yml会覆盖掉config/environment.rb中对应的配置项（config.time_zone = 'UTC'）
#/etc/init.d/httpd restart
6.5 显示报告
通过http://172.16.7.81:8141及时查看节点更新的报告信息，可以看到两个节点，默认显示时间为CST格式，除此之外还可以看到某一个节点在某一个时刻的更新报告和运行曲线图。
6.6 删除报告
删除一个前的报告
[root@master puppet-dashboard]# rake RAILS_ENV=production reports:prune upto=1 unit=mon
删除一天前的报告
[root@master puppet-dashboard]# rake RAILS_ENV=production reports:prune upto=1 unit=day
删除效果如下：
7 自定义报告
7.1 编写外部报告处理器
使用现有的被存储的报告，就是那些yaml文件，可以通过设置puppet.conf中reports = store进 行收集。然后编写一个外部的处理器来处理这些信息，例如绘图或者将他们存储在外部数据库。这也是Puppet Dashboard中的报告输入进程的工作原理。这些外部的报告处理器可以很简单地使用Ruby进行编写，以便使用Ruby反序列化YAML文件的能力以 及使用生成的对象。你可以使用任何支持导入第三方ymal数据的工具。
7.2 编写内部报告处理器
编写自定义报告处理器并将它添加到Puppet。和fact、函数、类型及提供者的插件不同，Puppet没有提供一个自动分发自定义报告的方法。
7.2.1 现有报告处理器信息
7.2.2 自定义摘要报告处理器
7.2.2.1 进入reports目录编写自定义summary.rb报告处理器
# cd /usr/lib/ruby/site_ruby/1.8/puppet/reports
# vim summary.rbrequire
'puppet'Puppet::Reports.register_report(:summary)
do desc < ] 1 / 1agent1.kisspuppet.com : OK {:summary=> "Started a background Puppet run using the 'puppet agent --onetime --daemonize --color=false --splay --splaylimit 30' command"}---- rpc stats ---- Nodes: 1 / 1 Pass / Fail: 1 / 0 Start Time: Fri Oct 04 12:54:50 +0800 2013 Discovery Time: 2005.27ms Agent Time: 1118.41ms Total Time: 3123.68ms
7.2.2.4 查看新生成的报告信息
# cd /var/lib/puppet/reports/agent1.jeffery.com/# cat summary.txt Changes: Total: 1Events: Total: 1 Success: 1Resources: Out of sync: 1 Changed: 1 Total: 15 Skipped: 6Time: Filebucket: 0.00 Package: 0.00 File: 0.11 Service: 0.12 Config retrieval: 1.29 Total: 1.52 Last run: 1380861882Version: Config: 1380861878 Puppet: 2.7.23
在整个报告处理器中，我们定义了一个叫做process的方法来承载处理器的核心逻辑。我们从报告中提取了一些信息：使用self.host方式提取了主机名，使用summary方式提取了变更的摘要。还可以使用self.logs和self.metrics方式来访问报告中的日子以及度量值。 我们同时还将报告的摘要输出了报告目录下对应的以Puppet agent主机名命名的目录中，报告目录的位置是由reportdir配置的值来指定的，默认在/var/lib/puppet/reports/目录下。
备注：更多报告处理器信息请访问
现有报告处理器https://github.com/puppetlabs/puppet/tree/master/lib/puppet/reports报告参考 http://docs.puppetlabs.com/references/latest/report.html#http 报告及报告系统 http://docs.puppetlabs.com/guides/reporting.html
