puppet- 資源介紹：

• 類型、屬性與狀態同實現方式分離、僅指定目標狀態

  type {'title':attribute => value,...}

• 查看支持的資源類型：

  puppet describe -lpuppet describe -s TYPEpuppet describe TYPE

• 定義資源的要點：

  1、同一種類型中，資源名稱必須惟一；2、資源名稱是否區分大小與取決于OS；

• 獨特屬性：

  package {'nginx':ensure => present,name => nginx,}命名變量：namevar，可省略，默認為title
• 常用類型：package, user, group, file, service, exec, cron, notify

group的常用屬性：

ensure: present, absentname: 組名gid: GIDsystem: 是否為系統組；true, yes; false, no

user的常用屬性：

ensure: present, absentname: 用戶名uid: UIDsystem: 是否為系統用戶；gid: 基本組；groups: 附加組；home: 家目錄；password: 密碼；shell: 默認shell；comment: 注釋信息；expiry: 賬號過期期限 不常用

file的常用屬性：
管理文件從屬關系、權限及其內容。

管理的類型有：

普通文件目錄符號連接等（通過ensure屬性指定）

如果管理普通文件，文件內容可以：

直接用content屬性直接給出，或者用source屬性根據遠程服務器下載生成

如果是目錄：resource屬性+recurse屬性可以遞歸下載目錄
核心屬性：

resource: 可以遞歸下載目錄同時要配合另外一個recurse屬性定義是否遞歸下載構造目錄。recurse: 屬性是布爾型。因此recurse屬性 只有在ensure 屬性為directory時才有意義。content：直接生成的文件內容；source: 通過指定的URL下載文件至目標位置；愿文件路徑，可以是本地文件路徑（單機模型），也可以使用puppet:///modules/module_name/file_name modules指的是模塊路徑，modele_name是模塊名稱ensure: file, directory, link, absent, presenttarget: 符號鏈接文件的鏈接目標；一般當ensure屬性為link時才需要指定此屬性，表示從哪里鏈接，一旦定義target，那么content和source就沒有用了，沒有任何意義。owner: 屬主group: 屬組mode: 權限，支持八進制個石泉縣，以及u,g,o的賦權方式path：目標路徑，指定文件放哪建議使用絕對路徑force: 強制刪除；僅用于ensure為absent時； 不是必須屬性purge: 清除指定目錄中存在的，但是在puppet中未定義的文件；replace：是否替換已經存在的文件；

exec的常用屬性：
運行一外部命令，命令應該具有“冪等性” （可以多次運行，不會損壞結果）

冪等性：1. 命令本身具有 “冪等性”。 （yum update ,apt-get update）2. 資源有onlyif,unless,creates 等屬性以實現命令的條件式運行。onlyif 僅在什么時候執行unless 除非什么條件下執行creates 剛剛創建時執行比如創建目錄/創建文件3. 資源有refreshonly 屬性，實現只有訂閱的資源發生變化時才執行。只有在刷新時運行：只有這個資源依賴的其他資源改變了，這個命令才運行.用于執行命令；但通常僅應該用于必須執行命令才能完成操作時（puppet本身無法完成此功能）；

核心屬性

command: 要執行的命令，通常應該使用絕對路徑；creates：文件。 此屬性跟的文件不存在時才執行命令。加入command 是創建 文件，那么執行的條件是這個文件不存在onlyif：給定測試命令。僅在此命令執行成功即執行狀態碼返回為0，才執行command命令unless：給定測試命令。 和onlyif相反，僅當測試命令執行狀態碼不為0時，才執行command命令cwd: 目錄， 在哪個目錄下運行命令path：為非絕對路徑的命令指定搜索路徑； 類似 環境變量 [path1,path2],如果不定義此屬性，則必須給出命令的絕對路徑。user:group:refresh: 跟命令，默認為收到依賴的資源的事件時會重新執行此命令；但此屬性可以修改此默認行為；（定義命令接收到刷新通知時怎樣操作，跟的也是命令，默認命令在執行一次，可以自定義，加入此命令為創建目錄，當接收到刷新通知時，你可以先刪除在創建。簡單點就時 刷新時執行的命令。）refreshonly: 此資源不會自動被執行，除非被依賴的資源發生了改變；（僅在收到refresh通知時，才運行此資源，布爾型值）returns: 指定狀態返回值；指定期望得到的返回值，當返回非此值時表示命令執行失敗，默認為0， 一般不需要定義tries： 嘗試執行次數 ，默認一次 根據returns 判斷是否成功timeout： 超時時長

notify 最簡單的資源，就是顯示信息

核心屬性message 要發送的消息的內容，還是name/namevalue notify {'title':message => 'something here',}

