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 environnement AWS Elastic Beanstalk à l'aide de la console Elastic Beanstalk, de l'interface de ligne de commande (CLI) EB, de l'AWS CLI, d'un kit 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 AWS qui y sont lancées.

Pour toute autre action qu'une modification ponctuelle de la configuration, vous pouvez stocker les fichiers de configuration 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.

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).

Utilisation des fichiers de configuration (.ebextensions)

Incluez les fichiers .config dans le bundle source de votre application dans un dossier nommé .ebextensions.

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

Téléchargez le bundle de fichiers source vers Elastic Beanstalk normalement, lors de la création de l'environnement.

La console Elastic Beanstalk applique des valeurs recommandées 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, qui correspond généralement à la dernière version d'une plateforme telle que PHP ou Tomcat, ou d'une configuration enregistrée.

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.

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. 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.

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 ou l'AWS CLI 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.

Utilisation de l'interface de ligne de commande (CLI) EB

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

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, 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.

Utilisation d'options de ligne de commande

La commande eb create de l'interface de ligne de commande (CLI) EB comporte plusieurs options, 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.

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 pour obtenir la liste complète des options disponibles et des exemples d'utilisation.

À partir d AWS CLI

Si vous utilisez la commande create-environment pour créer un environnement Elastic Beanstalk via la AWS CLI, la AWS CLI n'applique aucune valeur recommandée. Toutes les options de configuration sont définies dans les fichiers de configuration du bundle source que vous spécifiez.

Utilisation des fichiers de configuration (.ebextensions)

Pour appliquer des fichiers de configuration à un environnement que vous créez via la AWS CLI, incluez-les dans la solution groupée de fichiers source de l'application que vous téléchargez dans 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

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.