Installation et configuration de MongoDB sur une machine virtuelle Windows dans Azure

MongoDB est une base de données NoSQL open-source qui offre des performances élevées. Cet article vous guide lors de l’installation et de la configuration de MongoDB sur une machine virtuelle Windows Server 2016 (VM) dans Azure. Vous pouvez également installer MongoDB sur une machine virtuelle Linux dans Azure.

Prérequis

Avant d’installer et configurer MongoDB, vous devez créer une machine virtuelle et, dans l’idéal, ajouter un disque de données à celle-ci. Consultez les articles suivants pour créer une machine Virtuelle et ajouter un disque de données :

• Création d’une machine virtuelle Windows Server à l’aide du portail Azure ou d’Azure PowerShell.
• Association d’un disque de données à une machine virtuelle Windows Server à l’aide du portail Azure ou d’Azure PowerShell.

Pour commencer à installer et à configurer MongoDB, connectez-vous à votre machine virtuelle Windows Server à l’aide du Bureau à distance.

Installation de MongoDB

1. Une fois que vous êtes connecté à la machine virtuelle à l’aide du Bureau à distance, ouvrez Internet Explorer à partir de la barre des tâches.

2. Sélectionnez Utiliser les paramètres de sécurité, de confidentialité et de compatibilité recommandés lorsque s’ouvre pour la première fois, puis cliquez sur OK.

3. La configuration de la sécurité renforcée d’Internet Explorer est activée par défaut. Ajoutez le site Web MongoDB à la liste des sites autorisés :

   • Sélectionnez l’icône Outils dans le coin supérieur droit.

   • Dans Options Internet, sélectionnez l’onglet Sécurité, puis l’icône Sites de confiance.

   • Cliquez sur le bouton Sites. Ajoutez https://*.mongodb.com à la liste des sites approuvés, puis fermez la boîte de dialogue.

     

