Utilisation de l'Elastic Beanstalk. NETcore sur la plateforme Linux

Cette rubrique décrit comment configurer, créer et exécuter votre. NETcœur des applications Linux sur Elastic Beanstalk.

AWS Elastic Beanstalk prend en charge un certain nombre de branches de plate-forme pour différentes. NETVersions du framework de base qui s'exécutent sur le système d'exploitation Linux. Voir. NETcore sur Linux dans la section AWS Elastic Beanstalk Plateformes pour une liste complète.

Pour plus d'informations sur les différentes manières d'étendre une plateforme Elastic Beanstalk basée sur Linux, consultez Extension des plateformes Linux Elastic Beanstalk.

. NETConsidérations fondamentales relatives à la plateforme Linux

Serveur proxy

L'Elastic Beanstalk. NETLa plate-forme Core sur Linux inclut un proxy inverse qui transmet les demandes à votre application. Par défaut, Elastic NGINXBeanstalk l'utilise comme serveur proxy. Vous pouvez choisir de n'utiliser aucun serveur proxy et de configurer Kestrel en tant que serveur Web. Kestrel est inclus par défaut dans. ASP NETModèles de projets de base.

Structure d'application

Vous pouvez publier des applications dépendantes de l'exécution qui utilisent le. NETRuntime de base fourni par Elastic Beanstalk. Vous pouvez également publier des applications autonomes qui incluent le. NETLe moteur d'exécution principal et les dépendances de votre application dans le bundle source. Pour en savoir plus, consultez Regroupement d'applications pour le. NETCore sur la plateforme Linux Elastic Beanstalk.

Configuration de plateforme

Pour configurer les processus qui s'exécutent sur les instances de serveur dans votre environnement, incluez un fichier Procfile facultatif dans votre bundle de fichiers source. Un fichier Procfile est obligatoire si vous avez plus d'une application dans votre bundle de fichiers source.

Nous vous recommandons de toujours fournir un fichier Procfile dans le bundle de fichiers source avec votre application. De cette façon, vous contrôlez précisément les processus Elastic Beanstalk exécutés pour votre application.

Des options de configuration sont disponibles dans la console Elastic Beanstalk pour modifier la configuration d'un environnement en cours d'exécution. Pour éviter de perdre la configuration de votre environnement en le résiliant, vous pouvez utiliser des configurations enregistrées pour enregistrer vos paramètres et les appliquer par la suite à un autre environnement.

Pour enregistrer les paramètres dans votre code source, vous pouvez inclure des fichiers de configuration. Les paramètres des fichiers de configuration sont appliquées chaque fois que vous créez un environnement ou que vous déployez votre application. Vous pouvez également utiliser des fichiers de configuration pour installer des packages, exécuter des scripts ou effectuer d'autres opérations de personnalisation d'instance lors des déploiements.

Les paramètres appliqués dans la console Elastic Beanstalk remplacent les mêmes paramètres des fichiers de configuration, s'ils existent. Cela vous permet d'utiliser les paramètres par défaut dans les fichiers de configuration et de les remplacer par des paramètres spécifiques à l'environnement dans la console. Pour plus d'informations sur la priorité et les autres méthodes de modification des paramètres, consultez Options de configuration.

Configuration de votre. NETCore sur un environnement Linux

Le. NETLes paramètres de la plateforme Core on Linux vous permettent d'affiner le comportement de vos EC2 instances Amazon. Vous pouvez modifier la configuration de l'instance Amazon de l'environnement Elastic Beanstalk à l'aide EC2 de la console Elastic Beanstalk.

Utilisez la console Elastic Beanstalk pour permettre la rotation des journaux sur Amazon S3 et configurer des variables que votre application peut lire à partir de l'environnement.

Options du journal

La section Options du journal a deux paramètres :

Propriétés de l'environnement

La section Propriétés de l'environnement vous permet de définir les paramètres de configuration de l'environnement sur EC2 les instances Amazon qui exécutent votre application. Les propriétés de l'environnement sont passées en tant que paires clé-valeur à l'application.

À l'intérieur du. NETCore sur un environnement Linux fonctionnant dans Elastic Beanstalk, les variables d'environnement sont accessibles à l'aide de. Environment.GetEnvironmentVariable("variable-name") Par exemple, vous pouvez lire une propriété nommée API_ENDPOINT sur une variable avec le code suivant :

string endpoint = Environment.GetEnvironmentVariable("API_ENDPOINT");

Pour plus d'informations, consultez Propriétés de l'environnement et autres paramètres de logiciel.

. NETEspace de noms de configuration Core sur Linux

Vous pouvez utiliser un fichier de configuration pour définir des options de configuration et exécuter d'autres tâches de configuration d'instance pendant les déploiements. Les options de configuration peuvent être spécifiques à la plate-forme ou s'appliquer à toutes les plateformes du service Elastic Beanstalk dans son ensemble. Les options de configuration sont organisées en espaces de noms.

Le. NETLa plateforme Core on Linux prend en charge les options de l'espace de noms suivant, en plus des options prises en charge pour tous les environnements Elastic Beanstalk :

L'exemple de fichier de configuration suivant montre l'utilisation du. NETOptions de configuration spécifiques à Core on Linux.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: none

Elastic Beanstalk fournit de nombreuses options de configuration pour personnaliser votre environnement. Outre les fichiers de configuration, vous pouvez également définir les options de configuration à l'aide de la console, des configurations enregistrées, de l'EB CLI ou du AWS CLI. Pour plus d’informations, consultez Options de configuration.