Remplacement des attributs intégrés

AWS OpsWorks Stacks installe un ensemble de livres de recettes intégrés sur chaque instance. La plupart des livres des recettes intégrés prennent en charge les couches intégrées, et leurs fichiers d'attributs définissent différents paramètres système et des applications par défaut, par exemple les paramètres de configuration du serveur Apache. En mettant ces paramètres dans des fichiers d'attributs, vous pouvez personnaliser de nombreux paramètres de configuration en remplaçant l'attribut intégré correspondant de l'une des façons suivantes :

Cette rubrique décrit comment utiliser un fichier d'attributs de livre de recettes personnalisé pour remplacer les attributs intégrés, à l'aide du serveur Apache à titre d'exemple. Pour plus d'informations sur la façon de remplacer les attributs par des attributs personnalisésJSON, consultezUtilisation de Custom JSON. Pour obtenir des informations générales sur le remplacement des attributs, consultez Remplacement des attributs.

Les attributs intégrés représentent généralement des valeurs dans les fichiers de modèle que les recettes Setup utilisent pour créer des fichiers de configuration. Par exemple, l'une des recettes Setup apache2, default.rb, utilise le modèle apache2.conf.erb pour créer le fichier de configuration principal du serveur Apache, httpd.conf (Amazon Linux) ou apache2.conf (Ubuntu). Voici un extrait du modèle de fichier :

...
#
# MaxKeepAliveRequests: The maximum number of requests to allow
# during a persistent connection. Set to 0 to allow an unlimited amount.
# We recommend you leave this number high, for maximum performance.
#
MaxKeepAliveRequests <%= node[:apache][:keepaliverequests] %>
#
# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
#
KeepAliveTimeout <%= node[:apache][:keepalivetimeout] %>
##
## Server-Pool Size Regulation (MPM specific)
##

...

Le paramètre KeepAliveTimeout de cet exemple est la valeur de l'attribut [:apache][:keepalivetimeout]. La valeur par défaut de cet attribut est définie dans le livre de recettes apache2et son fichier d'attributs apache.rb, comme illustré dans l'extrait suivant :

...
# General settings
default[:apache][:listen_ports] = [ '80','443' ]
default[:apache][:contact] = 'ops@example.com'
default[:apache][:log_level] = 'info'
default[:apache][:timeout] = 120
default[:apache][:keepalive] = 'Off'
default[:apache][:keepaliverequests] = 100
default[:apache][:keepalivetimeout] = 3
...

Pour prendre en charge le remplacement des attributs intégrés, tous les livres de recettes intégrés comportent un fichier d'attributs customize.rb qui est intégré à tous les modules via une directive include_attribute. Les fichiers customize.rb des livres de recettes intégrés ne contiennent aucune définition d'attribut et n'ont aucun effet sur les attributs intégrés. Pour remplacer les attributs intégrés, vous créez un livre de recettes personnalisé avec le même nom que le livre de recettes intégré et vous placez vos définitions d'attributs personnalisés dans un fichier d'attributs également nommé customize.rb. Ce fichier est prioritaire sur la version intégrée et il est inclus dans les modules associés. Si vous définissez les attributs intégrés dans votre fichier customize.rb, ils remplacent les attributs intégrés correspondants.

Cet exemple montre comment remplacer l'attribut intégré [:apache][:keepalivetimeout] pour définir sa valeur sur 5 au lieu de 3. Vous pouvez utiliser une approche similaire pour n'importe quel attribut intégré. Cependant, soyez prudent avec les attributs que vous remplacez. Par exemple, le remplacement des attributs de l'espace de noms opsworks peut entraîner des problèmes pour certaines recettes intégrées.

Pour commencer, créez un livre de recettes personnalisé.

Pour utiliser l'attribut personnalisé, créez une pile et installez le livre de recettes.