Comment installer Apache Tomcat 10 avec Nginx Reverse Proxy sur Debian 12

Apache Tomcat ou “Tomcat” est un conteneur de servlets Java gratuit et open-source pour le code et les applications Java. Il fournit un environnement de serveur HTTP “pure Java” où le code Java peut s’exécuter. Tomcat implémente également JavaServer Pages, Java Expression Language et les technologies WebSocket.

Dans ce guide, nous allons vous montrer comment installer Apache Tomcat 10 sur le serveur Debian 12. Vous apprendrez également comment configurer Nginx comme proxy inverse pour Apache Tomcat.

Prérequis

Pour commencer, assurez-vous d’avoir ce qui suit :

Un serveur Debian 12.
Un utilisateur non-root avec des privilèges d’administrateur.

Installation de Java OpenJDK

Apache Tomcat est principalement écrit en Java, donc avant de l’installer, vous devez installer Java sur votre système. Dans cet exemple, vous allez installer Java OpenJDK 17, qui est disponible par défaut dans le dépôt Debian.

Avant de commencer l’installation de Java, mettez à jour et rafraîchissez votre dépôt Debian avec la commande ci-dessous.

sudo apt update

update repo

Maintenant, installez le paquet Java OpenJDK sur votre serveur Debian en utilisant la commande suivante. Le paquet default-jdk fait référence à Java OpenJDK 17, qui est la version LTS de Java.

sudo apt install default-jdk

Tapez y pour confirmer l’installation.

install java

Après l’installation de Java, exécutez la commande ci-dessous pour vérifier votre version de Java. Vous verrez que Java OpenJDK 17 est installé.

java --version

Installation d’Apache Tomcat via le dépôt

Par défaut, le dernier dépôt Debian 12 fournit Apache Tomcat 10. Si vous devez installer Apache Tomcat via APT, alors cette méthode est adaptée pour vous.

Tout d’abord, vérifiez le paquet tomcat10 en utilisant la commande ci-dessous.

sudo apt info tomcat10

Dans la sortie suivante, vous pouvez voir qu’Apache Tomcat 10 est disponible dans le dépôt principal de Debian, dans la section java.

check tomcat10

Si vous souhaitez installer Tomcat via APT, exécutez la commande ci-dessous sur votre système. Tapez y pour confirmer l’installation.

sudo apt install tomcat10 tomcat10-common tomcat10-admin tomcat10-user tomcat10-examples

install tomcat10

Une fois l’installation terminée, le service tomcat10 devrait être en cours d’exécution. Vérifiez-le avec la commande ci-dessous.

sudo systemctl is-enabled tomcat10  
sudo systemctl status tomcat10

Si le service tomcat10 fonctionne, vous devriez obtenir la sortie suivante :

tomcat status

Enfin, ouvrez votre navigateur web et visitez l’adresse IP du serveur avec le port par défaut de Tomcat 8080 http://192.168.5.15:8080/. Si votre installation est réussie, vous devriez obtenir la page d’index par défaut d’Apache Tomcat 10.

tomcat index

Installation de Tomcat via binaire

Maintenant, si vous souhaitez installer le dernier paquet d’Apache Tomcat, vous pouvez l’installer via le paquet binaire. Dans cette section, vous apprendrez comment le faire sur votre serveur Debian.

Tout d’abord, créez un nouvel utilisateur système tomcat avec la commande ci-dessous.

sudo useradd -m -u -d /opt/tomcat -s /usr/sbin/nologin tomcat

Visitez la page de téléchargement d’Apache Tomcat et vérifiez la dernière version de Tomcat. Ensuite, exécutez la commande ci-dessous pour télécharger la dernière version d’Apache Tomcat.

export VERSION=10.1.19  
wget https://www-eu.apache.org/dist/tomcat/tomcat-10/v${VERSION}/bin/apache-tomcat-${VERSION}.tar.gz

Une fois téléchargé, exécutez la commande ci-dessous pour créer un nouveau répertoire d’installation d’Apache Tomcat /opt/tomcat et extraire le paquet binaire Tomcat dedans.

mkdir -p /opt/tomcat  
sudo tar -xf apache-tomcat-${VERSION}.tar.gz -C /opt/tomcat

Maintenant, créez un nouveau lien symbolique du répertoire Tomcat extrait vers /opt/tomcat/latest. Ensuite, changez la propriété du répertoire /opt/tomcat à l’utilisateur tomcat.

sudo ln -s /opt/tomcat/apache-tomcat-${VERSION} /opt/tomcat/latest  
sudo chown -R tomcat:tomcat /opt/tomcat

Ensuite, créez un nouveau fichier de service systemd /etc/systemd/system/tomcat.service en utilisant l’éditeur nano.

sudo nano /etc/systemd/system/tomcat.service

Collez la configuration ci-dessous pour configurer le fichier de service pour Apache Tomcat.

[Unit]  
Description=Tomcat 10 servlet container  
After=network.target  
  
[Service]  
Type=forking  
  
User=tomcat  
Group=tomcat  
  
Environment="JAVA_HOME=/usr/lib/jvm/default-java"  
Environment="JAVA_OPTS=-Djava.security.egd=file:///dev/urandom -Djava.awt.headless=true"  
  
