### 使用日程表資源 使用啟用了 schedule 參數的資源，你可以控制當前資源何時被應用。 例如，你希望如下的 exec 資源每天應用一次，將資源參數 schedule 設置成了內置的值 daily： ``` exec { "/usr/bin/apt-get update": schedule => daily, } ``` 遺憾的是，給 schedule 參數指定 daily 并不能保證該資源每天都能應用一次。 內置的 daily 僅能限制 exec 資源在一天之內不能被應用多余一次， 但是資源是否被應用以及何時被應用完全取決于 Puppet 是否運行以及何時運行。 正因為如此，使用 schedule 資源才是安排執行其他資源的最佳選擇。例如， 你可能想要確保 apt-get update 一小時內運行不超過一次； 或者確保一項維護工作在白天生產時間期間不被執行。 為此，你需要創建自己的 schedule 資源。 #### 操作步驟 1. 添加如下代碼到你的配置清單： ``` schedule { "not-in-office-hours": period => daily, range => [ "17:00-23:59", "00:00-09:00" ], repeat => 1, } exec { "/bin/echo Doing maintenance!": schedule => "not-in-office-hours", } ``` 2. Run Puppet。 #### 工作原理 我們創建了名為 not-in-office-hours 的 schedule，它指定了重復周期為 daily, 且指定了允許的時間范圍為下午 5 點到次日早上 9 點： ``` period => daily, range => [ "17:00-23:59", "00:00-09:00" ], ``` 我們同時設置了在每個時間周期內資源被應用的最大次數為 1： ``` repeat => 1, ``` 然后，我們在如下的 exec 資源中使用這個自定義的 schedule： ``` exec { "/bin/echo Doing maintenance!": schedule => "not-in-office-hours", } ``` 若 exec 資源不使用 schedule 參數，每次運行 Puppet，這個 exec 資源就會被應用一次。 現在，Puppet 將依照 not-in-office-hours 資源的設置做如下測試： * 當前時間是否在允許的范圍內 * 在一個重復周期內，資源是否已經應用到了允許的最大次數 例如，讓我考察在如下連續的幾個小時內如果 Puppet 每小時執行一次將會發生什么： * 4 p.m.：超出了允許的時間范圍，所以 Puppet 不會做任何事情。 * 5 p.m.：在允許的時間范圍內，且在此重復周期內還沒有運行過，所以 Puppet 會應用此資源。 * 6 p.m.：在允許的時間范圍內，且在此重復周期內已經運行過一次，由于已經到達了 repeat 設置的最大值，所以 Puppet 不會做任何事情。 依此類推，直到第二天再重復這一過程。 #### 更多用法 如果需要，你可以增大 repeat 參數的值，例如：在每小時內運行一個作業不超過 6 次： ``` period => hourly, repeat => 6, ``` 要記住這不能保證每個小時此作業都會運行 6 次。這只是設置了一個上限。 無論 Puppet 經常運行還是會發生其他情況，如果一個小時內已經運行了 6 次就不會再次運行。 如果 Puppet 每天僅執行一次，那么這個作業也僅執行一次。 因此，要確保某事件在特定的時間 **不會** 發生（或者 **不** 超過給定的頻率），使用 schedule 是最有用的。