### 使用 Puppet Dashboard **Puppet Dashboard** 是一個管理 Puppet 安裝的有用的工具，尤其對于大量的安裝， 并且能夠通過一個 Web 界面看到節點的信息和報告。 **Puppet Dashboard** 可以為你顯示最近運行 Puppet 的節點，它們運行了多長時間， 是否有任何節點的錯誤報告，以及是否有一段時間內沒有運行 Puppet 的節點等。 #### 準備工作 1. 從 Puppet Labs 站點 [http://www.puppetlabs.com/misc/download-options/](http://www.puppetlabs.com/misc/download-options/) 下載 Puppet Dashboard 軟件包并解壓縮。 軟件包中有一個安裝說明文件 README.markdown，但你可能需要先安裝以下依賴的包（部分或全部）： ``` # apt-get install -y build-essential irb libmysql-ruby libmysqlclient-dev libopenssl-ruby libreadline-ruby mysql-server rake rdoc ri ruby ruby-dev ``` 2. 為 Puppet Dashboard 應用程序創建一個 MySQL 數據庫和用戶（使用自己的口令）： ``` # mysql -uroot Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 39 Server version: 5.1.41-3ubuntu12.9 (Ubuntu) Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. mysql> create database dashboard; Query OK, 1 row affected (0.00 sec) mysql> grant all on dashboard.* to dashboard@localhost identified by 'topsecret'; Query OK, 0 rows affected (0.01 sec) mysql> flush privileges; Query OK, 0 rows affected (0.00 sec) ``` 3. 復制 Puppet Dashboard 提供的樣例文件 database.yml，并做適當的修改： ``` # cd puppetlabs-puppet-dashboard-071acf4 # cp config/database.yml.example config/database.yml # vi config/database.yml ``` ``` production: database: dashboard username: dashboard password: topsecret encoding: utf8 adapter: mysql ``` 4. 使用應用程序提供的 Rake 任務創建如下的初始化數據庫： ``` # rake RAILS_ENV=production db:migrate ``` #### 操作步驟 1. 啟動內置的 Web 服務器： ``` # script/server -e production => Booting WEBrick => Rails 2.3.5 application starting on http://0.0.0.0:3000 => Call with -d to detach => Ctrl-C to shutdown server [2011-02-21 09:54:32] INFO WEBrick 1.3.1 [2011-02-21 09:54:32] INFO ruby 1.8.7 (2010-01-10) [i486-linux] [2011-02-21 09:54:37] INFO WEBrick::HTTPServer#start: pid=16570 port=3000 Using a web browser, connect to localhost:3000 ``` 2. 如圖所示，你應該看到 Puppet Dashboard 的界面：  3. 現在你需要配置 Puppetmaster 向 Puppet Dashboard 發送報告。 為了實現這個功能，你需要配置 puppet.conf 文件的 reports 參數，為其添加 http 報告： ``` reports = http,log ``` 4. 重新啟動 Puppetmaster 使新配置的報告生效。 5. 在節點上運行 Puppet： ``` # puppet agent --test ``` 6. 在 Puppet Dashboard 界面中單擊 **Nodes** 鏈接。 如圖所示，你應該看到表明 Puppet 運行成功的綠色區域：  #### 工作原理 當在一個節點上運行了 Puppet，它會使用其報告裝置向 Puppet Dashboard 發送報告。 Puppet Dashboard 會存儲這些數據并利用這些數據顯示所有節點上的 Puppet 活動的圖表和摘要。 #### 更多用法 你也可以使用 Puppet Dashboard 創建新的節點或類，并控制哪些節點需要包含哪些類。 實際上，它為你管理 Puppet 配置清單提供了一個 Web 接口， 所以你可以通過 Web 瀏覽器來編輯配置清單，而不是直接修改文本文件。 這是一個有吸引力的功能，尤其用于想讓其他團隊或部門的人能夠管理他們自己的 Puppet 配置時。 為了實現 Puppet Dashboard 的這個功能，你需要配置 Puppet 使用 **external node classifier**； 這將在 [使用外部節點分類器](#ch09sec09) 一節中介紹。 #### 參見本書 * 第 2 章的 [生成報告](#ch02sec01) 一節 * 第 2 章的 [創建圖形化報告](#ch02sec03) 一節 * 本章的 [使用外部節點分類器](#ch09sec09) 一節