cron的常用屬性： 定義任務計劃/管理任務計劃

ensure: present, absentcommand: 周期性執行的命令；environment: 定義PATH環境變量；hour:minute:month:monthday:weekday:

package的常用屬性：
管理程序包： 卸載，安裝，升級

ensure：installed, latest，version(2.3.1-2.el7) ,present, absentname: 程序包名稱source：包文件的路徑，可以是本地文件系統路徑，也可以是個url;puppet:///modules/MODULE_NAME/FILENAMEprovider 指定采用哪種方式安裝程序包，如在centos系統中默認采用yum進行安裝。現在想通過rpm進行安裝，安裝的源就是source屬性所指定的文件，那么就必須使用provider屬性 定義成rpm了。所以說 只有當provider 設置了 ，source屬性才有意義。那么又一個實際應用的問題，當你采用rpm進行安裝時，需要解決依賴關系，那么怎么解決依賴關系呢。這時候我們就需要使用exec資源了。yum install指定本地安裝文件，那么會使用本地的rpm包進行安裝，同時又能解決依賴關系。最后你會發現使用exec資源是萬能的。當編譯安裝的時候 還是要采用exec資源進行.其他屬性用的都不多了

范例：

package{'mysql':ensure => installed,provider => msi,source => "D:\mysql\mysql-5.5.45.msi",install_options => {'INSTALLDIR' => 'C:\mysql'},}

service 管理服務的

service的常用屬性：binary: 指定執行文件ensure:true, running 啟動false, stopped 停止enable: 是否開機自動啟動name:服務名稱path: 服務腳本路徑 我們知道，在linux系統下有兩種啟動方式， 一種是直接調用二進制執行文件，另外一種就是用系統中的服務管理命令，比如centos6中的service。所以當你不指定binary文件時，這個path就是指centos系統中的service命令調用哪個執行文件。我們知道一般service管理的服務命令都在/etc/init.d/目錄下。如 /etc/init.d/httpd 文件。另外還有當用service進行管理服務時會有restart,status，start ,stop等選項。但是 puppet 并不知道你有沒有這些命令所以才會有 hasrestart ,hasstop,hasstart, hasstatus屬性，都是布爾值型。當你把這些值設置為false時，服務又有需求接受refresh 刷新后進行restart，那你怎么辦呢。所以又需要我們自己在資源中定義start，stop, restart, status等屬性，屬性值為命令hasrestart: 是否支持restart參數hasstatus: 是否支持status參數pattern: 指明用于搜索此服務相關進程的模式，當腳本不支持restart/status時，用于確定服務是否處于運行狀態。如果你的服務不支持stop,那就需要kill掉進程，那kill 的時候我們知道有的服務啟動的進程有好幾個，就需要匹配需要kill 掉的每個進程的，這個應該也是用patternstart:stop:restart: reloadstatus:

• 資源的特殊屬性：
  元參數：以下四個參數都以其他定義過的的資源作為屬性值，但是寫法必須時Type['title'] 資源類型首字母要大寫

  用于定義資源間的依賴關系

  before => Type['title']require => Type['title']

  用于定義通知通知和訂閱的

  notifysubscribe

  before/require使用舉例

  before代表 當前資源要在某個資源執行之前執行require 當前資源執行需要某一個資源已經執行了還有一種鏈式表示的方法，用 ->表示

  范例

  方法一 before：

  group{'linux':gid => 3000,ensure => present,before => User['suse'],}user{'suse':uid => 3000,gid => 3000,shell => '/bin/shell',home => '/home/suse',ensure => present,}

  方法二 require：

  group{'linux':gid => 3000,ensure => present,}user{'suse':uid => 3000,gid => 3000,shell => '/bin/shell',home => '/home/suse',ensure => present,require => Group['linux'],}

  方法三 -> :

  group{'linux':gid => 3000,ensure => present,} ->user{'suse':uid => 3000,gid => 3000,shell => '/bin/shell',home => '/home/suse',ensure => present,}

notify/subscribe 通知/訂閱舉例

這個用服務舉例，我們知道nginx服務，當配置文件發生變化時，服務經常需要重新加載配置文件或者重啟。puppet agent每隔一段時間去獲取下catelog有無變化，有變化就會將file資源更新，這時service資源就需要執行restart 操作，那么我們首先要知道 puppet 里service資源什么時間會調用restart ，當資源接收到refresh時就會調用restart，那么什么時候會觸發refresh呢？就是當前資源接收到通知 或者 當前資源訂閱的主題有新信息了。

轉載于:https://www.cnblogs.com/zhming26/p/8629946.html

總結

以上是生活随笔為你收集整理的puppet(2)-资源介绍的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。