示例 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 配置文件的自定义版本，但是这些文件相当长且复杂。为简便起见，该示例仅使用来自从模板创建文件的模板资源。它与 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

该示例将来自从模板创建文件的配方合并到前一节的配方中，其中包含如下两个重大更改：

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