4. Accédez à la page MongoDB - Téléchargements (https://www.mongodb.com/downloads).

5. Si nécessaire, sélectionnez l’édition Community Server et la dernière version stable mise à jour pour Windows Server 2008 R2 64 bits et versions ultérieures. Pour télécharger le programme d’installation, cliquez sur TÉLÉCHARGER (msi) .

   

   Exécutez le programme d’installation une fois le téléchargement terminé.

6. Lisez et acceptez le contrat de licence. Lorsqu’une invite s’affiche, sélectionnez Terminer le programme d’installation.

7. Si vous le souhaitez, vous pouvez choisir d’installer également Compass, une interface graphique dédiée à MongoDB.

8. Sur le dernier écran, cliquez sur Installer.

Configuration de la machine virtuelle et de MongoDB

1. Les variables de chemin d’accès ne sont pas mises à jour par le programme d’installation de MongoDB. Sans l’emplacement bin de MongoDB dans votre variable PATH, vous devez spécifier le chemin d’accès complet à chaque fois que vous utilisez un fichier exécutable MongoDB. Pour ajouter l’emplacement à votre variable PATH :

   • Avec le bouton droit, cliquez sur le menu Démarrer et sélectionnez Système.

   • Cliquez sur Paramètres système avancés, puis cliquez sur Variables d’environnement.

   • Sous Variables système, sélectionnez Chemin d’accès, puis cliquez sur Modifier.

     

     Ajoutez le chemin d’accès vers le dossier bin de MongoDB. MongoDB est généralement installé sur C:\Program Files\MongoDB. Vérifiez le chemin d’installation sur votre machine virtuelle. L’exemple suivant ajoute la valeur par défaut d’emplacement d’installation de MongoDB la variable PATH :

     ;C:\Program Files\MongoDB\Server\3.6\bin
     

     Notes

     Veillez à ajouter le point-virgule en premier (;) pour indiquer que vous ajoutez un emplacement pour votre variable PATH.

2. Créez les répertoires de journaux et de données MongoDB sur votre disque dur. Dans le menu Démarrer, sélectionnez Invite de commande. L’exemple suivant crée les répertoires sur le lecteur F:

   mkdir F:\MongoData
   mkdir F:\MongoLogs
   

3. Démarrez une instance MongoDB avec la commande suivante, en adaptant le chemin d’accès à vos données et journaux :

   mongod --dbpath F:\MongoData\ --logpath F:\MongoLogs\mongolog.log
   

   Il se peut que plusieurs minutes soient nécessaires pour que MongaDB alloue les fichiers journaux et commence à écouter les connexions. Tous les messages du journal sont dirigés vers le fichier F:\MongoLogs\mongolog.log lorsque le serveur mongod.exe démarre et alloue les fichiers journaux.

   Notes

   L’invite de commandes reste axée sur cette tâche pendant que votre instance MongoDB est en cours d’exécution. Laissez la fenêtre d’invite de commandes ouverte pour poursuivre l’exécution de MongoDB. Vous pouvez aussi installer MongoDB en tant que service, comme indiqué dans l’étape suivante.

4. Pour une expérience plus robuste avec MongoDB, installez mongod.exe en tant que service. La création d’un service signifie que vous n’avez pas besoin de laisser une invite de commande s’exécuter chaque fois que vous souhaitez utiliser MongoDB. Créez le service en procédant comme suit, en adaptant le chemin d’accès à vos répertoires de données et de journaux :

   mongod --dbpath F:\MongoData\ --logpath F:\MongoLogs\mongolog.log --logappend  --install
   

   La commande précédente crée un service nommé « MongoDB » avec « Mongo DB » comme description. Les paramètres suivants sont également spécifiés :

   • L’option --dbpath spécifie l’emplacement du répertoire de données.
   • L’option --logpath permet de spécifier un fichier journal puisque le service en cours d’exécution n’a pas de fenêtre de commande pour afficher la sortie.
   • L’option --logappend spécifie qu’au redémarrage du service, la sortie est ajoutée au fichier journal existant.

   Pour démarrer le service MongoDB, exécutez la commande suivante :

   net start MongoDB
   

   Pour plus d’informations sur la création du service MongoDB, consultez Configuration d’un service Windows pour MongoDB.

Testez l’instance de MongoDB

Avec MongoDB lancé en tant qu’instance unique ou installé en tant que service, vous pouvez maintenant commencer la création et l’utilisation de vos bases de données. Pour lancer l’interpréteur de commandes d’administration de MongoDB, ouvrez une autre fenêtre d’invite de commande à partir du menu Démarrer et entrez la commande suivante :

mongo

Vous pouvez répertorier les bases de données avec la commande db. Insérez des données comme suit :

db.foo.insert( { a : 1 } )

Recherchez des données comme suit :

db.foo.find()

Le résultat ressemble à l’exemple suivant :

{ "_id" : "ObjectId("57f6a86cee873a6232d74842"), "a" : 1 }

Quittez la console mongo comme suit :

exit

Configuration des règles de pare-feu et de groupe de sécurité réseau

Maintenant que MongoDB est installé et en cours d’exécution, ouvrez un port dans le Pare-feu Windows pour vous connecter à distance à MongoDB. Pour créer une nouvelle règle de trafic entrant pour autoriser le port TCP 27017, ouvrez une invite PowerShell administrative et saisissez la commande suivante :

New-NetFirewallRule `
    -DisplayName "Allow MongoDB" `
    -Direction Inbound `
    -Protocol TCP `
    -LocalPort 27017 `
    -Action Allow

Vous pouvez également créer la règle à l’aide de l’outil de gestion graphique Pare-feu Windows avec fonctions de sécurité avancées. Créez une nouvelle règle de trafic entrant pour autoriser le port TCP 27017.

Si nécessaire, créez une règle de groupe de sécurité réseau pour autoriser l’accès à MongoDB en dehors du sous-réseau du réseau virtuel Azure existant. Vous pouvez créer les règles du groupe de sécurité réseau à l’aide du portail Azure ou d’Azure PowerShell. Comme avec les règles de pare-feu Windows, autorisez le port TCP 27017 pour l’interface réseau virtuelle de votre machine virtuelle MongoDB.

Étapes suivantes

Dans ce didacticiel, vous avez appris à installer et à configurer MongoDB sur votre machine virtuelle Windows. Vous pouvez maintenant accéder à MongoDB sur votre machine virtuelle Windows en suivant les rubriques avancées dans la Documentation MongoDB.