Personnalisation d'environnement avancée avec fichiers de configuration (.ebextensions) - AWS Elastic Beanstalk

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.

Personnalisation d'environnement avancée avec fichiers de configuration (.ebextensions)

Vous pouvez ajouter des fichiers de AWS Elastic Beanstalk configuration (.ebextensions) au code source de votre application Web pour configurer votre environnement et personnaliser les AWS ressources qu'il contient. Les fichiers de configuration sont des documents au format YAML, or JSON, avec une extension de fichier .config que vous placez dans un dossier nommé .ebextensions et que vous déployez dans le bundle de fichiers source de votre application.

Exemple
extensions .eb/ .config network-load-balancer

Dans cet exemple on effectue une modification de configuration simple. Une option de configuration est modifiée de sorte à définir le type de l'équilibreur de charge de votre environnement sur Network Load Balancer.

option_settings:
  aws:elasticbeanstalk:environment:
    LoadBalancerType: network

Nous vous recommandons d'utiliser un format YAML pour vos fichiers de configuration, car il est plus lisible que JSON. YAML prend en charge des commentaires, des commandes sur plusieurs lignes, plusieurs alternatives pour l'utilisation de guillemets, et bien plus encore. Toutefois, vous pouvez effectuer une modification de configuration dans les fichiers de configuration Elastic Beanstalk comme avec YAML ou JSON.

Conseil

Lorsque vous développez ou testez de nouveaux fichiers de configuration, lancez un environnement propre qui exécute l'application par défaut et déployez les fichiers dans cet environnement. Des fichiers de configuration au format erroné empêcheront irrémédiablement le démarrage d'un nouvel environnement.

La section option_settings d'un fichier de configuration définit des valeurs pour des options de configuration. Les options de configuration vous permettent de configurer votre environnement Elastic Beanstalk AWS , les ressources qu'il contient et le logiciel qui exécute votre application. Les fichiers de configuration sont seulement une parmi de multiples façons de définir les options de configuration.

Cette Resourcessection vous permet de personnaliser davantage les ressources de l'environnement de votre application et de définir des AWS ressources supplémentaires au-delà des fonctionnalités fournies par les options de configuration. Vous pouvez ajouter et configurer toutes les ressources prises en charge par AWS CloudFormationElastic Beanstalk pour créer des environnements.

Les autres sections d'un fichier de configuration (packages, sources, files, users, groups, commands, container_commands et services) vous permettent de configurer les instances EC2 qui sont lancées dans votre environnement. Chaque fois qu'un serveur est démarré dans votre environnement, Elastic Beanstalk exécute les opérations définies dans ces sections pour préparer le système d'exploitation et le système de stockage pour votre application.

Pour obtenir des exemples de fichiers .ebextensions couramment utilisés, consultez la rubrique Référentiel de fichiers de configuration Elastic Beanstalk.

Prérequis

  • Emplacement — Elastic Beanstalk .ebextensions ingère tous les dossiers présents dans votre déploiement. Toutefois, nous vous recommandons de placer tous vos fichiers de configuration dans un seul dossier, nommé.ebextensions, à la racine de votre bundle source. Comme les dossiers commençant par un point peuvent être masquées par des navigateurs de fichiers, assurez-vous que le dossier est ajouté lorsque vous créez votre bundle de fichiers source. Pour de plus amples informations, veuillez consulter Création d'une offre groupée de source d'application.

  • Attribution d'un nom – Les fichiers de configuration doivent porter l'extension de fichier .config.

  • Mise en forme – Les fichiers de configuration doivent être conformes aux spécifications YAML ou JSON.

    Lorsque vous utilisez YAML, utilisez des espaces pour mettre retrait les clés à différents niveaux d'imbrication. Pour plus d'informations sur YAML, consultez YAML Ain't Markup Language (YAML™) Version 1.1.

  • Unicité – Utilisez chaque clé une seule fois dans chaque fichier de configuration.

    Avertissement

    Si vous utilisez une clé (par exemple, option_settings) deux fois dans le même fichier de configuration, l'une des sections sera supprimée. Combinez les sections dupliquées en une seule section, ou placez-les dans des fichiers de configuration distincts.

Le processus de déploiement varie légèrement selon le client que vous utilisez pour gérer vos environnements. Consultez les sections suivantes pour obtenir des détails :

Rubriques