Options de configuration - 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.

Options de configuration

Elastic Beanstalk définit un grand nombre d'options de configuration que vous pouvez utiliser pour configurer le comportement de votre environnement et les ressources qu'il contient. Les options de configuration sont organisées en espaces de noms comme aws:autoscaling:asg, qui définit les options de groupe Auto Scaling d'un environnement.

La console Elastic Beanstalk et l'interface de ligne de commande (CLI) EB définissent les options de configuration lorsque vous créez un environnement, y compris les options que vous définissez explicitement, et les valeurs recommandées définies par le client. Vous pouvez également définir les options de configuration dans les configurations enregistrées et les fichiers de configuration. Si la même option figure dans plusieurs emplacements, la valeur utilisée est déterminée par l'ordre de priorité.

Paramètres d'option de configuration peuvent être composés au format texte et enregistrés avant la phase de création de l'environnement, appliqués au cours de la création de l'environnement à l'aide de n'importe quel client pris en charge et ajoutés, modifiés ou retirés après la création de l'environnement. Pour une description détaillée de toutes les méthodes disponibles pour l'utilisation des options de configuration à chacun de ces trois étapes, consultez les rubriques suivantes :

Pour obtenir une liste complète des espaces de noms et des options, y compris les valeurs par défaut et celles prises en charge pour chacun, veuillez consulter Options générales pour tous les environnements et Options spécifiques à une plateforme.

Priorité

Au cours de la création de l'environnement, des options de configuration sont appliquées à partir de plusieurs sources avec la priorité suivante, de la plus élevée à la plus faible :

  • Paramètres appliqués directement à l'environnement – Les paramètres spécifiés pendant une opération de création ou de mise à jour d'environnement sur l'API Elastic Beanstalk par n'importe quel client, y compris la console Elastic Beanstalk, l'interface de ligne de commande (CLI) EB, l'AWS CLI et les kits SDK. La console Elastic Beanstalk et l'interface de ligne de commande (CLI) EB appliquent également des valeurs recommandées pour certaines options qui correspondent à ce niveau, sauf en cas de remplacement.

  • Configurations sauvegardées – Les paramètres pour toutes les options qui ne sont pas appliquées directement à l'environnement sont chargés à partir d'une configuration enregistrée, si spécifié.

  • Fichiers de configuration (.ebextensions) – Les paramètres pour toutes les options qui ne sont pas appliquées directement à l'environnement et ne sont pas non plus précisées dans une configuration enregistrée, sont chargés à partir de fichiers de configuration dans le dossier .ebextensions à la racine du bundle de fichiers source de l'application.

    Les fichiers de configuration sont exécutés dans l'ordre alphabétique. Par exemple, .ebextensions/01run.config est exécuté avant .ebextensions/02do.config.

  • Valeurs par défaut – Si une option de configuration a une valeur par défaut, elle ne s'applique que lorsque l'option n'est pas définie sur un des niveaux ci-dessus.

Si la même option de configuration est définie dans plusieurs emplacements, le paramètre ayant la plus haute priorité est appliqué. Lorsqu'un paramètre est appliqué à partir d'une configuration enregistrée ou de paramètres appliqués directement à l'environnement, le paramètre est stocké dans le cadre de la configuration de l'environnement. Ces paramètres peuvent être supprimés avec l'AWS CLI ou avec l'interface de ligne de commande (CLI) EB.

Les paramètres dans les fichiers de configuration ne sont pas appliqués directement à l'environnement et ne peuvent pas être supprimés sans modifier les fichiers de configuration ni déployer une nouvelle version de l'application. Si un paramètre appliqué avec l'une ou l'autre des méthodes est supprimé, ce même paramètre sera chargé à partir des fichiers de configuration dans le groupe source.

Imaginons par exemple que vous définissiez le nombre minimum d'instances dans votre environnement sur 5 lors de la création de l'environnement, à l'aide de la console Elastic Beanstalk, d'une option de ligne de commande ou d'une configuration sauvegardée. Le groupe source de votre application inclut également un fichier de configuration qui définit le nombre minimum d'instances sur 2.

