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.

La plate-forme AWS Elastic Beanstalk 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 compresser les applications Java dans un fichier WAR (Web application ARchive) avec 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 fichiers WAR dans un bundle source unique. Chaque application d'un bundle source multiple s'exécute soit sur le chemin d'accès racine (ROOT.war s'exécute dans myapp.elasticbeanstalk.com/), soit sur un chemin d'accès situé juste en dessous (app2.war.war s'exécute dans myapp.elasticbeanstalk.com/app2/), selon le nom du fichier WAR. Dans un bundle source WAR unique, l'application s'exécute toujours sur le chemin d'accès 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 système qui fournissent les chaînes de configuration d'information à 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 :

Options du conteneur JVM

La taille du tas sur la machine virtuelle Java (JVM) détermine combien d'objets peuvent être créés en mémoire par votre application avant un nettoyage de la mémoire. Vous pouvez modifier les options Initial JVM Heap Size (-Xms option) et Maximum JVM Heap Size (argument -Xmx). 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 de tas maximale indique la quantité maximale de mémoire que la machine virtuelle Java peut allouer lorsqu'elle augmente le tas dans le cadre d'une activité intensive.

La génération permanente est une section du tas de la machine virtuelle Java 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 Taille maximale de la machine virtuelle Java PermGen (-XX:MaxPermSize). Ce paramètre s'applique uniquement à Java 7 et versions antérieures. Cette option a été déconseillée dans le JDK 8 et remplacée par l'option Size (). MaxMetaspace -XX:MaxMetaspaceSize

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

Options du journal

La section Options du journal a deux paramètres :

Fichiers statiques

Pour améliorer les performances, la section des Fichiers statiques vous permet de configurer le serveur proxy pour proposer des fichiers statiques (HTML ou images, par exemple) à partir d'un ensemble de répertoires dans 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.

Pour les versions de la plateforme Tomcat publiées avant le 26 mars 2025, les variables d'environnement sont accessibles à l'aide System.getProperty() de. Par exemple, vous pouvez lire une propriété nommée API_ENDPOINT à partir d'une variable avec le code suivant.

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

Les versions de la plateforme Tomcat publiées le 26 mars 2025 ou après cette date peuvent également être utilisées System.getenv pour accéder aux variables d'environnement en texte brut. Vous pouvez continuer à utiliser pour accéder System.getProperty aux variables d'environnement en texte brut. Cependant, les variables d'environnement stockées sous forme de secrets ne sont disponibles qu'à l'aide deSystem.getenv. Par exemple, vous pouvez lire une variable d'environnement nommée API_KEY avec le code suivant.

String apiKey = System.getenv("API_KEY");

Pour plus d'informations, consultez Variables d'environnement et autres paramètres du 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. 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.

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

zip -ur your_application.war .ebextensions