Exemple 8 : Gestion des services

Les packages tels que les serveurs d'application ont généralement un service associé qui doit être démarré, arrêtée, redémarré, etc. Par exemple, vous devez commencer le service Tomcat après avoir installé le package ou une fois que l'instance a terminé le démarrage, puis redémarrer le service chaque fois que vous modifiez le fichier de configuration. Cette rubrique présente les bases de la gestion d'un service sur une instance Linux, à l'aide d'un serveur d'application Tomcat à titre d'exemple. La ressource de service fonctionne de la même manière sur les instances Windows, bien qu'il existe quelques différences dans le détail. Pour de plus amples informations, veuillez consulter service.

Définition et démarrage d'un service

Cette section montre les bases de la définition et du démarrage d'un service.

Vous utilisez une ressource service pour gérer un service. La recette par défaut suivante installe Tomcat et démarre le service.

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 recette exécute les tâches suivantes :

L'exemple suivant montre la recette tomcat::service.

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

Cette recette crée la définition du service Tomcat comme suit :

Notez qu'action est définie sur :nothing, une valeur qui indique à la ressource de ne rien faire. La ressource de service prend en charge les actions telles que start et restart. Toutefois, ce livre de recettes suit une pratique standard d'utilisation d'une définition de service qui ne réalise aucune action et de démarrage ou de redémarrage du service ailleurs. Chaque recette qui démarre ou redémarre un service doit d'abord le définir, ce qui signifie que l'approche la plus simple consiste à mettre la définition de service dans une recette distincte et à l'inclure dans les autres recettes en fonction des besoins.

Utilisation de notifies pour démarrer ou redémarrer un service

En règle générale, l'implémentation de production n'utilise pas service pour démarrer ou redémarrer un service. En revanche, elle ajoute notifies à une ressource. Par exemple, si vous souhaitez redémarrer le service après avoir modifié un fichier de configuration, vous incluez notifies dans la ressource template associée. L'utilisation de notifies a les avantages suivants par rapport à l'utilisation d'une ressource service pour redémarrer explicitement le service.

Cet exemple modifie tomcat::default de façon à inclure une ressource template qui utilise notifies pour redémarrer le service. Un exemple réaliste utiliserait une ressource de modèle qui crée une version personnalisée de l'un des fichiers de configuration Tomcat, mais celles-ci sont assez longues et complexes. A des fins de simplicité, l'exemple utilise uniquement le modèle de ressource de Création d'un fichier à partir d'un modèle. Il n'a rien à voir avec Tomcat, mais il offre un moyen simple de montrer comment utiliser notifies. Pour obtenir un exemple de l'utilisation des modèles pour créer des fichiers de configuration Tomcat, consultez Recettes Setup.

La recette suivante utilise notifies pour redémarrer le 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 :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

L'exemple fusionne la recette de Création d'un fichier à partir d'un modèle dans la recette de la section précédente, avec deux modifications importantes :

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