### 使用公共模塊
> Plagiarize, plagiarize, plagiarize / Only be sure always to call it, please _research_.
>
> _Lobachevsky_
> — Tom Lehrer
如果你對自己編制的代碼有疑問,使用他人的吧。在許多情況下, 當你要寫一個 Puppet 模塊來管理一些軟件或服務時,不必從頭開始編寫。 對許多流行的應用程序,在 **Puppet Forge** 站點上都提供了社區貢獻的模塊。 有時,一個社區模塊正是你所需要的,你可以下載并馬上開始使用它。 若社區提供的模塊不能滿足你的需求,你可以對其進行一些修改,以適應你的特定需求和環境。
如果你是個 Puppet 的新手,能從一些現有的代碼開始對你將是一個很大的幫助。但另一方面, 社區模塊往往編寫得盡可能通用和便攜,為了實現此目的所需的額外代碼可能使其更難理解。
一般地,在你未閱讀和理解 Puppet Forge 提供的模塊代碼之前, 我建議你不要將其作為 ‘活動的(drop-in)’ 模塊源來部署。 Puppet Forge 提供的模塊為你的 Puppet 基礎設施引入了一個外部的依賴, 但它并不能幫你提升對 Puppet 的理解也不利于提升你使用 Puppet 的經驗。 相反,我會用它作為一個獲取靈感的源泉,從這方面講它還是很有幫助的。 從 Puppet Forge 獲取的模塊應該是一個起點,你可以用它作為基礎,制定和完善自己的模塊。
要知道,一個給定的模塊可能無法在你的 Linux 發行上工作。請檢查模塊自帶的 README 文件,查看這個模塊是否支持你的操作系統。
#### 準備工作
1. 使用 Puppet Forge 模塊的最簡單方法是安裝 puppet-module 工具:
```
# gem install puppet-module
Fetching: puppet-module-0.3.2.gem (100%)
******************************************************************
Thank you for installing puppet-module from Puppet Labs!
* Usage instructions: read "README.markdown" or run `puppetmodule
usage`
* Changelog: read "CHANGES.markdown" or run `puppet-module
changelog`
* Puppet Forge: visit http://forge.puppetlabs.com/
******************************************************************
Successfully installed puppet-module-0.3.2
1 gem installed
Installing ri documentation for puppet-module-0.3.2...
Installing RDoc documentation for puppet-module-0.3.2...
```
2. 運行 puppet-module 查看其可用的任務:
```
# puppet-module
Tasks:
puppet-module build [PATH_TO_MODULE]
# Build amodule for release
puppet-module changelog
# Display the changelog for this tool
puppet-module changes [PATH_TO_MODULE]
# Show modified files in an installed m...
puppet-module clean
# Clears module cache for all repositories
puppet-module generate USERNAME-MODNAME
# Generate boilerplate for a new module
puppet-module help [TASK]
# Describe available tasks or one speci...
puppet-module install MODULE_NAME_OR_FILE [OPTIONS]
# Install a module (eg, 'user-modname')...
puppet-module repository
# Show currently configured repository
puppet-module search TERM
# Search the module repository for a mo...
puppet-module usage
# Display detailed usage documentation ...
puppet-module version
# Show the version information for this...
Options:
-c, [--config=CONFIG] # Configuration file
# Default: /etc/puppet/puppet.conf
```
#### 操作步驟
在本例中,我們將使用 puppet-module 查找并安裝一個管理 Tomcat 應用程序服務器的模塊。
1. 查找合適的模塊:
```
# puppet-module search tomcat
=====================================
Searching http://forge.puppetlabs.com
-------------------------------------
2 found.
--------
camptocamp/tomcat (0.0.1)
jeffmccune/tomcat (1.0.1)
```
2. 在本例中,我們將安裝 Jeff McCune 版本的 tomcat 模塊:
```
# cd /etc/puppet/modules
# puppet-module install jeffmccune/tomcat
Installed "jeffmccune-tomcat-1.0.1" into directory:
jeffmccune-tomcat
```
3. 現在就可以在你的配置清單中使用這個模塊了:查看其源代碼將向你展示這是如何實現的。
#### 工作原理
puppet-module 工具使用簡單地自動化過程從 Puppet Forge 站點搜索和下載模塊。 你也可以瀏覽該網站查詢可用的模塊: [http://forge.puppetlabs.com/](http://forge.puppetlabs.com/) 。
#### 更多用法
并非所有公開可用的模塊都保存在 Puppet Forge 上。其他的存放位置是在 GitHub 上:
* [https://github.com/camptocamp](https://github.com/camptocamp)
* [https://github.com/example42](https://github.com/example42)
Dean Wilson 在他的 Puppet Cookbook 站點: [http://puppetcookbook.com/](http://puppetcookbook.com/) 維護了一個優秀的 Puppet 的倉庫,還包括一些技巧和處方。
- Puppet 2.7 Cookbook 中文版
- 中文翻譯版
- 譯者序
- 項目緣起
- 翻譯方法
- 社區鏈接
- 社區建議
- 貢獻者
- 原書版權頁
- 關于作者
- 前言
- 本書內容
- 閱讀前提
- 適用讀者
- 格式約定
- 讀者反饋
- 客戶支持
- 下載案例代碼
- 勘誤表
- Puppet 基礎設施
- 使用版本控制
- 使用提交鉤子
- 使用 Rake 部署變更
- 配置 Puppet 的文件服務器
- 從 cron 運行 Puppet
- 使用自動簽名
- 預簽名證書
- 從 Puppet 的 filebucket 檢索文件
- 使用 Passenger 擴展 Puppet 的部署規模
- 創建去中心化的分布式 Puppet 架構
- 監控、報告和排錯
- 生成報告
- 通過 Email 發送包含特定標簽的日志信息
- 創建圖形化報告
- 自動生成 HTML 文檔
- 繪制依賴關系圖
- 測試你的 Puppet 配置清單
- 執行模擬運行
- 檢測編譯錯誤
- 理解 Puppet 的錯誤信息
- 顯示命令的輸出結果
- 輸出調試信息
- 檢查配置設置
- 使用標簽
- 使用運行階段
- 使用不同的環境
- Puppet 語言及其寫作風格
- 使用 Puppet 社區規范
- 使用模塊
- 使用標準的命名規范
- 使用嵌入式 Ruby 代碼
- 使用純 Ruby 代碼書寫配置清單
- 遍歷多個項目
- 書寫強大的條件語句
- 在 if 語句中使用正則表達式
- 使用選擇器和 case 語句
- 檢測字符串中是否包含指定的值
- 使用正則表達式替換
- 書寫更優質的配置清單
- 使用資源的數組
- 使用 define 資源
- 指定資源的依賴關系
- 使用節點繼承
- 使用類的繼承和重載
- 給類傳遞參數
- 書寫可重用的跨平臺配置清單
- 獲得系統的環境信息
- 導入動態信息
- 從 CSV 文件導入數據
- 給 Shell 命令傳遞參數
- 使用文件和軟件包
- 為配置文件添加配置行
- 使用 Augeas 自動修改配置文件
- 使用配置片段構建配置文件
- 使用 ERB 模板
- 在模板中遍歷數組
- 從第三方倉庫安裝軟件包
- 配置 APT 軟件倉庫
- 配置 GEM 倉庫
- 從源碼包自動構建軟件
- 比較軟件包的版本
- 用戶和虛擬資源
- 使用虛擬資源
- 使用虛擬資源管理用戶
- 管理用戶基于密鑰的 SSH 訪問
- 管理用戶的自定義文件
- 有效地分發 cron 任務
- 當文件更新時運行命令
- 使用主機資源
- 為文件資源指定多個源
- 使用文件資源遞歸地分發整個目錄樹
- 清理過期的舊文件
- 使用日程表資源
- 資源的審計
- 臨時禁用資源
- 管理時區
- 應用程序
- 管理 Apache 服務
- 創建 Apache 虛擬主機
- 創建 Nginx 虛擬主機
- 創建 MySQL 數據庫及用戶
- 管理 Drupal 站點
- 管理 Rails 應用程序
- 服務器和云基礎設施
- 部署 Nagios 監控服務器
- 使用 Heartbeat 構建高可用服務
- 管理 NFS 服務和文件共享
- 使用 HAProxy 為多個 web 服務器實現負載均衡
- 使用 iptables 管理防火墻
- 管理 Amazon 的 EC2 實例
- 使用 Vagrant 管理虛擬機
- 外部工具和 Puppet 生態環境
- 創建 Facter 的自定義 fact
- 在運行 Puppet 之前和之后執行命令
- 從 Shell 會話生成 Puppet 配置清單
- 從運行的系統上生成 Puppet 配置清單
- 使用 Puppet Dashboard
- 使用 Foreman
- 使用 MCollective
- 使用公共模塊
- 使用外部節點分類器
- 創建自定義的資源類型
- 創建自定義的提供者