Puppet整合Dashboard(一)：Puppet整合Dashboard

江南才子

　　一、安装配置Dshboard
　　1、功能说明

　　Puppet Dasshboard是由支持Puppet开发的公司Puppetlabs创建的，是Ruby on Rails程序；
　　可以作为一个ENC（外部节点分类器）以及一个报告工具，包含许多Puppet新功能的集成界面，例如审计和资源管理功能；
　　能显示Puppet master和agent的相关信息；
　　它能作为一个ENC来配置Puppet节点，并指定这些节点上的类和参数；
　　Puppet Dashboard（1.2.3）程序目前版本只支持Ruby 1.8.x，以及只支持MySQL作为数据库后端。
　　官方配置指南：https://docs.puppetlabs.com/dashboard/manual/1.2/
　　2、安装软件包
　　安装rubygem-rake

[root@puppet ~]# rpm -ivh ftp://rpmfind.net/linux/centos/6.5/os/x86_64/Packages/rubygem-rake-0.8.7-2.1.el6.noarch.rpm
[root@puppet ~]# yum install -y ruby-mysql mysql-server puppet-dashboard

　　3、配置mysql

[root@puppet ~]# service mysqld start
[root@puppet ~]# chkconfig mysqld on
[root@puppet ~]# mysqladmin -uroot password 123456
[root@puppet ~]# mysql -p123456
mysql> create database dashboard character set utf8;
mysql> grant all on dashboard.* to 'dashboard'@'localhost' identified by "123456";
mysql> flush privileges;
mysql> quit
[root@puppet ~]# vi /etc/my.cnf
[mysqld] 
max_allowed_packet=32M 
[root@puppet ~]# service mysqld restart

　　4、配置dashboard

[root@puppet ~]# cd /usr/share/puppet-dashboard/
[root@puppet puppet-dashboard]# vi config/database.yml
production:   
  database: dashboard   
  username: dashboard   
  password: 123456   
  encoding: utf8   
  adapter: mysql
[root@puppet puppet-dashboard]# vi config/settings.yml
time_zone: 'Asia/Shanghai'
[root@puppet puppet-dashboard]# rake gems:refresh_specs
[root@puppet puppet-dashboard]# rake RAILS_ENV=production db:migrate

　　使用合适的表填充数据库,环境变量RAILS_ENV=production告诉Ruby on Rails我们工作在生产环境。

[root@puppet puppet-dashboard]# service puppet-dashboard start

　　5、检查数据
　　查看导入数据：

[root@puppet ~]# mysql -udashboard -p123456
mysql> use dashboard;
mysql> show tables;
+------------------------------+
| Tables_in_dashboard      |
+------------------------------+
| delayed_job_failures     |
| delayed_jobs         |
| metrics            |
| node_class_memberships     |
| node_classes         |
| node_group_class_memberships |
| node_group_edges       |
| node_group_memberships     |
| node_groups          |
| nodes            |
| old_reports          |
| parameters           |
| report_logs          |
| reports            |
| resource_events        |
| resource_statuses      |
| schema_migrations      |
| timeline_events        |
+------------------------------+
18 rows in set (0.00 sec)
mysql> quit

　　查看工作状态：

[root@puppet ~]# cd /usr/share/puppet-dashboard/
[root@puppet puppet-dashboard]# ./script/server -e production
=> Booting WEBrick
=> Rails 2.3.17 application starting on http://0.0.0.0:3000
=> Call with -d to detach
=> Ctrl-C to shutdown server
[2014-11-14 15:36:28] INFO  WEBrick 1.3.1
[2014-11-14 15:36:28] INFO  ruby 1.8.7 (2011-06-30) [x86_64-linux]
[2014-11-14 15:36:28] INFO  WEBrick::HTTPServer#start: pid=36461 port=3000
^C[2014-11-14 15:37:36] INFO  going to shutdown ...
[2014-11-14 15:37:36] INFO  WEBrick::HTTPServer#start done.
Exiting

　　可以看到dashboard默认运行在WEBrick的3000端口，按Ctrl+C关闭服务，下面改成apache运行。
　　
　　二、dashboard整合apache
　　1、配置
　　参考示例：/usr/share/puppet-dashboard/ext/passenger/dashboard-vhost.conf

[root@puppet ~]# vi /etc/httpd/conf.d/dashboard.conf
Listen 8141
<VirtualHost *:8141>
    DocumentRoot /usr/share/puppet-dashboard/public
    <Directory /usr/share/puppet-dashboard/public/>
        Options None
        AllowOverride AuthConfig
        Order allow,deny
        allow from all
    </Directory>
    ErrorLog /var/log/httpd/dashboard.error.log
    LogLevel warn
    CustomLog /var/log/httpd/dashboard.access.log combined