Lorsque vous créez l'environnement, Elastic Beanstalk définit l'option MinSize dans l'espace de noms aws:autoscaling:asg sur 5. Si vous supprimez ensuite l'option de la configuration de l'environnement, la valeur dans le fichier de configuration est chargée, et le nombre minimum d'instances est défini sur 2. Si vous supprimez ensuite le fichier de configuration du bundle de fichiers source et que vous redéployez, Elastic Beanstalk utilise 1 comme paramètre par défaut.

Valeurs recommandées

L'interface de ligne de commande Elastic Beanstalk (EB CLI) et la console Elastic Beanstalk fournissent des valeurs recommandées pour certaines options de configuration. Ces valeurs peuvent être différentes des valeurs par défaut et sont définies au niveau de l'API lors de la création de votre environnement. Les valeurs recommandées permettent à Elastic Beanstalk d'améliorer la configuration de l'environnement par défaut sans procéder à des modifications précédentes incompatibles au niveau de l'API.

Par exemple, l'interface de ligne de commande (CLI) EB et la console Elastic Beanstalk définissent l'option de configuration pour le type d'instance EC2 (InstanceType dans l'espace de noms aws:autoscaling:launchconfiguration). Chaque client fournit une manière différente de remplacer le paramètre par défaut. Dans la console, vous pouvez choisir un autre type d'instance à partir d'un menu déroulant sur la page Détails de configuration de l'assistant Créer un nouvel environnement. Avec l'interface de ligne de commande (CLI) EB, vous pouvez utiliser le paramètre --instance_type pour eb create.

Etant donné que les valeurs recommandées sont définies au niveau de l'API, elles remplaceront les valeurs pour les mêmes options que vous définissez dans les fichiers de configuration ou les configurations enregistrées. Les options suivantes sont définies :

Console Elastic Beanstalk
  • Espace de nom : aws:autoscaling:launchconfiguration

    Noms d'options: IamInstanceProfile, EC2KeyName, InstanceType

  • Espace de nom : aws:autoscaling:updatepolicy:rollingupdate

    Noms d'options : RollingUpdateType et RollingUpdateEnabled

  • Espace de nom : aws:elasticbeanstalk:application

    Nom d'option: Application Healthcheck URL

  • Espace de nom : aws:elasticbeanstalk:command

    Nom d'option : DeploymentPolicy, BatchSize et BatchSizeType

  • Espace de nom : aws:elasticbeanstalk:environment

    Nom d'option: ServiceRole

  • Espace de nom : aws:elasticbeanstalk:healthreporting:system

    Nom d'option : SystemType et HealthCheckSuccessThreshold

  • Espace de nom : aws:elasticbeanstalk:sns:topics

    Nom d'option: Notification Endpoint

  • Espace de nom : aws:elasticbeanstalk:sqsd

    Nom d'option: HttpConnections

  • Espace de nom : aws:elb:loadbalancer

    Nom d'option: CrossZone

  • Espace de nom : aws:elb:policies

    Noms d'options : ConnectionDrainingTimeout et ConnectionDrainingEnabled

INTERFACE DE LIGNE DE COMMANDE (CLI) EB
  • Espace de nom : aws:autoscaling:launchconfiguration

    Noms d'options : IamInstanceProfile, InstanceType

  • Espace de nom : aws:autoscaling:updatepolicy:rollingupdate

    Noms d'options : RollingUpdateType et RollingUpdateEnabled

  • Espace de nom : aws:elasticbeanstalk:command

    Nom d'option : BatchSize et BatchSizeType

  • Espace de nom : aws:elasticbeanstalk:environment

    Nom d'option: ServiceRole

  • Espace de nom : aws:elasticbeanstalk:healthreporting:system

    Nom d'option: SystemType

  • Espace de nom : aws:elb:loadbalancer

    Nom d'option: CrossZone

  • Espace de nom : aws:elb:policies

    Noms d'options : ConnectionDrainingEnabled