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 lors de la création de l'environnement
Lorsque vous créez un AWS Elastic Beanstalk environnement à l'aide de la console Elastic Beanstalk, de l'EB AWS CLI CLI, d'un SDK ou de l'API Elastic Beanstalk, vous pouvez fournir des valeurs pour les options de configuration afin de personnaliser votre environnement et les ressources qui y sont lancées. AWS
Pour toute autre action qu'une modification ponctuelle de la configuration, vous pouvez [stocker les fichiers de configuration](environment-configuration-methods-before.md) localement, dans votre bundle de fichiers source ou dans Amazon S3.
Cette rubrique inclut les procédures relatives à toutes les méthodes de définition des options de configuration lors de la création de l'environnement.
**Topics**
+ [Dans la console Elastic Beanstalk.](#configuration-options-during-console)
+ [Utilisation de l'interface de ligne de commande (CLI) EB](#configuration-options-during-ebcli)
+ [À l'aide du AWS CLI](#configuration-options-during-awscli)
## Dans la console Elastic Beanstalk.
Lorsque vous créez un environnement Elastic Beanstalk dans la console Elastic Beanstalk, vous pouvez fournir des options de configuration à l'aide de fichiers de configuration, de configurations enregistrées et de formulaires dans l'assistant **Create New Environment (Créer un nouvel environnement)**.
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-during-console-ebextensions)
+ [Utilisation d'une configuration enregistrée](#configuration-options-during-console-savedconfig)
+ [Utilisation de l'assistant de création d'un environnement](#configuration-options-during-console-wizard)
### Utilisation des fichiers de configuration (`.ebextensions`)
Incluez les fichiers `.config` dans le [bundle source de votre application](applications-sourcebundle.md) dans un dossier nommé `.ebextensions`.
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
```
Téléchargez le bundle de fichiers source vers Elastic Beanstalk normalement, lors de la [création de l'environnement](using-features.environments.md).
La console Elastic Beanstalk applique des [valeurs recommandées](command-options.md#configuration-options-recommendedvalues) pour certaines options de configuration et inclut des champs de formulaire pour les autres. Les options configurées par la console Elastic Beanstalk sont appliquées directement à l'environnement et remplacent les paramètres dans les fichiers de configuration.
### Utilisation d'une configuration enregistrée
Lorsque vous créez un environnement à l'aide de la console Elastic Beanstalk, l'une des premières étapes consiste à choisir une configuration. Il peut s'agir d'une [**configuration prédéfinie**](concepts.platforms.md), qui correspond généralement à la dernière version d'une plateforme telle que **PHP** ou **Tomcat**, ou d'une **configuration enregistrée**.
**Pour appliquer une configuration enregistrée lors de la création de l'environnement (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 que vous souhaitez appliquer, puis choisissez **Launch environment (Lancer l'environnement)**.
1. Suivez les étapes de l'assistant pour créer votre environnement.
Les configurations enregistrées sont spécifiques aux applications. 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 l'assistant de création d'un environnement
La plupart des options de configuration standards sont présentées dans les pages **Configurer plus d'options** de l'assistant [Création d'un environnement](environments-create-wizard.md). Si vous créez une base de données Amazon RDS ou configurez un VPC pour votre environnement, des options de configuration supplémentaires vous sont proposées pour ces ressources.
**Pour définir les options de configuration lors de la création de l'environnement (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 volet de navigation, choisissez **Applications**.
1. Choisissez ou [créez](applications.md) une application.
1. Choisissez **Actions**, puis **Create environment (Créer un environnement)**.
1. Suivez les étapes de l'assistant, puis choisissez **Configurer plus d'options**.
1. Choisissez l'un des **configuration presets (préréglages de la configuration)**, puis choisissez **Edit (Modifier)** dans une ou plusieurs catégories de configuration pour modifier un groupe d'options de configuration associées.
1. Une fois que vous avez sélectionné toutes les options souhaitées, choisissez **Créer un environnement**.
Toutes les options que vous définissez dans l'assistant de création d'un environnement sont directement définies dans l'environnement. Elles remplacent les paramètres d'option figurant dans les configurations enregistrées ou dans les fichiers de configuration (`.ebextensions`) que vous appliquez. Vous pouvez supprimer des paramètres après la création de l'environnement, via [l'interface de ligne de commande (CLI) EB](environment-configuration-methods-after.md#configuration-options-after-ebcli) ou l'[AWS CLI](environment-configuration-methods-after.md#configuration-options-after-awscli) afin d'autoriser l'affichage des paramètres dans les configurations enregistrées ou les fichiers de configuration.
Pour plus d'informations sur l'assistant de création d'environnement, reportez-vous à la section [Assistant de création d'un environnement](environments-create-wizard.md).
## Utilisation de l'interface de ligne de commande (CLI) EB
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-during-ebcli-ebextensions)
+ [Utilisations de configurations enregistrées](#configuration-options-during-ebcli-savedconfig)
+ [Utilisation d'options de ligne de commande](#configuration-options-during-ebcli-params)
### 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
```
Créez votre environnement et déployez votre code source dans ce dernier à l'aide de la commande **eb create**.
```
~/workspace/my-app$ eb create my-env
```
### Utilisations de configurations enregistrées
Pour appliquer une configuration enregistrée lorsque vous créez un environnement via [**eb create**](eb3-create.md), utilisez l'option `--cfg`.
```
~/workspace/my-app$ eb create --cfg savedconfig
```
Vous pouvez stocker la configuration enregistrée dans votre dossier de projet ou dans votre emplacement de stockage Elastic Beanstalk sur Amazon S3. Dans l'exemple ci-avant, l'interface de ligne de commande (CLI) EB commence par rechercher un fichier de configuration enregistré nommé `savedconfig.cfg.yml` dans le dossier `.elasticbeanstalk/saved_configs/`. N'incluez pas les extensions des noms de fichier (`.cfg.yml`) lorsque vous appliquez une configuration enregistrée avec `--cfg`.
```
~/workspace/my-app/
|-- .ebextensions
| `-- healthcheckurl.config
|-- .elasticbeanstalk
| |-- saved_configs
| | `-- savedconfig.cfg.yml
| `-- config.yml
|-- index.php
`-- styles.css
```
Si l'interface de ligne de commande (CLI) EB ne trouve pas la configuration localement, elle cherche dans l'emplacement de stockage Elastic Beanstalk dans Amazon S3. Pour de plus amples informations sur la création, la modification et le téléchargement des configurations enregistrées, veuillez consulter [Configurations enregistrées](environment-configuration-methods-before.md#configuration-options-before-savedconfig).
### Utilisation d'options de ligne de commande
La commande **eb create** de l'interface de ligne de commande (CLI) EB comporte plusieurs [options](eb3-create.md#eb3-createoptions), qui vous permettent de définir des options de configuration lors de la création de l'environnement. Vous pouvez utiliser ces options pour ajouter une base de données RDS à votre environnement, configurer un VPC ou remplacer des [valeurs recommandées](command-options.md#configuration-options-recommendedvalues).
Par exemple, l'interface de ligne de commande (CLI) EB utilise le type d'instance `t2.micro` par défaut. Pour choisir un autre type d'instance, utilisez l'option `--instance_type`.
```
$ eb create my-env --instance_type t2.medium
```
Pour créer une instance de base de données Amazon RDS et l'associer à votre environnement, utilisez les options `--database` :
```
$ eb create --database.engine postgres --database.username dbuser
```
Si vous n'indiquez pas le nom de l'environnement, le mot de passe de la base de données ou tout autre paramètre requis pour créer votre environnement, l'interface de ligne de commande (CLI) EB vous invite à saisir ces données.
Consultez [eb create](eb3-create.md) pour obtenir la liste complète des options disponibles et des exemples d'utilisation.
## À l'aide du AWS CLI
[Lorsque vous utilisez la `create-environment` commande pour créer un environnement Elastic Beanstalk AWS CLI avec le AWS CLI , aucune valeur recommandée n'est appliquée.](command-options.md#configuration-options-recommendedvalues) Toutes les options de configuration sont définies dans les fichiers de configuration du bundle source que vous spécifiez.
**Topics**
+ [Utilisation des fichiers de configuration (`.ebextensions`)](#configuration-options-during-awscli-ebextensions)
+ [Utilisation d'une configuration enregistrée](#configuration-options-during-awscli-savedconfig)
+ [Utilisation d'options de ligne de commande](#configuration-options-during-awscli-params)
### Utilisation des fichiers de configuration (`.ebextensions`)
Pour appliquer des fichiers de configuration à un environnement que vous créez 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 de sources d'applications et créer un environnement avec 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 sourcebundle.zip s3://elasticbeanstalk-us-west-2-123456789012/my-app/sourcebundle.zip
```
1. Créez la version de l'application.
```
$ aws elasticbeanstalk create-application-version --application-name my-app --version-label v1 --description MyAppv1 --source-bundle S3Bucket="elasticbeanstalk-us-west-2-123456789012",S3Key="my-app/sourcebundle.zip" --auto-create-application
```
1. Création de l'environnement
```
$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --solution-stack-name "64bit Amazon Linux 2015.03 v2.0.0 running Tomcat 8 Java 8"
```
### Utilisation d'une configuration enregistrée
Pour appliquer une configuration enregistrée à un environnement lors de la création, utilisez le paramètre `--template-name`.
```
$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --template-name savedconfig --version-label v1
```
Lorsque vous spécifiez une configuration enregistrée, ne spécifiez pas un nom de pile de solutions en plus. Les configurations enregistrées spécifient déjà une pile de solutions, et Elastic Beanstalk affichera une erreur si vous essayez d'utiliser les deux options.
### Utilisation d'options de ligne de commande
Utilisez le paramètre `--option-settings` pour spécifier les options de configuration au format JSON.
```
$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings '[
{
"Namespace": "aws:elasticbeanstalk:application",
"OptionName": "Application Healthcheck URL",
"Value": "/health"
}
]
```
Pour charger le JSON à partir d'un fichier, utilisez le préfixe `file://`.
```
$ aws elasticbeanstalk create-environment --application-name my-app --environment-name my-env --version-label v1 --template-name savedconfig --option-settings file://healthcheckurl.json
```
Elastic Beanstalk applique directement les paramètres d'option que vous spécifiez via l'option `--option-settings` dans votre environnement. Si les mêmes options sont spécifiées dans une configuration enregistrée ou un fichier de configuration, `--option-settings` remplace ces valeurs.