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.

Définition des options de configuration après la création de l'environnement

Vous pouvez modifier les paramètres d'option dans un environnement en cours d'exécution en appliquant des configurations enregistrées, en chargeant un nouveau bundle de fichiers source à l'aide des fichiers de configuration (.ebextensions) ou un document JSON. L'interface de ligne de commande (CLI) EB et la console Elastic Beanstalk ont également des fonctionnalités spécifiques client pour définir et mettre à jour des options de configuration.

Lorsque vous définissez ou modifiez une option de configuration, vous pouvez déclencher une mise à jour environnement complet, selon la gravité du changement. Par exemple, des modifications apportées aux options dans aws:autoscaling:launchconfiguration, comme InstanceType, nécessitent que les instances Amazon EC2 dans votre environnement soient réapprovisionnées. Cela déclenche une mise à jour propagée. D'autres changements de configuration peuvent être appliqués sans interruption ou réapprovisionnement.

Vous pouvez supprimer les paramètres d'option à partir d'un environnement avec des commandes de l'interface de ligne de commande (CLI) EB ou de la AWS CLI. La suppression d'une option qui a été définie directement sur un environnement à un niveau d'API autorise des paramètres dans des fichiers de configuration, qui sont autrement masqués par des paramètres appliqués directement dans un environnement, à s'exposer et à prendre effet.

Vous pouvez remplacer les paramètres des configurations enregistrées et des fichiers de configuration en définissant la même option directement au niveau de l'environnement à l'aide de l'une des autres méthodes de configuration. Toutefois, le seul moyen de supprimer complètement ces paramètres consiste à appliquer une nouvelle configuration enregistrée ou un nouveau fichier de configuration. Lorsqu'une option n'est pas définie dans une configuration enregistrée, dans le fichier de configuration, ou directement sur un environnement, la valeur par défaut s'applique, s'il y en a une. Consultez Priorité pour plus de détails.

La console Elastic Beanstalk.

Vous pouvez mettre à jour des paramètres d'option de configuration dans la console Elastic Beanstalk en déployant un bundle de fichiers source d'application qui contient des fichiers de configuration, en appliquant une configuration enregistrée ou en modifiant l'environnement directement avec la page Configuration dans la console de gestion de l'environnement.

Utilisation des fichiers de configuration (.ebextensions)

Mettez à jour les fichiers de configuration dans votre répertoire source, créez un bundle de fichiers source et déployez la nouvelle version dans votre environnement Elastic Beanstalk pour appliquer les modifications.

Pour de plus amples informations sur les fichiers de configuration, veuillez consulter .Ebextensions.

Les modifications apportées aux fichiers de configuration ne remplaceront pas les paramètres d'options dans les configurations enregistrées ou les paramètres appliqués directement à l'environnement au niveau de l'API. Pour plus d'informations, consultez Precedence.

Utilisation d'une configuration enregistrée

Appliquez une configuration enregistrée à un environnement en cours d'exécution pour appliquer des paramètres d'option qu'il définit.

Les paramètres définis dans une configuration enregistrée remplacent les paramètres dans les fichiers de configuration et sont remplacés par les paramètres configurés à l'aide de la console de gestion d'environnement.

Pour de plus amples informations sur la création de configurations enregistrées, veuillez consulter Configurations enregistrées.

Utilisation de la console Elastic Beanstalk

La console Elastic Beanstalk présente beaucoup d'options de configuration sur la page Configuration (Configuration ) de chaque environnement.

Les modifications apportées aux options de configuration dans la console de gestion de l'environnement sont directement appliquées à l'environnement. Ces modifications remplacent les paramètres pour les mêmes options dans les fichiers de configuration ou dans les configurations enregistrées. Pour plus d'informations, consultez Precedence (Priorité).

Pour de plus amples informations sur la modification des options de configuration au niveau d'un environnement en cours d'exécution à l'aide de la console Elastic Beanstalk, veuillez consulter les rubriques sous Configuration d'environnements Elastic Beanstalk.

Interface de ligne de commande (CLI) EB

Vous pouvez mettre à jour les paramètres d'option de configuration avec l'interface de ligne de commande (CLI) EB en déployant le code source qui contient des fichiers de configuration, en appliquant des paramètres à partir d'une configuration enregistrée ou en modifiant la configuration de l'environnement directement avec la commande eb config.

Utilisation des fichiers de configuration (.ebextensions)

Incluez les fichiers .config dans votre dossier de projet sous .ebextensions afin de les déployer avec votre code d'application.

Pour de plus amples informations sur les fichiers de configuration, veuillez consulter .Ebextensions.

~/workspace/my-app/
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- .elasticbeanstalk
|   `-- config.yml
|-- index.php
`-- styles.css

Déployez votre code source avec eb deploy.

~/workspace/my-app$ eb deploy

Utilisation d'une configuration enregistrée

Vous pouvez utiliser la commande eb config pour appliquer une configuration enregistrée à un environnement en cours d'exécution. Utilisez l'option --cfg avec le nom de la configuration enregistrée pour appliquer ses paramètres à votre environnement.

$ eb config --cfg v1

Dans cet exemple, v1 est le nom d'un fichier de configuration enregistré précédemment créé.

Les paramètres appliqués à un environnement avec cette commande remplacent les paramètres qui ont été appliqués au cours de la création de l'environnement et les paramètres définis dans les fichiers de configuration dans le groupe source de votre application.

