Comment installer le serveur d'applications GlassFish avec Nginx en tant que proxy inverse sur Debian 12

GlassFish est une implémentation gratuite et open-source de la plateforme Java EE développée par Eclipse. C’est la première implémentation au monde de la plateforme Java EE qui fournit un serveur d’applications léger et permet de déployer plusieurs applications basées sur Java. GlassFish prend en charge plusieurs types de technologies d’applications Java telles que les Enterprise JavaBeans, JPA, JavaServer Faces, JMS, et bien d’autres.

GlassFish est l’un des meilleurs choix pour les développeurs afin de développer et déployer des applications basées sur Java. Il permet aux développeurs de créer des applications d’entreprise de manière pratique et avec une architecture évolutive. Le projet GlassFish a été initialement lancé par Sun Microsystem. Il est livré avec deux licences gratuites différentes - La Common Development and Distribution License et la GNU General Public License.

Dans ce guide, vous allez installer le serveur d’applications GlassFish sur Debian 12 dans un processus étape par étape. Vous allez également configurer Nginx en tant que proxy inverse pour votre installation GlassFish.

Prérequis

Pour commencer le processus, assurez-vous d’avoir les éléments suivants :

Un serveur Debian 12 avec au moins 4 Go de RAM ou de mémoire.
Un utilisateur non-root avec des privilèges sudo.

Installation de Java OpenJDK

GlassFish est un serveur d’applications pour déployer des applications Java. Pour installer GlassFish, vous devez d’abord installer Java sur votre système Debian. À ce moment, le dépôt Debian fournit Java OpenJDK 17, qui est compatible avec la dernière version de GlassFish.

Tout d’abord, mettez à jour et rafraîchissez votre dépôt Debian en utilisant la commande suivante.

sudo apt update

update repo

Une fois le dépôt mis à jour, installez le paquet default-jdk en exécutant la commande ci-dessous. En installant le paquet default-jdk, vous installerez Java OpenJDK 17.

sudo apt install default-jdk

Tapez y pour continuer l’installation.

install java

Après la fin de l’installation, vérifiez votre version de Java en utilisant la commande ci-dessous. Vous devriez voir que Java OpenJDK 17 est installé.

java -version

check java

Configuration du système

Après avoir installé Java OpenJDK, l’étape suivante consiste à configurer votre système Debian en installant des paquets supplémentaires tels que wget et unzip, en créant un nouvel utilisateur système glassfish, et en configurant la variable d’environnement JAVA_HOME.

Pour commencer, vous allez installer le paquet unzip et wget en exécutant la commande apt suivante.

sudo apt install unzip wget -y

install wget unzip

Maintenant, exécutez la commande ci-dessous pour créer un nouvel utilisateur système glassfish. Cet utilisateur sera utilisé pour exécuter votre installation GlasFish, qui sera située dans le répertoire /opt/glassfish.

sudo useradd -M -d /opt/glassfish -U -s /bin/false glassfish

Ensuite, créez un nouveau script bash /etc/profile.d/java.sh en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/profile.d/java.sh

Ajoutez la configuration suivante pour configurer la variable d’environnement JAVA_HOME et ajouter le chemin binaire Java au PATH du système.

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64  
export PATH=$PATH:$JAVA_HOME/bin

Enregistrez et fermez le fichier lorsque vous avez terminé.

Maintenant, chargez la nouvelle variable d’environnement dans /etc/profile.d/java.sh en utilisant la commande source ci-dessous.

source /etc/profile.d/java.sh

Enfin, exécutez la commande suivante pour vérifier les variables d’environnement PATH et JAVA_HOME du système.

echo $JAVA_HOME  
echo $PATH

Si tout se passe bien, vous devriez voir que le chemin JAVA_HOME est configuré sur le répertoire /usr/lib/jvm/java-17-openjdk-amd64, et le répertoire bin Java est ajouté au PATH du système.

Téléchargement du paquet binaire GlassFish

Avec Java OpenJDK installé et votre système Debian prêt, vous pouvez maintenant télécharger et installer GlassFish. Avant d’aller plus loin, consultez la page de téléchargement de GlassFish pour obtenir la dernière version de GlassFish. À ce moment, la dernière version de GlassFish est v7.0.10.

Allez dans le répertoire /tmp et téléchargez le paquet binaire GlassFish via la commande wget ci-dessous. Une fois le processus de téléchargement terminé, vous devriez voir le fichier glassfish-7.0.10.zip.

