### 從 CSV 文件導入數據 想要知道更多東西嗎？當你需要從表中查找某些值時，可以使用冗長的 case 語句或 selectors 實現，但更整潔的方式是使用 extlookup 函數實現。 在 puppetmaster 上可以使用 extlookup 函數查詢外部的 CSV 文件，并返回匹配的數據片段。 將所有數據組織到一個單一的文件并將它從 Puppet 配置清單中分離出來， 可以使維護工作變得更簡單，也便于與其他人分享：例如， 一個開發團隊通過部署合適的 CSV 文件作為應用程序發布的一部分， 就可以管理 Puppet 需要知道的有關其應用程序的一切。 Puppet 只需要知道在哪里可以找到這個 CSV 文件，剩下的工作交由 extlookup 去完成。 #### 準備工作 1. 使用如下內容創建 /var/www/apps/common.csv 文件： ``` path,/var/www/apps/%{name} railsversion,3 domain,www.%{name}.com ``` 2. 使用如下內容創建 /var/www/apps/myapp.csv 文件： ``` railsversion,2 ``` #### 操作步驟 1. 在你的配置清單中添加如下代碼： ``` $extlookup_datadir = "/var/www/apps/" $extlookup_precedence = [ "%{name}", "common" ] class app( $name ) { $railsversion = extlookup("railsversion") $path = extlookup("path") $domain = extlookup("domain") notify { "App data: Path ${path}, Rails version ${railsversion}, domain ${domain}": } } class { "app": name => "myapp" } ``` 2. 運行 Puppet： ``` # puppet agent --test info: Retrieving plugin info: Caching catalog for cookbook.bitfieldconsulting.com info: Applying configuration version '1303129760' notice: App data: Path /var/www/apps/myapp, Rails version 2, domain www.myapp.com notice: /Stage[main]/App/Notify[App data: Path /var/www/apps/ myapp, Rails version 2, domain www.myapp.com]/message: defined 'message' as 'App data: Path /var/www/apps/myapp, Rails version 2, domain www.myapp.com' notice: Finished catalog run in 0.58 seconds ``` #### 工作原理 1. 我們做的第一件事是定義一個變量 $extlookup_datadir，它告訴 extlookup 從哪個目錄查找數據文件。你通常會在 site.pp 或者在你設置全局變量的文件中設置這個變量： ``` $extlookup_datadir = "/var/www/apps/" ``` 2. 然后，我們告訴 extlookup 在哪里尋找數據文件，以及尋找的優先順序： ``` $extlookup_precedence = [ "%{name}", "common" ] ``` 這可以是任意長度的數組。當我們生成一個 extlookup 查詢時，Puppet 會按順序掃描每個文件，直到找到請求的值。文件名可以包含變量。 我們期望名為 $name 的變量已經被設置，Puppet 將會使用其值作為要查找的第一個文件名。 3. 下一步，在 app 類中，調用 extlookup 獲得一個值： ``` $railsversion = extlookup("railsversion") ``` 現在 extlookup 裝置查找一個 CSV 文件并從中讀取數據。這個文件保存在 $extlookup_datadir 目錄（在本例中是 /var/www/apps）, 文件名為 %{name}.csv（在本例中是 myapp.csv）。 所以 extlookup 讀取文件的完整路徑是 /var/www/apps/myapp.csv， 此文件包含了 railsversion,2 我們已經找到了所需要的值（2），所以 extlookup 將其返回。 4. 下一個 extlookup 調用就不那么幸運了： ``` $path = extlookup("path") ``` extlookup 還是首先查找文件 myapp.csv，但是它找不到匹配 path 變量的值。 所以會查找 $extlookup_precedence 列表中的下一個文件, 即文件 common.csv： ``` path,/var/www/apps/%{name} railsversion,3 domain,www.%{name}.com ``` 就本例而言返回值為 /var/www/apps/myapp。 你可以看到，這允許我們在 common.csv 文件中設置一個默認值的集合， 每個應用程序都可以選擇其自己的 myapp.csv 文件覆蓋 common.csv 文件中的默認值。 extlookup 會依次查詢列在 $extlookup_precedence 中的文件，直到其找到請求的值。 由于 myapp.csv 被列在首位，所以設置在其中的任何值都優先于文件 common.csv 中的。 #### 更多用法 你也可以在 extlookup 調用中指定默認值，當在所有的 CSV 文件中都沒有找到匹配的數據時就會使用這個默認值： ``` $path = extlookup("path", "/var/www/misc") ``` 你還可以指定在查找 $extlookup_precedence 所列的文件之前首先要查找的 CSV 文件： ``` $path = extlookup("path", "/var/www/misc", "paths") ``` 這首先在 paths.csv 文件中查找數據，如果沒找到，將會依次查找列在 $extlookup_precedence 中的其他文件。 CSV 文件中的值也可以引用變量，正如我們曾經看到的： ``` domain,www.%{name}.com ``` 你可以使用當前范圍內可用的任何變量，包括 Facter 檢測出的 facts 值： ``` domain,%{fqdn} ``` **R.I. Pienaar 的文章 “Complex data and Puppet”** 是對 extlookup 的一個很好的介紹： [http://www.devco.net/archives/2009/08/31/complex_data_and_puppet.php](http://www.devco.net/archives/2009/08/31/complex_data_and_puppet.php) 。 **Jordan Sissel 曾經寫過 “about configuring your whole infrastructure using extlookup”**： [http://sysadvent.blogspot.com/2010/12/day-12-scaling-operabilitywith-truth.html](http://sysadvent.blogspot.com/2010/12/day-12-scaling-operabilitywith-truth.html) 。 #### 參見本書 * 本章的 [導入動態信息](#ch04sec09) 一節 * 第 9 章的 [創建 Facter 的自定義 fact](#ch09sec01) 一節