Comment installer le serveur d'applications Java WildFly avec un proxy inverse Nginx sur Ubuntu 20.04

WildFly, ou précédemment connu sous le nom de JBoss AS, est une implémentation légère du conteneur JEE (Java Enterprise Edition). Son environnement d’exécution d’application flexible est écrit en Java et vous aide à créer des applications fantastiques.

WildFly est un environnement d’exécution d’application multi-plateforme fonctionnant sur les systèmes d’exploitation Linux, macOS et Windows. Créé par JBoss Inc, il a été acquis par RedHat en 2006 et est devenu WildFly.

Dans ce tutoriel, nous allons vous montrer comment installer WildFly sur le dernier Ubuntu 20.04. Nous allons installer la dernière version de WildFly 20, activer la console d’administration pour WildFly, créer l’utilisateur administrateur WildFly et configurer Nginx comme un proxy inverse pour WildFly.

Prérequis

Pour ce guide, nous allons installer WildFly sur le dernier serveur Ubuntu 20.04 FocalFossa avec 2 Go de RAM, 50 Go d’espace disque libre et 2 CPU.

Que allons-nous faire ?

• Installer Java OpenJDK 11
• Ajouter un nouvel utilisateur et télécharger WildFly
• Configuration de base de WildFly
• Activer la console d’administration de WildFly
• Configurer l’utilisateur administrateur pour WildFly
• Configurer Nginx comme un proxy inverse pour WildFly
• Tester

Étape 1 - Installer Java OpenJDK

Tout d’abord, nous allons installer Java OpenJDK sur le serveur Ubuntu 20.04. Nous allons utiliser Java OpenJDK 11 pour notre installation de WildFly, qui est la version par défaut des paquets Java dans le dépôt Ubuntu 20.04.

Mettez à jour tous les dépôts de paquets et installez Java OpenJDK en utilisant la commande apt ci-dessous.

sudo apt update  
sudo apt install default-jdk

Une fois l’installation terminée, vérifiez la version de Java en utilisant la commande suivante.

java -version

Voici le résultat que vous obtiendrez.

openjdk version "11.0.7" 2020-04-14  
OpenJDK Runtime Environment (build 11.0.7+10-post-Ubuntu-3ubuntu1)  
OpenJDK 64-Bit Server VM (build 11.0.7+10-post-Ubuntu-3ubuntu1, mixed mode, sharing)

En conséquence, l’installation de Java OpenJDK sur Ubuntu 20.04 est terminée.

Étape 2 - Ajouter un nouvel utilisateur et télécharger WildFly

Dans cette étape, nous allons créer un nouvel utilisateur système et un groupe ‘wildfly’ et télécharger le code source de wildfly dans le répertoire ‘/opt/wildfly’.

Maintenant, créez un nouvel utilisateur et un groupe nommé ‘wildfly’ en utilisant les commandes ci-dessous.

groupadd -r wildfly  
useradd -r -g wildfly -d /opt/wildfly -s /sbin/nologin wildfly

Ensuite, allez dans le répertoire ‘/opt’ et téléchargez le code source de wildfly en utilisant la commande wget comme ci-dessous.

cd /opt/  
wget -q wget https://download.jboss.org/wildfly/20.0.1.Final/wildfly-20.0.1.Final.tar.gz

Le code source de wildfly a été téléchargé.

Maintenant, extrayez le code source de wildfly et renommez le répertoire extrait en ‘wildfly’.

tar -xf wildfly-20.0.1.Final.tar.gz  
mv wildfly-20.0.1.Final wildfly

Après cela, changez la propriété du répertoire ‘wildfly’ à l’utilisateur et au groupe ‘wildfly’.

chown -RH wildfly:wildfly /opt/wildfly

En conséquence, le répertoire d’installation de wildfly est situé dans le répertoire ‘/opt/wildfly’. Le service wildfly fonctionnera sous le nouvel utilisateur nommé ‘wildfly’ que nous venons de créer.

Étape 3 - Configuration de base de WildFly

Après avoir téléchargé le code source de wildfly, nous allons configurer wildfly sur le système Ubuntu.

Créez un nouveau répertoire de configuration ‘/etc/wildfly’ et copiez la configuration d’exemple ‘wildfly.conf’ à l’intérieur.

mkdir -p /etc/wildfly  
cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.conf /etc/wildfly/

Ensuite, copiez le fichier de service ‘wildfly.service’ dans le répertoire ‘/etc/systemd/system’.

cp /opt/wildfly/docs/contrib/scripts/systemd/wildfly.service /etc/systemd/system/

Après cela, copiez l’exemple de script de lancement de wildfly dans le répertoire ‘/opt/wildfly/bin’ et rendez-le exécutable.