cd /tmp  
wget https://download.eclipse.org/ee4j/glassfish/glassfish-7.0.10.zip

Extrayez le fichier glassfish-7.0.10.zip dans le répertoire /opt via la commande unzip ci-dessous. Le paquet GlassFish sera extrait dans le répertoire /opt/glassfish7.

unzip glassfish-7.0.10.zip -d /opt

Enfin, renommez le répertoire extrait de /opt/glassfish7 à /opt/glassfish. Ensuite, changez la propriété du répertoire /opt/glassfish à l’utilisateur glassfish.

mv /opt/glassfish7 /opt/glassfish  
sudo chown -R glassfish:glassfish /opt/glassfish

Exécution de GlassFish en tant que service Systemd

Après avoir téléchargé le paquet binaire GlassFish, vous allez créer un nouveau fichier de service systemd qui sera utilisé pour exécuter GlassFish. Cela vous permet de gérer GlassFish via l’utilitaire systemctl et d’exécuter GlassFish en arrière-plan en tant que service systemd.

Pour exécuter GlassFish en tant que service systemd, exécutez la commande de l’éditeur nano ci-dessous pour créer un nouveau fichier /etc/systemd/system/glassfish.service.

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

Insérez la configuration suivante dans le fichier.

[Unit]  
Description = Serveur GlassFish v7  
After = syslog.target network.target  
  
[Service]  
User=glassfish  
ExecStart=/opt/glassfish/bin/asadmin start-domain  
ExecReload=/opt/glassfish/bin/asadmin restart-domain  
ExecStop=/opt/glassfish/bin/asadmin stop-domain  
Type = forking  
  
[Install]  
WantedBy = multi-user.target

Enregistrez et fermez le fichier lorsque vous avez terminé.

Maintenant, exécutez la commande systemctl suivante pour recharger le gestionnaire systemd et appliquer les modifications.

sudo systemctl daemon-reload

Avec le gestionnaire systemd rechargé, démarrez et activez le service glassfish en utilisant la commande suivante.

sudo systemctl start glassfish  
sudo systemctl enable glassfish

run glassfish systemd

Enfin, vérifiez l’état du service glassfish en utilisant la commande ci-dessous.

sudo systemctl status glassfish

Si tout se passe bien, vous devriez voir que l’état de glassfish est actif (en cours d’exécution), et qu’il est activé.

check glassfish service

Configuration de l’utilisateur et sécurisation de l’administration de GlassFish

À ce stade, GlassFish est opérationnel. Maintenant, vous allez configurer l’installation de GlassFish en changeant le mot de passe par défaut pour la console d’administration et en activant l’administration sécurisée. Cela peut être fait via la commande asadmin qui est disponible dans le répertoire /opt/glassfish/bin.

Exécutez la ligne de commande asadmin ci-dessous pour changer le mot de passe admin pour votre installation GlassFish.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 change-admin-password

Au cours du processus, vous serez invité à fournir les informations suivantes :

Entrez l’utilisateur admin par défaut pour GlassFish.
Appuyez sur ENTRER lorsque vous êtes invité à entrer le mot de passe. L’utilisateur admin par défaut pour GlassFish n’a pas de mot de passe.
Maintenant, entrez le nouveau mot de passe admin pour GlassFish et répétez.

Lorsque le processus est terminé, vous devriez recevoir un message comme suit :

Ensuite, exécutez la commande asadmin ci-dessous pour activer l’administration sécurisée sur votre installation GlassFish.

Essentiellement, l’administration sécurisée permet des communications sécurisées via SSL entre le serveur d’administration de domaine (DAS), les instances distantes et les clients d’administration, y compris l’utilitaire asadmin, la console d’administration et les clients REST.

sudo -u glassfish /opt/glassfish/bin/asadmin --port 4848 enable-secure-admin

Entrez votre utilisateur admin GlassFish et votre mot de passe, puis appuyez sur Entrée. Une fois terminé, la sortie suivante sera affichée.

Après l’activation de l’administration sécurisée, exécutez la commande suivante pour redémarrer le service glassfish et appliquer les modifications.

sudo systemctl restart glassfish

Maintenant, ouvrez votre navigateur web et visitez l’adresse IP du serveur suivie du port 8080, par exemple http://192.168.5.15:8080/. Si votre installation GlassFish est réussie, vous devriez obtenir la page suivante, qui confirme que GlassFish fonctionne.

