Ejemplo 8: Administración de servicios

Normalmente, los paquetes como servidores de aplicaciones tienen un servicio asociado que debe iniciarse, pararse, reiniciarse, etc. Por ejemplo, debe iniciar el servicio Tomcat después de instalar el paquete o después de que la instancia termine de arrancar, y reiniciar el servicio cada vez que modifique el archivo de configuración. En este tema se abordan los aspectos básicos de cómo administrar un servicio en una instancia de Linux, utilizando como ejemplo un servidor de aplicaciones Tomcat. El recurso del servicio funciona prácticamente de la misma manera en las instancias de Windows, aunque haya algunas diferencias de detalle. Para obtener más información, consulte service.

Definición e inicio de un servicio

En esta sección se demuestran los aspectos básicos de cómo definir e iniciar un servicio.

Se utiliza un recurso service para administrar un servicio. La siguiente receta predeterminada instala Tomcat e inicia el servicio.

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

La receta hace lo siguiente:

En el ejemplo siguiente se demuestra la receta tomcat::service.

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

Esta receta crea la definición del servicio Tomcat de la siguiente manera:

Observe que action está establecido en :nothing, lo que indica al recurso que no debe realizar ninguna acción. El recurso de servicio es compatible con acciones como start y restart. Sin embargo, este libro de recetas sigue una práctica estándar de utilizar una definición de servicio que no tiene acción e iniciar o reiniciar el servicio en otro punto. Cada receta que empieza o reinicia un servicio primero debe definirlo, por lo que el enfoque más sencillo es poner la definición del servicio en una receta independiente e incluirla en otras recetas según las necesidades.

Uso de notifies para iniciar o reiniciar un servicio

Por lo general, las implementaciones de producción no utilizan service para iniciar o reiniciar un servicio. En su lugar, añaden notifies a cualquiera de varios recursos. Por ejemplo, si quiere reiniciar el servicio después de modificar un archivo de configuración, incluya notifies en el recurso template asociado. El uso de notifies para reiniciar explícitamente el servicio reporta las siguientes ventajas en comparación con el uso de un recurso service.

En este ejemplo se modifica tomcat::default para incluir un recurso template que utiliza notifies para reiniciar el servicio. Un ejemplo realista utilizaría un recurso de plantilla para crear una versión personalizada de uno de los archivos de configuración de Tomcat, pero son bastante largos y complejos. Para mayor simplicidad, el ejemplo se limita a utilizar el recurso de plantilla de Creación de un archivo a partir de una plantilla. No tiene nada que ver con Tomcat, pero es una forma sencilla de mostrar cómo utilizar notifies. Para ver un ejemplo de cómo utilizar plantillas para crear archivos de configuración de Tomcat, consulte Recetas de instalación.

En la siguiente receta se utiliza notifies para reiniciar el servicio 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

El ejemplo fusiona la receta de Creación de un archivo a partir de una plantilla en la receta de la sección anterior, con dos cambios importantes:

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