Utilisation de la plateforme .NET Core sous Linux

La plateforme .NET Core sous Linux AWS Elastic Beanstalk est un ensemble de versions de plateforme pour les applications .NET Core qui s'exécutent sur le système d'exploitation Linux.

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. Voici quelques considérations spécifiques à la plateforme.

Présentation de la plateforme .NET Core sous Linux

Serveur proxy

La plateforme Elastic Beanstalk .NET Core sous Linux inclut un proxy inverse qui transmet les demandes à votre application. Par défaut, Elastic Beanstalk utilise nginx en tant que 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 les modèles de projet ASP.NET Core.

Structure d'application

Vous pouvez publier des applications dépendantes de l'exécution qui utilisent l'environnement d'exécution .NET Core fourni par Elastic Beanstalk. Vous pouvez également publier des applications autonomes qui incluent l'environnement d'exécution .NET Core et les dépendances de votre application dans le bundle de fichiers source. Pour en savoir plus, veuillez consulter la section Regroupement d'applications pour la plateforme .NET Core sous Linux.

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 environnement .NET Core sous Linux

Les paramètres de la plateforme .NET Core sous Linux vous permettent d'affiner le comportement de vos instances Amazon EC2. Vous pouvez modifier la configuration des instances Amazon EC2 de l'environnement Elastic Beanstalk à l'aide 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.

Pour configurer votre environnement .NET Core sous Linux à l'aide de la console Elastic Beanstalk

1. Ouvrez la console Elastic Beanstalk et, dans la liste Regions (Régions), sélectionnez votre Région AWS.

2. Dans le panneau de navigation, choisissez Environments (Environnements), puis choisissez le nom de votre environnement dans la liste.

   Note

   Si vous avez plusieurs environnements, utilisez la barre de recherche pour filtrer la liste des environnements.

3. Dans le panneau de navigation, choisissez Configuration.

4. Dans la catégorie de configuration Mises à jour, surveillance et journalisation, sélectionnez Modifier.

Options du journal

La section Options du journal a deux paramètres :

• Instance profile (Profil d'instance) – Spécifie le profil d'instance qui est autorisé à accéder au compartiment Amazon S3 associé à votre application.

• Enable log file rotation to Amazon S3 (Permettre la rotation du fichier journal sur Amazon S3) – Indique si les fichiers journaux des instances Amazon EC2 de votre application doivent être copiés dans le compartiment Amazon S3 associé à votre application.

Propriétés de l'environnement

La section Environment Properties (Propriétés de l'environnement) vous permet de spécifier des paramètres de configuration de l'environnement sur les instances Amazon EC2 exécutant votre application. Les propriétés de l'environnement sont passées en tant que paires clé-valeur à l'application.

Dans l'environnement .NET Core sous Linux en cours d'exécution 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.

Espace de noms de la configuration .NET Core sous 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 définies par le service Elastic Beanstalk ou la plateforme que vous utilisez et sont organisées en espaces de noms.

La plateforme .NET Core sous Linux prend en charge les options des espaces de noms suivants en plus des options prises en charge pour tous les environnements Elastic Beanstalk :

• aws:elasticbeanstalk:environment:proxy – Choisissez d'utiliser nginx ou de n'utiliser aucun serveur proxy. Les valeurs valides sont nginx ou none.

L'exemple de fichier de configuration suivant illustre l'utilisation d'options de configuration spécifiques à .NET Core sous Linux :

Exemple .ebextensions/proxy-settings.config

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

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