Comment installer Nexus Repository Manager sur Ubuntu 22.04

Nexus est l’un des gestionnaires de dépôts les plus populaires dans le monde DevOps. Il vous permet de stocker et de récupérer des artefacts de construction et fournit également des fonctionnalités pour pousser et tirer des artefacts via des outils d’intégration CI et IDE tels que Visual Studio et Jenkins.

Il existe deux versions du gestionnaire de dépôts Nexus : la version commerciale et la version open source. Il prend en charge de nombreux formats tels que PyPi, Docker, Yum, APT, Helm, npm, Go, R, et bien d’autres.

Utiliser Nexus comme dépôt permet à vos développeurs d’obtenir et de gérer des paquets sur le gestionnaire de dépôts centralisé, ce qui donne également à l’équipe de développement une source unique de vérité pour chaque paquet.

Dans ce tutoriel, nous allons expliquer comment installer le Nexus Repository Manager sur un serveur Ubuntu 22.04. Ce tutoriel inclut également l’installation de certains paquets tels que Java OpenJDK et le serveur web Nginx qui sera utilisé comme proxy inverse.

Prérequis

Avant de commencer, vous aurez besoin des éléments suivants :

• Un serveur Ubuntu 22.04.
• Un utilisateur non-root avec sudo/administrateur activé.
• Un nom de domaine pointant vers l’adresse IP de votre serveur Ubuntu (pour la production).

Installation de Java OpenJDK 8

Le Nexus Repository Manager nécessite Java OpenJDK et JRE v8. Le dépôt par défaut d’Ubuntu fournit plusieurs versions de Java, donc maintenant vous allez installer Java OpenJDK et JRE v8 à partir du dépôt Ubuntu.

Avant d’installer un paquet, exécutez la commande apt ci-dessous pour mettre à jour et rafraîchir l’index des paquets de vos dépôts.

sudo apt update

Maintenant, installez Java OpenJDK 8 via la commande apt ci-dessous. Entrez Y lorsque vous êtes invité à confirmer l’installation et appuyez sur ENTRÉE pour continuer.

sudo apt install openjdk-8-jdk

Une fois Java installé, vérifiez la version de Java sur votre système en utilisant la commande suivante.

java -version

Vous verrez la sortie dans la capture d’écran suivante :

Configuration du système

Pour installer Nexus, vous devrez créer un nouvel utilisateur Linux dédié avec un shell valide et également configurer le nombre maximum de fichiers ouverts pour les limites dures et molles à ‘65536‘.

Exécutez la commande suivante pour créer un nouvel utilisateur dédié pour Nexus avec le nom ‘nexus‘.

sudo useradd -d /opt/nexus -s /bin/bash nexus  
sudo passwd nexus

Ensuite, définissez la limite à ‘65536‘ en utilisant la commande ci-dessous. Cela n’affectera temporairement que le système actuel. Pour le rendre permanent, vous pouvez créer un nouveau fichier de configuration que vous ferez à l’étape suivante.

ulimit -n 65536

Pour configurer ulimit de manière permanente, créez un nouveau fichier de configuration ‘/etc/security/limits.d/nexus.conf‘ en utilisant l’éditeur nano.

sudo nano /etc/security/limits.d/nexus.conf

Ajoutez la configuration suivante au fichier. Dans cet exemple, vous configurez ulimit pour l’utilisateur spécifique ‘nexus‘ avec la valeur ‘65536‘.

nexus - nofile 65536

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Avec toutes les exigences de base en place et configurées, vous êtes prêt à installer le Nexus Repository Manager sur votre système Ubuntu.

Installation du Nexus Repository Manager

Le Nexus Repository Manager peut être installé via le paquet de distribution que vous pouvez télécharger depuis la page de téléchargement officielle de Sonatype. Au moment de la rédaction de cet article, la dernière version de Nexus est v3.41.1. Maintenant, vous allez télécharger le paquet de distribution du Nexus Repository Manager et configurer l’installation de Nexus.

Téléchargez le paquet du Nexus Repository Manager via la commande wget comme ci-dessous. Si le processus de téléchargement est terminé, vous verrez le fichier ‘nexus-3.41.1-01-unix.tar.gz’ dans votre répertoire de travail actuel.

wget https://download.sonatype.com/nexus/3/nexus-3.41.1-01-unix.tar.gz

Maintenant, extrayez le fichier ‘nexus-3.41.1-01-unix.tar.gz‘ via la commande tar ci-dessous. Et vous devriez obtenir deux répertoires, ‘nexus-3.41.1-01‘ et ‘sonatype-work‘.

Le répertoire ‘nexus-3.41.1-01‘ est le répertoire principal pour le paquet Nexus, et le répertoire ‘sonatype-work’ est le répertoire de travail principal pour Nexus.