cp /opt/wildfly/docs/contrib/scripts/systemd/launch.sh /opt/wildfly/bin/  
chmod +x /opt/wildfly/bin/*.sh

Maintenant, rechargez le gestionnaire systemd pour appliquer le nouveau fichier ‘wildfly.service’.

systemctl daemon-reload

Démarrez le service wildfly et ajoutez-le au démarrage du système.

systemctl start wildfly  
systemctl enable wildfly

Le service wildfly est en cours d’exécution sur le système Ubuntu avec la configuration par défaut.

Vérifiez le service wildfly en utilisant la commande suivante.

ss -plnt  
systemctl status wildfly

Et vous obtiendrez le résultat ci-dessous.

Comme on peut le voir, wildfly fonctionne en tant que service systemd sur le port TCP par défaut ‘8080’ sur le système Ubuntu.

Étape 4 - Activer la console d’administration WildFly

Dans cette étape, nous allons configurer wildfly pour qu’il fonctionne sur l’adresse IP locale ‘127.0.0.1’ et activer sa console d’administration. Nous allons modifier la configuration de wildfly ‘wildfly.conf’, le script de démarrage de wildfly ‘launch.sh’ et le fichier de service wildfly ‘wildfly.service’.

Modifiez la configuration de wildfly ‘/etc/wildfly/wildfly.conf’ en utilisant l’éditeur vim.

vim /etc/wildfly/wildfly.conf

Maintenant, changez la valeur de ‘WILDFLY_BIND’ avec l’adresse IP locale ‘127.0.0.1’.

WILDFLY_BIND=127.0.0.1

Pour activer la console d’administration de wildfly, ajoutez la configuration ‘WILDFLY_CONSOLE_BIND’ ci-dessous.

WILDFLY_CONSOLE_BIND=127.0.0.1

Enregistrez et fermez.

Ensuite, modifiez le script de démarrage pour wildfly ‘/opt/wildfly/bin/launch.sh’ en utilisant l’éditeur vim.

vim /opt/wildfly/bin/launch.sh

Sur les lignes ‘domain.sh‘ et ‘standalone.sh‘, ajoutez une option supplémentaire pour activer la console d’administration de wildfly comme ci-dessous.

if [[ "$1" == "domain" ]]; then  
    $WILDFLY_HOME/bin/domain.sh -c $2 -b $3 -bmanagement $4  
else  
    $WILDFLY_HOME/bin/standalone.sh -c $2 -b $3 -bmanagement $4  
fi

Enregistrez et fermez.

Ensuite, modifiez le fichier de service par défaut pour wildfly ‘/etc/systemd/system/wildfly.service’ en utilisant l’éditeur vim.

vim /etc/systemd/system/wildfly.service

Sur la ligne ‘ExecStart=/opt/wildfly/bin/launch.sh….‘, ajoutez l’option ‘$WILDFLY_CONSOLE_BIND‘ comme ci-dessous.

ExecStart=/opt/wildfly/bin/launch.sh $WILDFLY_MODE $WILDFLY_CONFIG $WILDFLY_BIND $WILDFLY_CONSOLE_BIND

Enregistrez et fermez.

Maintenant, rechargez le gestionnaire systemd et redémarrez le service wildfly.

systemctl daemon-reload  
systemctl restart wildfly

Le service wildfly fonctionne avec la console d’administration activée, vérifiez en utilisant la commande ci-dessous.

ss -plnt  
systemctl status wildfly

Voici le résultat que vous obtiendrez.

En conséquence, wildfly fonctionne sur l’adresse IP locale ‘127.0.0.1‘ avec le port TCP par défaut ‘8080‘, et la console d’administration de wildfly activée sur le port TCP ‘9990‘.

Étape 5 - Configurer l’utilisateur administrateur WildFly

Dans cette étape, nous allons créer un nouvel utilisateur pour gérer wildfly en utilisant le script ‘add-user.sh’ fourni par wildfly.

Exécutez le script wildfly ‘add-user.sh’ comme ci-dessous.

sh /opt/wildfly/bin/add-user.sh

Pour le type d’utilisateur, tapez ‘a‘ pour créer l’utilisateur de gestion (administrateur pour gérer wildfly).

Quel type d'utilisateur souhaitez-vous ajouter ?   
a) Utilisateur de gestion (mgmt-users.properties)   
b) Utilisateur d'application (application-users.properties)  
(a): a

Maintenant, tapez votre nom d’utilisateur et votre mot de passe, et assurez-vous d’utiliser un mot de passe sécurisé.

Entrez les détails du nouvel utilisateur à ajouter.  
Utilisation du royaume 'ManagementRealm' tel que découvert dans les fichiers de propriétés existants.  
Nom d'utilisateur : hakase  
Les recommandations de mot de passe sont listées ci-dessous. Pour modifier ces restrictions, éditez le fichier de configuration add-user.properties.  
 - Le mot de passe doit être différent du nom d'utilisateur  
 - Le mot de passe ne doit pas être l'une des valeurs restreintes suivantes {root, admin, administrator}  
 - Le mot de passe doit contenir au moins 8 caractères, 1 caractère(s) alphabétique(s), 1 chiffre(s), 1 symbole(s) non alphanumérique(s)  
Mot de passe :   
Ressaisissez le mot de passe :

Pour le groupe du nouvel utilisateur, appuyez simplement sur ‘Entrée‘ pour continuer.

Quels groupes voulez-vous que cet utilisateur appartienne ? (Veuillez entrer une liste séparée par des virgules, ou laissez vide pour aucun)[  ]:

Ensuite, tapez ‘yes‘ pour ajouter votre utilisateur au ‘ManagementRealm‘ sur wildfly.

Sur le point d'ajouter l'utilisateur 'hakase' pour le royaume 'ManagementRealm'  
Est-ce correct oui/non ? yes  
Utilisateur 'hakase' ajouté au fichier '/opt/wildfly/standalone/configuration/mgmt-users.properties'  
Utilisateur 'hakase' ajouté au fichier '/opt/wildfly/domain/configuration/mgmt-users.properties'  
Utilisateur 'hakase' avec groupes ajouté au fichier '/opt/wildfly/standalone/configuration/mgmt-groups.properties'  
Utilisateur 'hakase' avec groupes ajouté au fichier '/opt/wildfly/domain/configuration/mgmt-groups.properties'

Tapez ‘yes‘ pour activer votre utilisateur en tant que processus pour gérer le contrôleur hôte maître-esclave de wildfly.

Cet nouvel utilisateur sera-t-il utilisé pour qu'un processus AS se connecte à un autre processus AS ?   
par exemple, pour un contrôleur hôte esclave se connectant au maître ou pour une connexion à distance pour des appels EJB serveur à serveur.  
yes/no? yes  
Pour représenter l'utilisateur, ajoutez ce qui suit à la définition des identités du serveur 

En conséquence, l’utilisateur administrateur et de gestion pour wildfly a été créé.

Étape 6 - Configurer Nginx comme un proxy inverse pour WildFly

Dans cette étape, nous allons installer et configurer Nginx comme un proxy inverse pour wildfly sur le système Ubuntu.

Installez les paquets Nginx en utilisant la commande apt ci-dessous.

sudo apt install nginx -y

Une fois toute l’installation terminée, allez dans le répertoire de configuration ‘/etc/nginx/‘.

cd /etc/nginx/

Créez un nouveau fichier ‘proxy_headers.conf’ sous le répertoire ‘/etc/nginx/conf.d’ en utilisant l’éditeur vim.

vim conf.d/proxy_headers.conf

Collez la configuration suivante.

proxy_set_header Host $host;  
proxy_set_header X-Forwarded-Proto $scheme;  
add_header Front-End-Https on;  
add_header Cache-Control no-cache;

Enregistrez et fermez.

Ensuite, créez une nouvelle configuration d’hôte virtuel pour wildfly sous le répertoire ‘/etc/nginx/sites-available’.

vim sites-available/wildfly

Changez l’adresse IP avec la vôtre et collez la configuration à l’intérieur.

server {  
  listen          80;  
  server_name     SERVER-IP;  
  
  location / {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:8080;  
  }  
  
  location /management {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/management;  
  }  
  
  location /console {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/console;  
  }  
  
  location /logout {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990/logout;  
  }  
  
  location /error {  
    include conf.d/proxy_headers.conf;  
    proxy_pass http://127.0.0.1:9990;  
  }  
  
}

Enregistrez et fermez.

Ensuite, activez l’hôte virtuel wildfly et vérifiez la configuration de Nginx.

ln -s /etc/nginx/sites-available/wildfly /etc/nginx/sites-enabled/  
ginx -t

Maintenant, assurez-vous qu’il n’y a pas d’erreur, puis redémarrez le service Nginx.

systemctl restart nginx

En conséquence, l’installation et la configuration de Nginx en tant que proxy inverse pour wildfly ont été complétées.

Étape 7 - Tester

Ouvrez votre navigateur web et tapez l’adresse IP de votre serveur dans la barre d’adresse.

http://192.168.1.50/

Vous obtiendrez maintenant la page d’index par défaut de wildfly comme ci-dessous.

Ensuite, accédez à la console d’administration de wildfly sur le chemin URL ‘/console’ comme ci-dessous.

http://192.168.1.50/console/

Connectez-vous en utilisant votre utilisateur administrateur wildfly et votre mot de passe.

Vous obtiendrez maintenant le tableau de bord administrateur de wildfly comme ci-dessous.

En conséquence, l’installation de wildfly avec le proxy inverse Nginx sur le serveur Ubuntu 20.04 a été complétée avec succès.