Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Recettes Configure

Les recettes Configure sont affectées à l'événement de cycle de vie Configure de la recette, qui se produit sur toutes les instances de la pile chaque fois qu'une instance entre ou quitte l'état « en ligne » (online). Vous utilisez les recettes Configure pour ajuster la configuration d'une instance afin de répondre à la modification, le cas échéant. Lorsque vous implémentez une recette Configure, gardez à l'esprit qu'une modification de configuration de la pile peut impliquer des instances qui n'ont rien à voir avec la couche. La recette doit être capable de répondre de manière appropriée, ce qui peut signifier de ne rien faire dans certains cas.

tomcat::configure

La recette tomcat::configure est destinée à l'événement de cycle de vie Configure d'une couche.

include_recipe 'tomcat::context'
# Optional: Trigger a Tomcat restart in case of a configure event, if relevant
# settings in custom JSON have changed (e.g. java_opts/JAVA_OPTS):
#include_recipe 'tomcat::container_config'

La recette tomcat::configure est en gros une méta-recette qui exécute deux recettes dépendantes.

Le code include pour tomcat::container_config est mis en commentaire dans cet exemple. Si vous souhaitez utiliser le mode personnalisé JSON pour modifier les paramètres Tomcat, vous pouvez supprimer le commentaire. Un événement du cycle de vie Configure exécute alors tomcat::container_config, qui met à jour les fichiers de configuration Tomcat associés, comme décrit dans tomcat::container_config et redémarre le service Tomcat.

tomcat::context

Le livre de recettes Tomcat permet aux applications d'accéder à un serveur My SQL database, qui peut être exécuté sur une instance distincte, à l'aide d'un objet DataSourceJ2EE. Avec Tomcat, vous pouvez activer la connexion en créant et en installant un fichier de configuration du contexte de l'application web pour chaque application. Ce fichier définit la relation entre l'application et la JDBC ressource que l'application utilisera pour communiquer avec la base de données. Pour plus d'informations, consultez The Context Container.

La recette tomcat::context a pour objectif principal de créer ce fichier de configuration.

include_recipe 'tomcat::service'

node[:deploy].each do |application, deploy|
  context_name = deploy[:document_root].blank? ? application : deploy[:document_root]

  template "context file for #{application} (context name: #{context_name})" do
    path ::File.join(node['tomcat']['catalina_base_dir'], 'Catalina', 'localhost', "#{context_name}.xml")
    source 'webapp_context.xml.erb'
    owner node['tomcat']['user']
    group node['tomcat']['group']
    mode 0640
    backup false
    only_if { node['datasources'][context_name] }
    variables(:resource_name => node['datasources'][context_name], :webapp_name => application)
    notifies :restart, resources(:service => 'tomcat')
  end
end

Outre les attributs du livre de recettes Tomcat, cette recette utilise les attributs de configuration et de déploiement de la pile qui AWS OpsWorks Stacks s'installe avec l'événement Configure. Le AWS OpsWorks Le service Stacks ajoute des attributs à l'objet nœud de chaque instance qui contiennent les informations que les recettes obtiendraient généralement en utilisant des sacs de données ou en effectuant une recherche et installe les attributs sur chaque instance. Les attributs contiennent des informations détaillées sur la configuration de la pile, les applications déployées et les données personnalisées qu'un utilisateur souhaite inclure. Les recettes peuvent obtenir les données à partir des attributs de configuration et de déploiement de pile en utilisant la syntaxe de nœud Chef standard. Pour de plus amples informations, veuillez consulter Attributs de déploiement et de configuration de pile. Avec les piles Chef 11.10, vous pouvez également utiliser la recherche Chef pour obtenir les données de configuration et de déploiement de pile. Pour de plus amples informations, veuillez consulter Utilisation de Chef Search.

deployattributes fait référence à l'[:deploy]espace de noms, qui contient les attributs liés au déploiement définis via la console ou générés API par le AWS OpsWorks Service Stacks. L'attribut deploy inclut un attribut pour chaque application déployée, nommé d'après le nom court de l'application. Chaque attribut d'application contient un ensemble d'attributs qui caractérisent l'application, tels que la racine du document ([:deploy][:appname][:document_root]).

La recette context s'assure d'abord que le service est défini pour l'exécution Chef en appelant tomcat::service. Elle définit ensuite une variable context_name qui représente le nom du fichier de la configuration, à l'exception de l'extension .xml. Si vous utilisez la racine du document par défaut, context_name est défini comme nom court de l'application. Sinon, il est défini sur la racine du document spécifié. L'exemple décrit dans Créer une pile et exécuter une application définit la racine du document sur"ROOT", donc le contexte est ROOT et le fichier de configuration est nomméROOT.xml.

La majeure partie de la recette parcourt la liste des applications déployées et, pour chaque application, utilise le modèle webapp_context.xml.erb pour créer un fichier de configuration du contexte. L'exemple ne déploie qu'une seule application, mais la définition de l'attribut deploy requiert que vous la traitiez comme une liste d'applications quelles qu'elles soient.

Comme le modèle webapp_context.xml.erb n'est pas spécifique au système d'exploitation, il se trouve dans le sous-répertoire templates du répertoire default.

La recette crée le fichier de configuration comme suit :

Le modèle webapp_context.xml.erb se compose d'un élément Context qui contient un élément Resource avec son propre ensemble d'attributs.

Les Resource attributs caractérisent la configuration du contexte :

Pour plus d'informations sur ce fichier de configuration, consultez la DataSources rubrique Utilisation du wiki Tomcat.