tar xzf nexus-3.41.1-01-unix.tar.gz

Ensuite, déplacez ces répertoires extraits vers ‘/opt’ en utilisant la commande suivante. Le répertoire du paquet Nexus sera ‘/opt/nexus’ et le répertoire de travail de Nexus sera ‘/opt/sonatype-work‘.

mv nexus-3.41.1-01 /opt/nexus  
mv sonatype-work /opt/

Enfin, changez la propriété des deux répertoires à l’utilisateur et au groupe ‘nexus’ via la commande chown ci-dessous.

chown -R nexus:nexus /opt/nexus /opt/sonatype-work

Ensuite, vous allez configurer votre installation de Nexus en modifiant certains des fichiers de configuration de Nexus.

Ouvrez le fichier ‘/opt/nexus/bin/nexus.rc’ en utilisant l’éditeur nano.

sudo nano /opt/nexus/bin/nexus.rc

Décommentez l’option ‘run_as_user‘ et changez la valeur en ‘nexus’. Avec cette configuration, vous exécuterez l’application Nexus en tant qu’utilisateur système ‘nexus‘.

run_as_user="nexus"

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, ouvrez le fichier de configuration ‘/etc/nexus/bin/nexus.vmoptions’ en utilisant l’éditeur nano pour configurer la mémoire maximale du tas pour Nexus.

sudo nano /etc/nexus/bin/nexus.vmoptions

Changez la mémoire maximale par défaut pour votre installation Nexus dans les options suivantes. Vous pouvez changer la taille à ‘1024m‘ en fonction de la mémoire que vous avez sur votre serveur.

-Xms1024m  
-Xmx1024m  
-XX:MaxDirectMemorySize=1024m

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Maintenant, modifiez le fichier de configuration ‘/opt/sonatype-work/nexus3/etc/nexus.properties‘ en utilisant l’éditeur nano.

sudo nano /opt/sonatype-work/nexus3/etc/nexus.properties

Décommentez l’option ‘application-host’ et changez la valeur en ‘127.0.0.1‘. Cela signifie que vous exécuterez Nexus sur localhost ou l’adresse IP ‘127.0.0.1‘.

application-host=127.0.0.1

Enregistrez le fichier et quittez l’éditeur.

Vous avez maintenant téléchargé et configuré le Nexus Repository Manager. Ensuite, vous allez configurer un fichier de service systemd pour Nexus.

Exécution de Nexus en tant que service SystemD

Lors d’une installation par défaut, le Nexus Repository Manager peut être exécuté manuellement via la commande binaire ‘nexus’ qui est disponible dans le répertoire ‘/opt/nexus/bin’. Mais, pour faciliter la gestion de Nexus, vous allez configurer un fichier de service systemd pour Nexus.

Exécuter Nexus avec un fichier de service systemd vous permet de gérer le processus nexus via la commande systemctl.

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

sudo /etc/systemd/system/nexus.service

Ajoutez la configuration suivante au fichier.

[Unit]  
Description=service nexus  
After=network.target  
  
[Service]  
Type=forking  
LimitNOFILE=65536  
ExecStart=/opt/nexus/bin/nexus start  
ExecStop=/opt/nexus/bin/nexus stop  
User=nexus  
Restart=on-abort  
  
[Install]  
WantedBy=multi-user.target

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour recharger le gestionnaire systemd et appliquer un nouveau fichier de service pour Nexus.

sudo systemctl daemon-reload

Démarrez et activez le ‘nexus.service‘ via la commande systemctl ci-dessous. Le Nexus Repository Manager démarrera maintenant à l’adresse IP locale 127.0.0.1 avec le port par défaut ‘8081’. De plus, le ‘nexus.service‘ s’exécutera automatiquement au démarrage du système.

sudo systemctl start nexus.service  
sudo systemctl enable nexus.service

Enfin, exécutez la commande suivante pour vérifier le ‘nexus.service’ et vous assurer que le service fonctionne.

sudo systemctl status nexus.service

Avec Nexus fonctionnant en tant que service systemd, vous pouvez maintenant configurer un proxy inverse pour Nexus.

Exécution de Nexus avec un proxy inverse

Le Nexus Repository Manager fonctionne maintenant à l’adresse IP locale ‘127.0.0.1’ avec le port par défaut ‘8081’. Pour le rendre accessible depuis l’extérieur du réseau, vous utiliserez le proxy inverse Nginx qui fonctionnera sur les ports HTTP/HTTPS standard.

Exécutez la commande apt suivante pour installer le serveur web Nginx sur votre système Ubuntu. Lorsque vous êtes invité à confirmer l’installation, entrez Y et appuyez sur ENTRÉE pour continuer.

sudo apt install nginx

