例 8: 管理サービス

通常、アプリケーションサーバーなどのパッケージには、開始、停止、再起動などを行う必要がある関連サービスがあります。たとえばパッケージをインストールしたりインスタンスの起動が完了した後は Tomcat サービスを開始する必要があり、また設定ファイルを変更するたびにこのサービスを再起動する必要があります。このトピックでは、例として Tomcat アプリケーションサーバーを使用し、Linux インスタンスでのサービスの管理方法の基礎を説明します。サービスリソースは、詳細に多少の違いはあるものの、多くの 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 設定ファイルの 1 つをカスタマイズしたバージョンを作成しますが、それは非常に長く複雑なものになります。わかりやすいように、例では「テンプレートからのファイルの作成」のテンプレートリソースを使用します。Tomcat とは関係ありませんが、notifies の使用方法をわかりやすく説明できます。テンプレートを使用して Tomcat の設定ファイルを作成する方法の例は、「Setup レシピ」を参照してください。

以下のレシピは 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

この例は、「テンプレートからのファイルの作成」のレシピを前述のセクションのレシピにマージします。2 つの大幅な変更があります。

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