glassfish index

Enfin, ouvrez un nouvel onglet et visitez la même adresse IP du serveur avec le port 4848 (c’est-à-dire : https://192.168.5.15:4848/) pour accéder à la page d’administration de GlassFish. Acceptez les certificats SSL/TLS sur votre navigateur web, et si cela réussit, vous devriez obtenir la page de connexion à l’administration de GlassFish ci-dessous.

glassfish login page

Installation de Nginx en tant que proxy inverse

Dans ce guide, vous exécuterez GlassFish avec Nginx en tant que proxy inverse. Maintenant, vous allez installer Nginx sur votre machine Debian et créer une nouvelle configuration de bloc serveur pour GlassFish. Dans ce cas, nous utiliserons un nom de domaine local glassfish.howtoforge.local.

Tout d’abord, installez Nginx sur votre système Debian en utilisant la commande apt suivante. Tapez y pour continuer l’installation.

sudo apt install nginx

install nginx

Après l’installation de Nginx, créez une nouvelle configuration de bloc serveur /etc/nginx/sites-available/glassfish en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/nginx/sites-available/glassfish

Insérez la configuration suivante et assurez-vous de changer le paramètre server_name avec votre nom de domaine local.

upstream glassfish {  
    server 127.0.0.1:8080 weight=100 max_fails=5 fail_timeout=5;  
}  
  
server {  
    listen          80;  
    server_name     glassfish.howtoforge.local;  
  
    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://glassfish/;  
    }  
}

Enregistrez et quittez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour activer la configuration de bloc serveur glassfish et vérifier la syntaxe de Nginx pour vous assurer que vous avez une syntaxe correcte.

sudo ln -s /etc/nginx/sites-available/glassfish /etc/nginx/sites-enabled/  
sudo nginx -t

Si vous avez la bonne syntaxe Nginx, vous devriez obtenir la sortie ‘test is successful - syntax is ok‘.

setup nginx reverse proxy

Maintenant, vous pouvez redémarrer le service Nginx et appliquer les modifications. Ensuite, vérifiez le service Nginx pour vous assurer que le service fonctionne.

sudo systemctl restart nginx  
sudo systemctl status nginx

Dans la sortie suivante, vous devriez voir que le service Nginx fonctionne.

check nginx

Accéder à l’installation de GlassFish

Dans la dernière section, vous allez accéder à votre installation GlassFish depuis la machine cliente. Vous pouvez utiliser n’importe quel système d’exploitation comme votre machine cliente.

Modifiez le fichier /etc/hosts sur votre machine locale et insérez la configuration suivante. Assurez-vous de changer l’adresse IP du serveur et le nom de domaine local. Si vous utilisez un client Windows, assurez-vous de modifier le fichier C:\Windows\System32\drivers\etc\hosts en tant qu’administrateur.

192.168.5.15    glassfish.howtoforge.local

Maintenant, retournez à votre navigateur web et visitez le nom de domaine de votre installation GlassFish, par exemple http://glassfish.howtoforge.local/. Si votre configuration de proxy inverse Nginx est réussie, vous devriez voir la page d’index par défaut de GlassFish comme suit.

glassfish nginx reverse proxy

Ensuite, visitez la page d’administration de GlassFish sur le port 4848 (c’est-à-dire : https://glassfish.howtoforge.local:4848/). Sur la page de connexion, saisissez votre utilisateur admin et votre mot de passe, puis cliquez sur Connexion.

GlassFish login

Si votre installation est réussie, vous devriez obtenir le tableau de bord d’administration de GlassFish comme suit :

GlassFish dashboard

Maintenant, cliquez sur le menu Serveur pour vérifier l’état de votre installation GlassFish. Dans cet exemple, vous devriez voir que GlassFish 7.0 est installé avec l’état En cours d’exécution.

GlassFish status

À partir de là, vous pouvez maintenant gérer votre serveur d’applications GlassFish.

Conclusion

En conclusion, vous avez maintenant installé avec succès le serveur d’applications GlassFish sur un serveur Debian 12, en suivant les instructions étape par étape. Vous avez installé GlassFish avec Java OpenJDK 17 et Nginx en tant que proxy inverse, et également sécurisé GlassFish en changeant le mot de passe admin par défaut et en activant l’administration sécurisée. Vous pouvez maintenant commencer à déployer votre application avec GlassFish.