Environment="CATALINA_BASE=/opt/tomcat/latest"  
Environment="CATALINA_HOME=/opt/tomcat/latest"  
Environment="CATALINA_PID=/opt/tomcat/latest/temp/tomcat.pid"  
Environment="CATALINA_OPTS=-Xms512M -Xmx1024M -server -XX:+UseParallelGC"  
  
ExecStart=/opt/tomcat/latest/bin/startup.sh  
ExecStop=/opt/tomcat/latest/bin/shutdown.sh  
  
[Install]  
WantedBy=multi-user.target

Enregistrez le fichier et quittez l’éditeur.

Exécutez la commande ci-dessous pour recharger le gestionnaire systemd, puis démarrez et activez le service tomcat.

sudo systemctl daemon-reload

sudo systemctl start tomcat  
sudo systemctl enable tomcat

setup tomcat

Une fois démarré, vérifiez le service tomcat en utilisant la commande ci-dessous. Assurez-vous que votre service Tomcat fonctionne comme suit.

sudo systemctl status tomcat

verify tomcat

Enfin, ouvrez votre navigateur web et visitez http://192.168.5.15:8080/. Si tout se passe bien, vous devriez voir la page d’index d’Apache Tomcat.

tomcat index

Création d’un administrateur Tomcat

À ce stade, vous avez installé Apache Tomcat sur votre serveur Debian. Dans l’étape suivante, vous allez configurer l’authentification pour Apache Tomcat et activer le gestionnaire Tomcat et le gestionnaire d’hôtes.

Pour commencer, éditez le fichier de configuration Tomcat /etc/tomcat10/tomcat-users.xml en utilisant l’éditeur nano.

sudo nano /etc/tomcat10/tomcat-users.xml

Insérez les lignes ci-dessous entre la section ‘tomcat-users‘. Assurez-vous de changer le nom d’utilisateur par défaut admin et le mot de passe tomcatadmin avec vos identifiants.

Enregistrez et quittez le fichier.

Maintenant, ouvrez le fichier de configuration pour le gestionnaire Tomcat et le gestionnaire d’hôtes en utilisant l’éditeur nano.

sudo nano /usr/share/tomcat10-admin/host-manager/META-INF/context.xml  
sudo nano /usr/share/tomcat10-admin/manager/META-INF/context.xml

‘*, la configuration sera désactivée ou commentée.

Enregistrez le fichier et quittez l’éditeur.

Ensuite, redémarrez le service tomcat avec la commande ci-dessous pour appliquer la nouvelle configuration Tomcat.

sudo systemctl restart tomcat

Enfin, visitez http://192.168.5.15:8080/manager pour accéder au gestionnaire Tomcat, et http://192.168.5.15:8080/host-manager pour accéder au gestionnaire d’hôtes Tomcat. Saisissez votre utilisateur admin et votre mot de passe lorsque vous y êtes invité et cliquez sur Se connecter.

tomcat login

Si cela réussit, vous devriez voir le tableau de bord du gestionnaire Apache Tomcat.

tomcat manager

Pour le gestionnaire d’hôtes Tomcat, voici à quoi cela ressemble :

tomcat host manager

Configuration de Nginx comme proxy inverse

Dans ce guide, vous allez exécuter Apache Tomcat avec Nginx comme proxy inverse. Dans cette section, vous allez installer nginx et configurer un bloc de serveur comme proxy inverse pour Tomcat qui fonctionne sur le port 8080.

Exécutez la commande ci-dessous pour installer Nginx sur votre système. Tapez y pour confirmer l’installation.

sudo apt install nginx

install nginx

Une fois l’installation terminée, créez une nouvelle configuration de bloc de serveur /etc/nginx/sites-available/tomcat.conf en utilisant l’éditeur nano.

sudo nano /etc/nginx/sites-available/tomcat.conf

Ajoutez la configuration ci-dessous pour configurer Nginx comme proxy inverse pour Apache Tomcat.

server {  
listen 80;  
  
server_name tomcat.howtoforge.local;  
access_log /var/log/nginx/tomcat-access.log;  
error_log /var/log/nginx/tomcat-error.log;  
  
location / {  
proxy_set_header X-Forwarded-Host $host;  
proxy_set_header X-Forwarded-Server $host;  
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;  
proxy_pass http://127.0.0.1:8080/;  
}  
}

Enregistrez et quittez le fichier une fois terminé.

Maintenant, activez la configuration du bloc de serveur et vérifiez votre syntaxe Nginx. Si tout se passe bien, vous devriez obtenir une sortie telle que ‘test est réussi - la syntaxe est correcte‘.

sudo ln -s /etc/nginx/sites-available/tomcat.conf /etc/nginx/sites-enabled/  
sudo nginx -t

Ensuite, redémarrez le service Nginx pour appliquer les nouvelles modifications et vérifiez-le pour vous assurer que le service fonctionne.

sudo systemctl restart nginx  
sudo systemctl status nginx

Si Nginx fonctionne, vous devriez obtenir la sortie suivante :

verify nginx

Enfin, retournez à votre navigateur web et visitez http://tomcat.howtoforge.local/. Vous devriez voir la page d’index par défaut d’Apache Tomcat.

tomcat nginx reverse proxy

Conclusion

Félicitations ! Vous avez maintenant installé Apache Tomcat 10 sur le serveur Debian 12. Vous avez appris deux méthodes pour installer Apache Tomcat, via le dépôt APT et manuellement via le paquet binaire. À la fin, vous avez également appris comment configurer Nginx comme proxy inverse pour votre installation Tomcat.