Esempio 8: gestione dei servizi

I pacchetti, ad esempio i server delle applicazioni, in genere hanno associato un servizio che deve essere avviato, arrestato, riavviato e così via. Ad esempio, è necessario avviare il servizio Tomcat dopo l'installazione del pacchetto o dopo il termine del processo di avvio dell'istanza e riavviare il servizio a ogni modifica del file di configurazione. In questo argomento vengono illustrati i concetti di base per la gestione di un servizio su un'istanza Linux, utilizzando un server delle applicazioni Tomcat come esempio. La risorsa service funziona quasi nello stesso modo sulle istanze Windows, anche se vi sono alcune differenze nei dettagli. Per ulteriori informazioni, consulta service.

Definizione e avvio di un servizio

Questa sezione mostra i concetti di base per definire e avviare un servizio.

La gestione del servizio avviene tramite una risorsa service. La seguente ricetta di default installa Tomcat e avvia il servizio.

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 ricetta effettua le seguenti operazioni:

L'esempio seguente illustra la ricetta tomcat::service.

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

Questa ricetta crea la definizione del servizio Tomcat come segue:

Osserva che action è impostato su :nothing, che indica alla risorsa di non eseguire alcuna operazione. La risorsa service supporta azioni quali start e restart. Tuttavia, questo libro di ricette segue una pratica standard: l'utilizzo della definizione di un servizio che non richiede alcun intervento con avvio o riavvio del servizio altrove. Ogni ricetta che avvia o riavvia un servizio deve prima definirlo, perciò l'approccio più semplice è indicare in una ricetta separata la definizione del servizio e includerla in altre ricette in base alle esigenze.

Utilizzo di notifies per avviare o riavviare un servizio

Di solito, le implementazioni di produzione non utilizzano service per avviare o riavviare un servizio. Al contrario, aggiungono notifies a una qualsiasi delle diverse risorse. Ad esempio, se vuoi riavviare il servizio dopo la modifica di un file di configurazione, includi notifies nella risorsa template associata. L'utilizzo di notifies presenta i seguenti vantaggi rispetto all'utilizzo di una risorsa service per il riavvio esplicito del servizio.

In questo esempio viene modificato tomcat::default per includere una risorsa template che utilizza notifies per riavviare il servizio. Un esempio realistico potrebbe utilizzare una risorsa template che crea una versione personalizzata di uno dei file di configurazione Tomcat, che sono però alquanto lunghi e complessi. Per semplicità, l'esempio usa soltanto la risorsa template da Creazione di un file da un modello. Non ha niente a che fare con Tomcat, ma consente di illustrare in modo semplice come utilizzare notifies. Per un esempio che illustri come utilizzare i modelli per creare file di configurazione Tomcat, consulta Ricette di impostazione.

La seguente ricetta utilizza notifies per riavviare il servizio 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'esempio unisce la ricetta di Creazione di un file da un modello e la ricetta della sezione precedente, con due modifiche rilevanti:

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