Aller au contenu principal

install-mongodb-ubuntu

Comment installer mongodb sur Ubuntu, Lunix​

Utilisez ce didacticiel pour installer MongoDB 8.0 Community Edition sur les versions LTS (support à long terme) d'Ubuntu Linux à l'aide du gestionnaire de packages apt.

Plateform supporter.​

MongoDB 8.0 Community Edition prend en charge les versions Ubuntu LTS (support à long terme) 64 bits suivantes sur l'architecture x86_64 :

  • 24.04 LTS ("Noble")
  • 22.04 LTS ("Jammy")
  • 20.04 LTS ("Focal")

MongoDB ne prend en charge que les versions 64 bits de ces plates-formes. Pour déterminer quelle version d'Ubuntu est exécutée sur votre hôte, exécutez la commande suivante sur le terminal de l'hôte :

cat /etc/lsb-release

MongoDB 8.0 Community Edition sur Ubuntu prend également en charge l'architecture ARM64 sur certaines plates-formes.

ARM64 ARM64-debian-ubuntu

  1. [Notes]

Avant de déployer MongoDB dans un environnement de production, consultez le document Notes de [production-pour-les-déploiements-autogérés] (https://www.mongodb.com/docs/manual/administration/production-notes/) qui propose des considérations sur les performances et des recommandations de configuration pour les déploiements de production MongoDB.

Installer MongoDB Community Edition​

Suivez ces étapes pour installer MongoDB Community Edition à l'aide du gestionnaire de paquets apt.

  1. Importer la clé publique
sudo apt-get install gnupg curl
  1. Pour importer la clé GPG publique MongoDB, exécutez la commande suivante :
curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
   --dearmor
  1. Créez le fichier de liste.

Créez le fichier de liste /etc/apt/sources.list.d/mongodb-org-8.0.list pour votre version d'Ubuntu.

Create the list file for Ubuntu 24.04 (Noble):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
  1. Recharger la base de données des paquets.
sudo apt-get update
  1. Installez le serveur communautaire MongoDB.
sudo apt-get install -y mongodb-org

Pour obtenir de l'aide sur la résolution des erreurs rencontrées lors de l'installation de MongoDB sur Ubuntu, consultez notre guide de dépannage. label-install-ubuntu-troubleshooting

Exécuter MongoDB Community Edition​

  1. Repertoires:

Si vous avez effectué l'installation via le gestionnaire de paquets, le répertoire de données /var/lib/mongodb et le répertoire de journaux /var/log/mongodb sont créés lors de l'installation.

[!Important]

Par défaut, MongoDB s'exécute à l'aide du compte utilisateur mongodb. Si vous modifiez l'utilisateur qui exécute le processus MongoDB, vous devez également modifier l'autorisation d'accès aux répertoires de données et de journaux pour donner à cet utilisateur l'accès à ces répertoires.

  1. Fichier de configuration

Le paquet officiel de MongoDB comprend un fichier de configuration (/etc/mongod.conf). Ces paramètres (tels que les spécifications des répertoires de données et de journaux) prennent effet au démarrage. En d'autres termes, si vous modifiez le fichier de configuration alors que l'instance MongoDB est en cours d'exécution, vous devez redémarrer l'instance pour que les modifications soient prises en compte.

  1. Procédure

Suivez ces étapes pour exécuter MongoDB Community Edition sur votre système. Ces instructions supposent que vous utilisez le package mongodb-org officiel (et non le package mongodb non officiel fourni par Ubuntu) et que vous utilisez les paramètres par défaut.

  1. Init System

Pour exécuter et gérer votre processus mongod, vous utiliserez le système init intégré à votre système d'exploitation. Les versions récentes de Linux ont tendance à utiliser systemd (qui utilise la commande systemctl), tandis que les versions plus anciennes de Linux ont tendance à utiliser System V init (qui utilise la commande service).

ps --no-headers -o comm 1

Sélectionnez ensuite l'onglet approprié ci-dessous en fonction du résultat :

  • systemd - select the systemd (systemctl) onglet ci-dessous..
  • init - select the System V Init (service) onglet ci-dessous.

Onglets-selectionnés

System V init​

  1. Start Mongodb

Exécutez la commande suivante pour démarrer mongod :

sudo service mongod start
  1. Vérifiez que MongoDB a démarré avec succès

Vérifiez que le processus mongod a bien démarré :

sudo service mongod status

Vous pouvez également vérifier le fichier journal pour connaître l'état actuel du processus mongod, situé par défaut à l'adresse suivante : /var/log/mongodb/mongod.log. Une instance mongod en cours d'exécution indiquera qu'elle est prête pour les connexions avec la ligne suivante :

  1. Stop MongoDB

Si nécessaire, vous pouvez arrêter le processus mongod en lançant la commande suivante :

sudo service mongod stop
  1. Redémarrez MongoDB.
sudo service mongod restart

systemd (systemctl)​

Exécutez la commande suivante pour démarrer mongod :

sudo systemctl start mongod

Si vous recevez une erreur similaire à la suivante lors du démarrage de mongod : Failed to start mongod.service: Unit mongod.service not found.

Exécutez d’abord la commande suivante :

sudo systemctl daemon-reload

Exécutez ensuite à nouveau la commande de démarrage ci-dessus.

sudo systemctl start mongod
  1. Vérifiez que MongoDB a démarré avec succès

Vérifiez que le processus mongod a bien démarré :

sudo systemctl status mongod

Vous pouvez également vérifier le fichier journal pour connaître l'état actuel du processus mongod, situé par défaut à l'adresse suivante : /var/log/mongodb/mongod.log. Une instance mongod en cours d'exécution indiquera qu'elle est prête pour les connexions avec la ligne suivante :

  1. Stop MongoDB

Si nécessaire, vous pouvez arrêter le processus mongod en lançant la commande suivante :

sudo systemctl stop mongod
  1. Redémarrez MongoDB.
sudo systemctl restart mongod

  1. Commencez à utiliser MongoDB.

Démarrez une session mongosh sur la même machine hôte que mongod. Vous pouvez exécuter mongosh sans aucune option de ligne de commande pour vous connecter à un mongod qui s'exécute sur votre hôte local avec le port par défaut 27017.

mongosh

Pour plus d'informations sur la connexion à l'aide de mongosh, par exemple pour se connecter à une instance mongod exécutée sur un hôte et/ou un port différent, consultez la documentation mongosh mongodb-shell.