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`](command-options-general.md#command-options-general-autoscalinglaunchconfiguration), comme `InstanceType`, nécessitent que les instances Amazon EC2 dans votre environnement soient réapprovisionnées. Cela déclenche une [mise à jour propagée](using-features.rollingupdates.md). D'autres changements de configuration peuvent être appliqués sans interruption ou réapprovisionnement.
Vous pouvez supprimer les paramètres des options d'un environnement à l'aide de la CLI ou de AWS CLI commandes EB. 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é](command-options.md#configuration-options-precedence) pour plus de détails.
**Topics**
+ [La console Elastic Beanstalk.](#configuration-options-after-console)
+ [Interface de ligne de commande (CLI) EB](#configuration-options-after-ebcli)
+ [Le AWS CLI](#configuration-options-after-awscli)
## 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.
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-after-console-ebextensions)
+ [Utilisation d'une configuration enregistrée](#configuration-options-after-console-savedconfig)
+ [Utilisation de la console Elastic Beanstalk](#configuration-options-after-console-configpage)
### 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](ebextensions.md).
**Pour déployer un groupe source**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Sur la page de présentation de l'environnement, choisissez **Upload and deploy (Charger et déployer)**.
1. Utilisez la boîte de dialogue à l'écran pour charger le bundle source.
1. Choisissez **Deploy (Déployer)**.
1. Lorsque le déploiement est terminé, vous pouvez sélectionner l'URL de site pour ouvrir votre site web dans un nouvel onglet.
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](command-options.md#configuration-options-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.
**Pour appliquer une configuration enregistrée à un environnement en cours d'exécution (console Elastic Beanstalk)**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Applications**, puis sélectionnez le nom de votre application dans la liste.
1. Dans le volet de navigation, recherchez le nom de votre application et choisissez **Saved configurations (Configurations enregistrées)**.
1. Sélectionnez la configuration enregistrée à appliquer, puis choisissez **Load (Charger)**.
1. Sélectionnez un environnement, puis **Charge**.
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](environment-configuration-methods-before.md#configuration-options-before-savedconfig).
### 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.
**Pour modifier les options de configuration dans un environnement en cours d'exécution (console Elastic Beanstalk)**
1. Ouvrez la console [Elastic Beanstalk](https://console.aws.amazon.com/elasticbeanstalk), puis **dans la liste des régions, sélectionnez votre**. Région AWS
1. Dans le panneau de navigation, choisissez **Environments** (Environnements), puis choisissez le nom de votre environnement dans la liste.
1. Dans le panneau de navigation, choisissez **Configuration**.
1. Recherchez la page de configuration que vous souhaitez modifier :
+ Si vous voyez l'option qui vous intéresse, ou que vous savez à quelle catégorie de configuration elle appartient, choisissez **Edit (Modifier)** dans sa catégorie de configuration.
+ Pour rechercher une option, activez la **Table View** (Vue Table), puis saisissez vos termes de recherche dans la zone de recherche. À mesure que vous saisissez du texte, la liste se réduit et affiche uniquement les options qui correspondent à vos termes de recherche.
Lorsque vous voyez l'option que vous recherchez, choisissez **Edit (Modifier)** dans la catégorie de configuration qui la contient.
1. Modifiez les paramètres, puis choisissez **Enregistrer**.
1. Si vous souhaitez modifier d'autres catégories de configuration, répétez les deux étapes précédentes.
1. Choisissez **Apply**.
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](command-options.md#configuration-options-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](customize-containers.md).
## 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**.
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-after-ebcli-ebextensions)
+ [Utilisation d'une configuration enregistrée](#configuration-options-after-ebcli-savedconfig)
+ [Utiliser **eb config**](#configuration-options-after-ebcli-ebconfig)
+ [Utiliser **eb setenv**](#configuration-options-after-ebcli-ebsetenv)
### 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](ebextensions.md).
```
~/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éé](environment-configuration-methods-before.md#configuration-options-before-savedconfig).
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.
**Note**
**eb config** n'affiche pas les propriétés de l'environnement. Pour définir les propriétés de l'environnement que vous pouvez lire à partir de votre application, utilisez [**eb setenv**](#configuration-options-after-ebcli-ebsetenv).
L'exemple suivant montre les paramètres appliqués dans l'espace de noms `aws:autoscaling:launchconfiguration`. Ces paramètres sont les suivants :
+ Deux valeurs recommandées, pour `IamInstanceProfile` et `InstanceType`, appliquées par l'interface de ligne de commande (CLI) EB lors de la création de l'environnement.
+ L'option `EC2KeyName`, définie directement sur l'environnement lors de la création selon la configuration du référentiel.
+ Les valeurs d'API par défaut pour les autres options.
```
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
...
```
**Pour définir ou modifier les options de configuration avec **eb config****
1. Exécutez **eb config** pour afficher la configuration de votre environnement.
```
~/workspace/my-app/$ eb config
```
1. Modifiez toutes valeurs de paramètre à l'aide de l'éditeur de texte par défaut.
```
aws:autoscaling:launchconfiguration:
BlockDeviceMappings: null
EC2KeyName: my-key
IamInstanceProfile: aws-elasticbeanstalk-ec2-role
ImageId: ami-1f316660
InstanceType: {{t2.medium}}
```
1. Enregistrez le fichier de configuration temporaire et quittez.
1. L'interface de ligne de commande (CLI) EB met à jour la configuration de votre environnement.
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**.
**Pour supprimer des options de configuration (CLI EB)**
1. Exécutez **eb config** pour afficher la configuration de votre environnement.
```
~/workspace/my-app/$ eb config
```
1. Remplacez toute valeur indiquée par la chaîne `null`. Vous pouvez aussi supprimer la ligne complète contenant l'option que vous souhaitez supprimer.
```
aws:autoscaling:launchconfiguration:
BlockDeviceMappings: null
EC2KeyName: my-key
IamInstanceProfile: aws-elasticbeanstalk-ec2-role
ImageId: ami-1f316660
InstanceType: null
```
1. Enregistrez le fichier de configuration temporaire et quittez.
1. L'interface de ligne de commande (CLI) EB met à jour la configuration de votre environnement.
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](command-options.md#configuration-options-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:environment`espace de noms](command-options-general.md#command-options-general-elasticbeanstalkapplicationenvironment). 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
```
## Le AWS CLI
Vous pouvez mettre à jour les paramètres des options de configuration avec le AWS CLI en déployant un bundle source contenant des fichiers de configuration, en appliquant une configuration enregistrée à distance ou en modifiant l'environnement directement à l'aide de la `aws elasticbeanstalk update-environment` commande.
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-after-awscli-ebextensions)
+ [Utilisation d'une configuration enregistrée](#configuration-options-after-awscli-savedconfig)
+ [Utilisation d'options de ligne de commande](#configuration-options-after-awscli-commandline)
### Utilisation des fichiers de configuration (`.ebextensions`)
Pour appliquer des fichiers de configuration à un environnement d'exécution avec le AWS CLI, incluez-les dans le bundle de sources d'applications que vous chargez sur Amazon S3.
Pour de plus amples informations sur les fichiers de configuration, veuillez consulter [.Ebextensions](ebextensions.md).
```
~/workspace/my-app-v1.zip
|-- .ebextensions
| |-- environmentvariables.config
| `-- healthcheckurl.config
|-- index.php
`-- styles.css
```
**Pour télécharger un bundle source d'application et l'appliquer à un environnement en cours d'exécution (AWS CLI)**
1. Si vous n'avez pas encore de compartiment Elastic Beanstalk dans Amazon S3, créez-en un avec `create-storage-location`:
```
$ aws elasticbeanstalk create-storage-location
{
"S3Bucket": "elasticbeanstalk-us-west-2-123456789012"
}
```
1. Téléchargez votre bundle de fichiers source d'application sur Amazon S3.
```
$ aws s3 cp {{sourcebundlev2.zip}} s3://elasticbeanstalk-{{us-west-2-123456789012}}/my-app/sourcebundlev2.zip
```
1. Créez la version de l'application.
```
$ aws elasticbeanstalk create-application-version --application-name {{my-app}} --version-label v2 --description MyAppv2 --source-bundle S3Bucket="elasticbeanstalk-{{us-west-2-123456789012}}",S3Key="{{my-app/sourcebundlev2.zip}}"
```
1. Mettez à jour l'environnement.
```
$ aws elasticbeanstalk update-environment --environment-name {{my-env}} --version-label v2
```
### 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`.
**Pour appliquer une configuration enregistrée à un environnement en cours d'exécution (AWS CLI)**
+ Spécifiez la configuration enregistrée dans un appel `update-environment` avec l'option `--template-name`.
```
$ aws elasticbeanstalk update-environment --environment-name {{my-env}} --template-name {{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
**Pour modifier des options de configuration avec un document JSON (AWS CLI)**
1. Définissez vos paramètres d'options au format JSON dans un fichier local.
1. Exécutez `update-environment` avec l'option `--option-settings`.
```
$ aws elasticbeanstalk update-environment --environment-name {{my-env}} --option-settings file://{{~/ebconfigs/as-zero.json}}
```
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"
}
]
```
**Note**
Définir des options de configuration avec `update-environment` remplace les paramètres de toutes les autres sources.
Vous pouvez également supprimer des options à partir de votre environnement avec `update-environment`.
**Pour supprimer des options de configuration (AWS CLI)**
+ Exécutez la commande `update-environment` avec l'option `--options-to-remove`.
```
$ aws elasticbeanstalk update-environment --environment-name {{my-env}} --options-to-remove Namespace={{aws:autoscaling:launchconfiguration}},OptionName={{InstanceType}}
```
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](command-options.md#configuration-options-precedence).