</VirtualHost>

　　不是在配置passenger.conf上面修改，而是新建的专门给dashboard的配置，端口也不一样。

　　2、服务
　　关闭WEBRick使用apache代替

[root@puppet ~]# service puppet-dashboard stop
[root@puppet ~]# service puppetmaster stop
[root@puppet ~]# service httpd restart
[root@puppet ~]# iptables -I INPUT -p tcp --dport 8141 -j ACCEPT
[root@puppet ~]# service iptables save

　　3、检查
　　

　　不能显示页面：http://10.188.1.73:3000/
　　可以正常显示页面：http://10.188.1.73:8141/

[root@puppet ~]# tailf /var/log/httpd/dashboard.access.log

[root@puppet ~]# puppet agent --server puppet.ewin.com --test

　　

　　三、Puppet整合Dashboard
　　1、手动导入

[root@puppet ~]# cd /usr/share/puppet-dashboard/
[root@puppet puppet-dashboard]# rake RAILS_ENV=production reports:import
Importing 13456 reports from /var/lib/puppet/reports in the background
Importing:   100% |#########################################| Time: 00:06:27
13456 of 13456 reports queued

　　puppet报告保存目录/var/lib/puppet/reports/
　　页面左上角“Backgroud Tasks”表示正在等待的任务（将puppet传给http的reports导入dashboard），但没有生效，使用如下命令启动修改：

[root@puppet puppet-dashboard]# env RAILS_ENV=production script/delayed_job -p dashboard -n 1 -m start

　　2、自动导入（整合）
　　（1）Linux客户端配置：

[root@zabbix ~]# vi /etc/puppet/puppet.conf
[agent] 
report = true  #从2.7.0版本开始默认开启

　　（2）Windows客户端配置：

D:\Program Files\Puppet Labs\Puppet\puppet\ext\redhat\puppet.conf
C:\ProgramData\PuppetLabs\puppet\etc\puppet.conf

　　两个配置文件都没有设置report=true但报告正常，待解~~
　　（3）Puppet服务端配置（关键）：

[root@puppet ~]# vi /etc/puppet/puppet.conf
[main] 
reports = http,store      #如果不加上store，将不再在/var/lib/puppet/reports/存储报告
reporturl = http://localhost:8141/reports

　　如果要取消puppet集成dashboard，注消上面两行即可。
　　如果是在puppet服务端直接修改，别忘了提交到SVN，因此建议养成在管理机器上修改的习惯：

[root@puppet ~]# svn ci /etc/puppet/ -m "update reports url"

　　（4）启动服务:

[root@puppet ~]# service httpd restart
[root@puppet ~]# cd /usr/share/puppet-dashboard/
[root@puppet puppet-dashboard]# rake RAILS_ENV=production jobs:work
[Worker(host:puppet.ewin.com pid:61845)] Starting job worker
[Worker(host:puppet.ewin.com pid:61845)] Report.create_from_yaml_file completed after 2.2778
[Worker(host:puppet.ewin.com pid:61845)] Report.create_from_yaml_file completed after 1.0872
[Worker(host:puppet.ewin.com pid:61845)] Report.create_from_yaml_file completed after 1.0863
[Worker(host:puppet.ewin.com pid:61845)] Report.create_from_yaml_file completed after 2.2699 ...

　　  Rake命令使导入报告任务开始运行，运行后可以按Ctrl+C退出，它会在后台自动运行；

[root@puppet puppet-dashboard]# echo "rake RAILS_ENV=production jobs:work" >> /etc/rc.local

　　Rake命令需要加入到开机启动，否则你会发现重启服务器后Dashboard的WEB页面的最新reports不更新了，而且左上角的“Backgroud Tasks”等待任务在不断增加，就是因为这个开机后没运行导致的。
　　3、其他命令
　　优化数据库:

[root@puppet puppet-dashboard]# rake RAILS_ENV=production db:raw:optimize

　　删除报告:

[root@puppet puppet-dashboard]# rake RAILS_ENV=production reports:prune upto=1 unit=mon
Deleting reports before 2014-10-15 08:38 UTC...
Deleted 0 reports.

　　upto=1 unit=mon表示1个月前的报告，可用day表示天。

查看报告:

　　红色表示运行失败
　　橙色表示等待运行
　　蓝色表示运行成功及改变的信息
　　绿色表示运行成功但什么都没做