Utilisation de la plateforme Elastic Beanstalk Tomcat

Cette rubrique explique comment configurer, créer et exécuter vos applications Java exécutées sur la plateforme Elastic Beanstalk Tomcat.

Le AWS Elastic Beanstalk La plate-forme Tomcat est un ensemble de versions de plate-forme pour les applications Web Java qui peuvent s'exécuter dans un conteneur Web Tomcat. Tomcat s'exécute derrière un serveur proxy nginx. Chaque branche de plateforme correspond à une version majeure de Tomcat.

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.

La plateforme Tomcat Elastic Beanstalk inclut un proxy inverse qui transmet les demandes à votre application. Vous pouvez utiliser les options de configuration pour configurer le serveur proxy de manière à traiter les ressources statiques à partir d'un dossier de votre code source afin de réduire la charge sur votre application. Pour les scénarios avancés, vous pouvez inclure vos propres .conffichiers dans votre bundle de fichiers source afin d'étendre la configuration proxy Elastic Beanstalk ou de la remplacer complètement.

Vous devez empaqueter les applications Java dans un fichier d'archive d'applications Web (WAR) doté d'une structure spécifique. Pour plus d'informations sur la structure à respecter et sur sa liaison à la structure de votre répertoire de projet, consultez Structuration de votre dossier de projet.

Pour exécuter plusieurs applications sur le même serveur Web, vous pouvez regrouper plusieurs WAR fichiers dans un seul ensemble source. Chaque application d'un ensemble de WAR sources multiples s'exécute sur le chemin racine (ROOT.warrun atmyapp.elasticbeanstalk.com/) ou sur un chemin situé juste en dessous (app2.warrun atmyapp.elasticbeanstalk.com/app2/), comme déterminé par le nom duWAR. Dans un bundle WAR source unique, l'application s'exécute toujours sur le chemin racine.

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.

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.

Configuration de votre environnement Tomcat

La plateforme Tomcat Elastic Beanstalk fournit quelques options propres à la plateforme en plus des options standard présentes sur toutes les plateformes. Ces options vous permettent de configurer la machine virtuelle Java (JVM) qui s'exécute sur les serveurs Web de votre environnement et de définir les propriétés du système qui fournissent des chaînes de configuration d'informations à votre application.

Vous pouvez utiliser la console Elastic Beanstalk pour activer la rotation de journal sur Amazon S3 et configurer les variables que votre application peut lire depuis l'environnement.

Options du conteneur

Vous pouvez spécifier ces options spécifiques à la plateforme :

JVMoptions de conteneur

La taille du segment de mémoire de la machine virtuelle Java (JVM) détermine le nombre d'objets que votre application peut créer en mémoire avant la collecte des déchets. Vous pouvez modifier la taille initiale du JVM tas (-Xms option) et la taille maximale du JVM tas (-Xmxoption). Plus la taille initiale du tas est importante, plus le nombre d'objets pouvant être créés avant le nettoyage de la mémoire sera élevé. Toutefois, cela signifie également que le récupérateur de mémoire mettra plus de temps pour compacter le tas. La taille maximale du tas indique la quantité maximale de mémoire qu'il est JVM possible d'allouer lors de l'extension du tas lors d'une activité intense.

La génération permanente est une section du JVM tas qui stocke les définitions de classe et les métadonnées associées. Pour modifier la taille de la génération permanente, saisissez la nouvelle taille dans l'option JVM PermGen Taille maximale (-XX:MaxPermSize). Ce paramètre s'applique uniquement à Java 7 et versions antérieures. Cette option a été déconseillée en JDK 8 et remplacée par l'option MaxMetaspaceSize (). -XX:MaxMetaspaceSize

Pour plus d'informations sur les plateformes Elastic Beanstalk et leurs composants, consultez la section Plateformes prises en charge dans le AWS Elastic Beanstalk Guide des plateformes.

Options du journal

La section Options du journal a deux paramètres :

Fichiers statiques

Pour améliorer les performances, vous pouvez utiliser la section Fichiers statiques pour configurer le serveur proxy pour qu'il diffuse des fichiers statiques (par exemple, HTML ou des images) à partir d'un ensemble de répertoires au sein de votre application Web. Pour chaque répertoire, vous définissez le chemin virtuel sur le mappage de répertoires. Lorsque le serveur proxy reçoit une demande pour un fichier dans le chemin spécifié, il fournit le fichier directement au lieu d'acheminer la demande vers votre application.

Pour en savoir plus sur la configuration des fichiers statiques à l'aide des fichiers de configuration ou de la console Elastic Beanstalk, consultez Service de fichiers statiques.

Propriétés de l'environnement

Dans la section Propriétés de l'environnement, vous pouvez spécifier les paramètres de configuration de l'environnement sur les EC2 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.

La plateforme Tomcat définit une propriété d'espace réservée nommée JDBC_CONNECTION_STRING pour les environnements Tomcat, permettant de transmettre une chaîne de connexion à une base de données externe.

Dans l'environnement Tomcat en cours d'exécution dans Elastic Beanstalk, les variables d'environnement sont accessibles à l'aide de System.getProperty(). Par exemple, vous pouvez lire une propriété nommée API_ENDPOINT sur une variable avec le code suivant :

String endpoint = System.getProperty("API_ENDPOINT");

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

Espaces de noms de la configuration Tomcat

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.

La plateforme Tomcat prend en charge les options des espaces de noms suivants en plus des options prises en charge pour tous les environnements Elastic Beanstalk :

L'exemple de fichier de configuration suivant illustre l'utilisation d'options de configuration spécifiques à Tomcat :

option_settings:
  aws:elasticbeanstalk:container:tomcat:jvmoptions:
    Xms: 512m
    JVM Options: '-Xmn128m'
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: mywebapi.zkpexsjtmd.us-west-2.elasticbeanstalk.com
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

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. Voir Options de configuration pour plus d'informations.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    GzipCompression: 'true'
    ProxyServer: nginx

zip -ur your_application.war .ebextensions