Utiliser eb config

La commande eb config de l'interface de ligne de commande (CLI) EB vous permet de définir et de supprimer des paramètres d'option directement dans un environnement à l'aide d'un éditeur de texte.

Lorsque vous exécutez eb config, l'interface de ligne de commande (CLI) EB affiche les paramètres appliqués à votre environnement depuis toutes les sources, y compris les fichiers de configuration, les configurations enregistrées, les valeurs recommandées, le jeu d'options directement sur l'environnement et les valeurs par défaut d'API.

L'exemple suivant montre les paramètres appliqués dans l'espace de noms aws:autoscaling:launchconfiguration. Ces paramètres sont les suivants :

ApplicationName: tomcat
DateUpdated: 2015-09-30 22:51:07+00:00
EnvironmentName: tomcat
SolutionStackName: 64bit Amazon Linux 2015.03 v2.0.1 running Tomcat 8 Java 8
settings:
...
aws:autoscaling:launchconfiguration:
    BlockDeviceMappings: null
    EC2KeyName: my-key
    IamInstanceProfile: aws-elasticbeanstalk-ec2-role
    ImageId: ami-1f316660
    InstanceType: t2.micro
...

Définir des options de configuration avec eb config remplace les paramètres de toutes les autres sources.

Vous pouvez également supprimer des options à partir de votre environnement avec eb config.

Supprimer des options de votre environnement avec eb config permet aux paramètres pour les mêmes options de s'exposer depuis les fichiers de configuration dans le groupe source de votre application. Pour plus d'informations, consultez Precedence.

Utiliser eb setenv

Pour définir des propriétés de l'environnement avec l'interface de ligne de commande (CLI) EB, utilisez eb setenv.

~/workspace/my-app/$ eb setenv ENVVAR=TEST
INFO: Environment update is starting.
INFO: Updating environment my-env's configuration settings.
INFO: Environment health has transitioned from Ok to Info. Command is executing on all instances.
INFO: Successfully deployed new configuration to environment.

Cette commande définit les propriétés de l'environnement dans l'aws:elasticbeanstalk:application:environmentespace de noms. Les propriétés d'environnement définies avec eb setenv sont disponibles pour votre application après un court processus de mise à jour.

Affichez les propriétés de l'environnement définies sur votre environnement avec eb printenv.

~/workspace/my-app/$ eb printenv
 Environment Variables:
     ENVVAR = TEST

. AWS CLI

Vous pouvez mettre à jour les paramètres d'option de configuration avec la AWS CLI en déployant une solution groupée source qui contient des fichiers de configuration, en appliquant une configuration enregistrée stockée à distance ou en modifiant l'environnement directement avec la commande aws elasticbeanstalk update-environment.

Utilisation des fichiers de configuration (.ebextensions)

Pour appliquer des fichiers de configuration à un environnement en cours d'exécution avec la AWS CLI, incluez-le dans la solution groupée de fichiers source de l'application que vous téléchargez sur Amazon S3.

Pour de plus amples informations sur les fichiers de configuration, veuillez consulter .Ebextensions.

~/workspace/my-app-v1.zip
|-- .ebextensions
|   |-- environmentvariables.config
|   `-- healthcheckurl.config
|-- index.php
`-- styles.css

Utilisation d'une configuration enregistrée

Vous pouvez appliquer une configuration enregistrée dans un environnement en cours d'exécution avec l'option --template-name sur la commande aws elasticbeanstalk update-environment.

La configuration enregistrée doit être dans votre compartiment Elastic Beanstalk dans un chemin d'accès nommé en fonction de votre application sous resources/templates. Par exemple, le modèle v1 de l'application my-app dans la région USA Ouest (Oregon) (us-west-2) pour le compte n° 123456789012 est disponible à l'emplacement s3://elasticbeanstalk-us-west-2-123456789012/resources/templates/my-app/v1.

Elastic Beanstalk place les configurations enregistrées dans cet emplacement lorsque vous les créez avec aws elasticbeanstalk create-configuration-template. Vous pouvez également modifier les configurations enregistrées localement et les mettre à cet emplacement vous-même.

Utilisation d'options de ligne de commande

Dans cet exemple, as-zero.json définit des options qui configurent l'environnement avec un minimum et un maximum de zéro instance. Cela interrompt les instances dans l'environnement sans mise hors service de ce dernier.

~/ebconfigs/as-zero.json

[
    {
        "Namespace": "aws:autoscaling:asg",
        "OptionName": "MinSize",
        "Value": "0"
    },
    {
        "Namespace": "aws:autoscaling:asg",
        "OptionName": "MaxSize",
        "Value": "0"
    },
    {
        "Namespace": "aws:autoscaling:updatepolicy:rollingupdate",
        "OptionName": "RollingUpdateEnabled",
        "Value": "false"
    }
]

Vous pouvez également supprimer des options à partir de votre environnement avec update-environment.

Supprimer des options de votre environnement avec update-environment permet aux paramètres pour les mêmes options de s'exposer depuis les fichiers de configuration dans le groupe source de votre application. Si une option n'est pas configurée à l'aide d'une de ces méthodes, la valeur par défaut de l'API s'applique, le cas échéant. Pour plus d'informations, consultez Precedence.