範例 8：管理服務

應用程式伺服器等套件，通常會有相關聯的服務，必須啟動、停止、重新啟動等等。例如，在安裝套件或執行個體完成開機之後，您需要啟動 Tomcat 服務，每次修改組態檔案後也要重新啟動服務。本主題以 Tomcat 應用程式伺服器為例，討論如何在 Linux 執行個體上管理服務的基本概念。細節上雖有一些差異，但 service 資源的作用在 Windows 執行個體上極其相似。如需詳細資訊，請參閱service。

定義及啟動服務

本節說明如何定義及啟動服務的基本概念。

您要使用 service 資源管理服務。下列預設配方安裝 Tomcat 並啟動服務。

execute "install_updates" do
  command "apt-get update"
end

package "tomcat7" do
    action :install
end

include_recipe 'tomcat::service'

service 'tomcat' do
  action :start
end

配方會執行下列動作：

下列範例顯示 tomcat::service 配方。

service 'tomcat' do
  service_name "tomcat7"
  supports :restart => true, :reload => false, :status => true
  action :nothing
end

此配方會建立 Tomcat 服務定義，如下所示：

請注意，action 設為 :nothing，指示資源不採取任何動作。服務資源不支援 start 和 restart 等動作。不過，此技術指南會遵循使用服務定義的標準實務，不採取任何動作，在其他位置啟動或重新啟動服務。每個啟動或重新啟動服務的配方，都必須先行定義，以便使用最簡單的方法將服務定義放在不同的配方中，並視需要將其包含在其他配方中。

使用通知來啟動或重新啟動服務

生產實作通常不使用 service 啟動或重新啟動服務。而是將 notifies 新增到數個資源之中的任一個。例如，如果您想要在修改組態檔案後重新啟動服務，請將 notifies 包含在相關聯的 template 資源中。使用 notifies 明確重新啟動服務，比使用 service 資源的更有優勢，如下所示。

此範例會修改 tomcat::default 以包含 template 資源，使用 notifies 重新啟動服務。實際範例會使用範本資源建立其中一個 Tomcat 組態檔案的自訂版本，但這些檔案又長又複雜。為求簡化，此範例只使用從範本建立檔案中的範本資源。它和 Tomcat 沒有任何關係，但會提供簡單的方式，示範如何使用 notifies。如需如何使用範本建立 Tomcat 組態檔案的範例，請參閱安裝配方。

下列配方使用 notifies 重新啟動 Tomcat 服務。

execute "install_updates" do
  command "apt-get update"
end

package "tomcat7" do
    action :install
end

include_recipe 'tomcat::service'

service 'tomcat' do
  action :enable
end

directory "/srv/www/shared" do
  mode 0755
  owner 'root'
  group 'root'
  recursive true
  action :create
end

template "/srv/www/shared/example_data.json" do
  source "example_data.json.erb"
  mode 0644
  variables(
    :a_boolean_var => true,
    :a_string_var => "some string"
  )
  only_if {node['createfile']['install_file']}
  notifies :restart, resources(:service => 'tomcat')
end

此範例將從範本建立檔案中的配方合併到上一節的配方，有兩大變更：

execute 'trigger tomcat service restart' do
  command 'bin/true'
  notifies :restart, resources(:service => 'tomcat')
end