Comment personnaliser mon environnement Elastic Beanstalk en utilisant .ebextensions ?

Brève description

Configurez vos instances Amazon EC2 dans un environnement Elastic Beanstalk en utilisant des fichiers de configuration Elastic Beanstalk (.ebextensions).

Les modifications apportées à votre environnement Elastic Beanstalk ne persisteront pas si vous utilisez les méthodes de configuration suivantes :

• Configuration d'une ressource Elastic Beanstalk directement à partir de la console d'un service AWS spécifique.
• Installation d'un package, création d'un fichier ou exécution d'une commande directement à partir de votre instance Amazon EC2.

Remarque : si vous recevez des message d'erreurs lors de l'exécution de commandes depuis l'interface de ligne de commande AWS (AWS CLI), vérifiez que vous utilisez la version la plus récente d'AWS CLI.

Résolution

Définir votre répertoire .ebextensions

1.    Dans la racine de votre groupe d'application, créez un répertoire et nommez-le .ebextensions.

2.    Stockez le fichier de configuration dans le répertoire .ebextensions.

Le groupe source de l'application doit se présenter comme suit :

~/workspace/my-application/
|-- .ebextensions
|   |-- 01-server-configuration.config
|   `-- 02-asg-healthcheck.config
|-- index.php
`-- styles.css

Personnaliser votre environnement Elastic Beanstalk

Pour personnaliser votre environnement, tenez compte des points suivants :

• Utilisez la clé option_settings pour modifier la configuration de l'environnement. Vous pouvez choisir parmi les options générales de tous les environnements et des options propres à la plateforme.
  Remarque : les valeurs recommandées sont appliquées lorsque vous créez ou mettez à jour un environnement dans l'API Elastic Beanstalk en fonction d'un client. Par exemple, le client peut être AWS Management Console, l'interface de ligne de commande Elastic Beanstalk (CLI EB), AWS CLI ou des kits SDK. Les valeurs recommandées sont directement définies au niveau de l'API et ont la priorité la plus élevée. Le paramètre de configuration appliqué au niveau de l'API ne peut pas être modifié à l'aide de option_settings, car l'API a la priorité la plus élevée.
• Les règles de priorité peuvent empêcher vos modifications option_settings d'être appliquées à la configuration de l'environnement. Pour supprimer les configurations directement appliquées lors de la création de l'environnement ou effectuer la mise à jour dans l'API Elastic Beanstalk, utilisez la commande update-environment avec l'indicateur --options-to-remove.
• S'il n'existe aucun paramètre d'option pour la configuration de ressources désirée, utilisez la clé Resources pour personnaliser les ressources dans votre environnement Elastic Beanstalk.
  Remarque : les ressources définies dans les fichiers de configuration sont ajoutées au modèle AWS CloudFormation utilisé pour lancer votre environnement. Tous les types de ressources AWS CloudFormation sont pris en charge. Pour plus d'informations sur les noms de ressources logiques, consultez Modification des ressources qu'Elastic Beanstalk crée pour votre environnement.
• Utilisez des clés pour personnaliser le logiciel sur les serveurs Linux ou Windows.
• Pour des exemples de fichiers de configuration, consultez le référentiel AWS GitHub.

Appliquer vos paramètres personnalisés à votre application

1.    Créer un groupe source d'application qui contient vos fichiers de configuration.

Remarque : les dossiers qui commencent par un point, tels que .ebextensions, peuvent être masqués par les explorateurs de fichiers. Pour les maintenir visibles, placez le dossier .ebextensions dans la racine de votre groupe d'application lorsque vous créez le groupe source de l'application.

2.    Déployez l'application Elastic Beanstalk mise à jour.