Installer Nexus Repository en conteneur

Le moyen le plus rapide et le plus reproductible de faire tourner Nexus Repository est le conteneur : une image officielle, un volume pour les données, et Nexus est prêt en quelques minutes. Ce guide déploie Nexus Community Edition 3.77 avec Docker Compose, récupère le mot de passe admin initial et vérifie l'état du service par son API. Public visé : débutant à intermédiaire. Toutes les commandes ont été validées sur Nexus 3.77.1.

Ce que vous allez apprendre

• Déployer Nexus en conteneur avec une image épinglée.
• Persister les données dans un volume dédié.
• Récupérer le mot de passe admin initial.
• Vérifier que Nexus est prêt via son API de statut.

Prérequis

• Docker et Docker Compose installés.
• Environ 2 Go de RAM disponibles pour la JVM de Nexus.

Déployer avec Docker Compose

On décrit le service dans un compose.yaml. Deux points comptent : l'image est épinglée à une version précise (jamais latest), et les données vont dans un volume nommé pour survivre au redémarrage du conteneur.

compose.yaml

services:
  nexus:
    image: sonatype/nexus3:3.77.1
    container_name: nexus
    ports:
      - "8081:8081"
    environment:
      # Borne la mémoire de la JVM pour éviter les arrêts brutaux au démarrage.
      INSTALL4J_ADD_VM_PARAMS: "-Xms2g -Xmx2g -XX:MaxDirectMemorySize=2g"
    volumes:
      - nexus-data:/nexus-data
    restart: unless-stopped

volumes:
  nexus-data:

Lancez le conteneur :

docker compose up -d

Nexus a besoin de mémoire

La JVM de Nexus réserve d'emblée 2 Go. Sur une machine trop juste, le conteneur s'arrête au démarrage sans message clair. Les paramètres -Xms/-Xmx ci-dessus fixent cette réservation ; ne descendez pas sous 1,5 Go sous peine d'arrêts aléatoires.

Attendre le démarrage

Nexus met 1 à 3 minutes à démarrer au premier lancement, le temps d'initialiser sa base et ses dépôts par défaut. Son API de statut répond 200 quand il est prêt. On peut donc attendre proprement sans deviner :

until curl -sf http://localhost:8081/service/rest/v1/status >/dev/null; do
  echo "Nexus démarre..."; sleep 6
done
echo "Nexus est prêt"

Une fois prêt, l'interface est disponible sur http://localhost:8081.

Récupérer le mot de passe admin

À la première installation, Nexus génère un mot de passe admin aléatoire qu'il écrit dans un fichier à l'intérieur du conteneur. On le lit avec docker exec :

docker exec nexus cat /nexus-data/admin.password

ff5f64b0-0600-4f87-9b41-c0c27d1c40a7

Ce mot de passe sert à la première connexion avec l'utilisateur admin.

Première connexion

Ouvrez http://localhost:8081 et cliquez sur Sign In en haut à droite. La fenêtre de connexion rappelle d'ailleurs l'emplacement du mot de passe initial. Saisissez admin et le mot de passe lu à l'étape précédente :

Un assistant en trois étapes se lance alors. Il vous impose de changer le mot de passe admin, puis de choisir la politique d'accès anonyme :

• Activer l'accès anonyme : n'importe qui peut chercher, parcourir et télécharger sans identifiant. Pratique en lab, à réserver aux dépôts publics.
• Désactiver l'accès anonyme : chaque client et chaque outil de build devra s'authentifier. C'est le réglage attendu en entreprise.

Changez le mot de passe, désactivez l'anonyme en prod

Le mot de passe initial est un secret temporaire : l'assistant vous force à le changer, ne le contournez pas. En production, désactivez l'accès anonyme pour qu'aucun dépôt ne soit lisible sans authentification. En lab, l'accès anonyme en lecture simplifie les tests, mais ne le laissez jamais ainsi sur une instance exposée.

Vérifier l'installation

Au-delà du statut 200, l'API confirme la version et liste les dépôts par défaut créés à l'initialisation. Nexus arrive avec des dépôts prêts à l'emploi pour Maven, npm, PyPI, NuGet et Docker :

curl -s -u admin:VOTRE_MDP http://localhost:8081/service/rest/v1/repositories \
  | jq -r '.[] | "\(.type)\t\(.format)\t\(.name)"'

proxy    maven2   maven-central
group    maven2   maven-public
hosted   maven2   maven-releases
proxy    npm      npm-public-proxy
proxy    pypi     pypi-public-proxy

Ces dépôts illustrent les trois types de Nexus : un proxy met en cache un dépôt public, un hosted stocke vos artefacts privés, un group agrège plusieurs dépôts derrière une seule URL. Les guides suivants exploitent ces types pour un cache et un registre Docker.

Où sont stockées les données : le blob store

Comprendre ce point est essentiel pour la sauvegarde. Nexus range les fichiers (les .jar, .whl, couches d'image) dans un blob store, distinct de la base de données qui, elle, garde les métadonnées (quel composant, quelle version, quel dépôt). Le volume /nexus-data que vous avez monté contient les deux.

Dans Administration, Blob Stores, vous voyez le blob store default (type File), son nombre d'objets, sa taille et l'espace disque restant :

Sauvegardez la base ET le blob store, ensemble

Une sauvegarde utile couvre le blob store et la base de données pris à un état cohérent. Sauvegarder les fichiers sans les métadonnées (ou l'inverse) donne une restauration inexploitable : Nexus référencerait des blobs absents, ou stockerait des blobs qu'il ne connaît plus. En conteneur, sauvegardez le volume /nexus-data entier, idéalement après une tâche de sauvegarde Nexus qui met la base au repos.

Dépannage

Symptôme	Cause probable	Solution
Le conteneur s'arrête au démarrage	Mémoire insuffisante	Vérifier la RAM libre, garder -Xms/-Xmx à 2g
admin.password introuvable	Instance déjà initialisée	Le mot de passe a été changé ; le fichier disparaît après la première connexion
L'API répond 404	Mauvais port publié	Vérifier docker port nexus et l'URL
Données perdues au redémarrage	Volume non monté	Confirmer le volume nommé nexus-data:/nexus-data

Glissez pour voir

À retenir

• Nexus se déploie proprement en conteneur avec une image épinglée (sonatype/nexus3:3.77.1).
• Les données vivent dans un volume nommé /nexus-data, à préserver.
• Nexus démarre en 1 à 3 minutes ; l'API /service/rest/v1/status signale la disponibilité.
• Le mot de passe admin initial se lit dans /nexus-data/admin.password et doit être changé à la première connexion.
• Nexus crée des dépôts par défaut illustrant les types proxy, hosted et group.

Prochaines étapes

Dépôt proxy et cache Mettre Nexus en cache devant PyPI, npm ou Maven.

Registre Docker Créer un dépôt docker privé et pousser une image.

Retour au hub Nexus Concepts, éditions et bonnes pratiques.

×

📖 Voir la documentation →