Déployer l'application à la racine de Tomcat
1. Vue d'ensemble
Dans cet article rapide, nous aborderons le déploiement d'une application Web à la racine d'un Tomcat.
2. Concepts de base et déploiement de Tomcat
Tout d'abord, les bases du déploiement d'une application sur Tomcat se trouvent dans ce guide:How to Deploy a WAR File to Tomcat.
En termes simples, les applications Web sont placées sous$CATALINA_HOME\webapps, où$CATALINA_HOME est le répertoire d’installation de Tomcat.
Le chemin de contexte fait référence à l'emplacement par rapport à l'adresse du serveur qui représente le nom de l'application Web.
Par défaut, Tomcat le tire du nom du fichier war déployé. Donc, si nous déployons un fichierExampleApp.war, il sera disponible àhttp://localhost:8080/ExampleApp. I. e. le chemin du contexte est/ExampleApp.
Si nous devons maintenant avoir cette application disponible àhttp://localhost:8080/ à la place, nous avons quelques options, dont nous parlerons dans les sections suivantes.
Pour une explication plus détaillée du concept de contexte de Tomcat, jetez un œil auxTomcat documentation officiels.
3. Déploiement de l'application en tant queROOT.war
La première option est très simple:we just have to delete the default /ROOT/ folder in $CATALINA_HOME\webapps, rename our ExampleApp.war to ROOT.war, and deploy it.
Notre application sera désormais disponible àhttp://localhost:8080/.
4. Spécification du chemin de contexte dans lesserver.xml
La deuxième option consiste à définir le chemin de contexte de l'application dans leserver.xml (qui se trouve à$CATALINA_HOME\conf).
Nous devons insérer ce qui suit dans la balise<Host> pour cela:
Note: defining the context path manually has the side effect that the application is deployed twice by default: àhttp://localhost:8080/ExampleApp/ ainsi qu'àhttp://localhost:8080/.
Pour éviter cela, nous devons définirautoDeploy=”false” etdeployOnStartup=”false” dans la balise<Host>:
Important: cette option n'est plus recommandée, depuis Tomcat 5: elle rend les configurations de contexte plus invasives, puisque le fichierserver.xml ne peut plus être rechargé sans redémarrer Tomcat.
5. Spécification du chemin de contexte dans un fichier XML spécifique à une application
Pour éviter ce problème avec lesserver.xml, nous avons la troisième option: nous allons définir le chemin de contexte dans un fichier XML spécifique à l'application.
Par conséquent, nous devons créer unROOT.xml à$CATALINA_HOME\conf\Catalina\localhost avec le contenu suivant:
Deux points ne valent rien ici.
Tout d'abord, nous n'avons pas à spécifier le chemin d'accès explicitement comme dans l'option précédente - Tomcat le dérive du nom de nosROOT.xml.
Et deuxièmement - puisque nous définissons notre contexte dans un fichier différent de celui desserver.xml, nosdocBase doivent être en dehors de$CATALINA_HOME\webApps.
6. Conclusion
Dans ce tutoriel, nous avons discuté des différentes options de déploiement d’une application Web à la racine d’un Tomcat.