Une fois Nginx installé, exécutez la commande systemctl suivante pour vérifier et valider le service nginx. Vous devriez voir que le service nginx est activé et s’exécutera automatiquement au démarrage du système. Et l’état du service nginx est en cours d’exécution.

sudo systemctl is-enabled nginx  
sudo systemctl status nginx

Ensuite, créez une nouvelle configuration de bloc de serveur ‘/etc/nginx/sites-available/nexus‘ en utilisant l’éditeur nano.

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

Ajoutez la configuration Nginx suivante au fichier et assurez-vous de changer le nom de domaine.

upstream nexus3 {  
  server 127.0.0.1:8081;  
}  
  
server {  
    listen 80;  
    server_name nexus.howtoforge.local;  
  
    location / {  
        proxy_pass http://nexus3/;  
        proxy_http_version 1.1;  
        proxy_set_header Upgrade $http_upgrade;  
        proxy_set_header Connection "upgrade";  
        proxy_set_header Host $http_host;  
  
        proxy_set_header X-Real-IP $remote_addr;  
        proxy_set_header X-Forward-For $proxy_add_x_forwarded_for;  
        proxy_set_header X-Forward-Proto http;  
        proxy_set_header X-Nginx-Proxy true;  
  
        proxy_redirect off;  
    }  
}

Enregistrez le fichier et quittez l’éditeur.

Ensuite, exécutez la commande suivante pour activer la configuration du bloc de serveur pour Nexus en créant un lien symbolique du fichier de configuration vers le répertoire ‘sites-enabled‘. Ensuite, vérifiez la configuration Nginx pour vous assurer que Nginx est configuré correctement.

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

Si votre configuration Nginx est correctement configurée, vous devriez obtenir un message de sortie tel que “test réussi”.

Enfin, exécutez la commande suivante pour redémarrer le service Nginx et appliquer la nouvelle configuration de bloc de serveur pour Nexus.

sudo systemctl restart nginx

Vous avez maintenant configuré le serveur web Nginx comme un proxy inverse pour le Nexus Repository Manager sur votre machine Ubuntu. Vous pouvez maintenant accéder à votre installation Nexus via votre nom de domaine.

Installation du Nexus Repository Manager

À ce stade, le Nexus Repository Manager fonctionne sous le proxy inverse Nginx. Et il est accessible via le nom de domaine de votre installation.

Ouvrez le navigateur web et visitez le nom de domaine de votre installation Nexus (c’est-à-dire : http://nexus.howtoforge.local). Et vous devriez obtenir la page par défaut de Nexus comme ci-dessous.

Cliquez sur le bouton “Se connecter“ pour vous connecter au tableau de bord d’administration de Nexus.

Le mot de passe administrateur par défaut pour Nexus est stocké dans le fichier ‘/opt/sonatype-work/nexus3/admin.properties‘ avec le nom d’utilisateur par défaut admin.

Retournez à votre terminal et exécutez la commande suivante pour obtenir le mot de passe par défaut pour la connexion Nexus. Ensuite, copiez le mot de passe par défaut pour Nexus.

cat /opt/sonatype-work/nexus3/admin.properties

Ensuite, saisissez l’utilisateur admin et collez le mot de passe pour Nexus. Puis, cliquez sur “Se connecter“.

Vous allez maintenant obtenir l’assistant de configuration du Nexus Repository Manager. Cliquez sur “Suivant“ pour continuer.

Saisissez le nouveau mot de passe fort pour votre installation Nexus et répétez. Ensuite, cliquez sur “Suivant“ à nouveau.

Pour la configuration de l’accès anonyme. Sélectionnez l’option “Désactiver l’accès anonyme“ et cliquez sur “Suivant“.

Maintenant, cliquez sur “Terminer“ pour compléter la configuration de Nexus.

Après la configuration de Nexus, vous verrez maintenant le tableau de bord d’administration de Nexus. Dans la capture d’écran ci-dessous, vous pouvez voir le Nexus Repository Manager.

Enfin, vérifiez votre installation Nexus via le bouton de vérification de l’état en haut. Assurez-vous maintenant que tous les états du système sont vérifiés en vert, ce qui signifie que l’installation et la configuration de Nexus ont réussi.

Conclusion

Dans ce tutoriel, vous avez configuré le Nexus Repository Manager sur un serveur Ubuntu 22.04. Vous avez également configuré le serveur web Nginx comme un proxy inverse pour Nexus. Vous pouvez maintenant ajouter des dépôts de vos projets au gestionnaire de dépôts Nexus et centraliser la source de vos projets afin que vous puissiez facilement construire et distribuer vos applications aux développeurs.

Si vous êtes intéressé à exécuter Nexus en production, vous pouvez configurer la sécurité de votre nexus avec SSL/TLS via Letsencrypt.