Partager via

Démarrage rapide : Créer un cluster Azure DocumentDB à l’aide du portail Azure

Dans ce guide de démarrage rapide, vous allez créer un cluster Azure DocumentDB. Ce cluster contient toutes vos ressources MongoDB classiques : bases de données, collections et documents. Le cluster fournit un point de terminaison unique pour différents outils et pilotes pour se connecter à Azure DocumentDB et effectuer des opérations quotidiennes.

Prerequisites

  • Un abonnement Azure

Créer un cluster

Pour commencer, vous devez d’abord créer un cluster Azure DocumentDB, qui sert de base pour le stockage et la gestion de vos données NoSQL.

  1. Connectez-vous au portail Azure (https://portal.azure.com).

  2. Dans le menu du portail Azure ou dans la page d’accueil, sélectionnez Créer une ressource.

  3. Dans la nouvelle page, recherchez et sélectionnez Azure DocumentDB.

    Capture d’écran montrant la recherche d’Azure DocumentDB.

  4. Dans la page Créer un cluster Azure DocumentDB et dans la section Informations de base , sélectionnez l’option Configurer dans la section Niveau cluster .

    Capture d’écran montrant l’option Configurer le cluster.

  5. Dans la page Mise à l’échelle , configurez ces options, puis sélectionnez Enregistrer pour conserver vos modifications au niveau du cluster.

    Valeur
    Niveau de cluster M30 tier, 2 vCore, 8-GiB RAM
    Stockage par partition 128 GiB

    Capture d’écran des options de configuration pour le calcul et le stockage d’un nouveau cluster Azure DocumentDB.

  6. De retour dans la section Informations de base , configurez les options suivantes :

    Valeur
    Subscription Sélectionnez votre abonnement Azure.
    Groupe de ressources Créer un groupe de ressources ou en sélectionner un
    Nom du cluster Fournir un nom globalement unique
    Lieu Sélectionnez une région Azure prise en charge pour votre abonnement
    Version de MongoDB Sélectionnez 8.0
    Nom d’utilisateur de l’administrateur Créer un nom d’utilisateur pour accéder au cluster en tant qu’administrateur utilisateur
    Mot de passe Utiliser un mot de passe unique associé au nom d’utilisateur

    Capture d’écran montrant les paramètres du cluster.

    Conseil / Astuce

    Enregistrez les valeurs que vous utilisez pour le nom d’utilisateur et le mot de passe. Ces valeurs sont utilisées plus loin dans ce guide. Pour plus d’informations sur les valeurs valides, consultez limitations du cluster.

  7. Sélectionnez Suivant : Mise en réseau.

  8. Dans la section Règles de pare-feu de l’onglet Mise en réseau , configurez ces options :

    Valeur
    Méthode de connectivité Public access
    Autoriser l’accès public à partir de services et de ressources Azure au sein d’Azure à ce cluster Activé

  9. Ajoutez une règle de pare-feu pour votre appareil client actuel pour accorder l’accès au cluster en sélectionnant + Ajouter une adresse IP cliente actuelle.

    Capture d’écran montrant les configurations réseau.

    Conseil / Astuce

    Dans de nombreux environnements d’entreprise, les adresses IP de l’ordinateur du développeur sont masquées en raison d’un VPN ou d’autres paramètres réseau d’entreprise. Dans ces cas, vous pouvez autoriser temporairement l’accès à toutes les adresses IP en ajoutant la 0.0.0.0 - 255.255.255.255 plage d’adresses IP en tant que règle de pare-feu. Utilisez cette règle de pare-feu uniquement temporairement dans le cadre du test et du développement de connexions.

  10. Sélectionnez Vérifier + créer.

  11. Passez en revue les paramètres que vous fournissez, puis sélectionnez Créer. La création du cluster ne prend que quelques minutes. Attendez que le déploiement des ressources soit terminé.

  12. Enfin, sélectionnez Accéder à la ressource pour accéder au cluster Azure DocumentDB dans le portail.

Capture d’écran montrant les options de ressource goto.

Obtenir les informations d’identification du cluster

Obtenez les informations d’identification que vous utilisez pour vous connecter au cluster.

  1. Dans la page du cluster, sélectionnez l’option Chaînes de connexion dans le menu de ressources.

  2. Dans la section Chaînes de connexion, copiez ou enregistrez la valeur à partir du champ Chaîne de connexion .

Capture d’écran montrant l’option chaînes de connexion.

Important

La chaîne de connexion dans le portail n’inclut pas la valeur du mot de passe. Vous devez remplacer l’espace <password> réservé par les informations d’identification que vous avez entrées lors de la création du cluster ou entrer le mot de passe de manière interactive.

Se connecter à l’aide de MongoDB Shell à partir du démarrage rapide

Pour vous connecter directement à Azure DocumentDB à l’aide de MongoDB Shell, utilisez l’expérience de démarrage rapide disponible sur la page de la ressource dans le portail Azure.

  1. Dans la page de ressources du cluster, sélectionnez Démarrage rapide (préversion) dans le menu de navigation.

  2. Ensuite, sélectionnez Ouvrir l’interpréteur de commandes MongoDB.

  3. Attendez que l’environnement MongoDB Shell démarre.

  4. Une fois l’environnement prêt, entrez Y pour accepter la notification.

    Note

    Si vous rencontrez un problème de connexion à l’aide de MongoDB Shell après avoir accepté l’avis, vérifiez qu’Azure Cloud Shell a accès à votre cluster.

  5. Entrez maintenant votre mot de passe pour connecter votre cluster à Cloud Shell.

Effectuer des requêtes de test

Vérifiez que vous êtes correctement connecté à votre cluster en effectuant une série de commandes de test et de requêtes.

  1. Vérifiez l’état de votre connexion en exécutant la connectionStatus commande.

    db.runCommand({connectionStatus: 1})

    {
  ...
  ok: 1
}

  2. Répertoriez les bases de données de votre cluster.

    show dbs

  3. Basculez vers une base de données spécifique. Remplacez l’espace <database-name> réservé par le nom de n’importe quelle base de données de votre cluster.

    use <database-name>

    Conseil / Astuce

    Par exemple, si le nom de la base de données est inventory, la commande serait use inventory.

  4. Répertorier les collections dans la base de données.

    show collections

  5. Recherchez les cinq premiers éléments d’une collection spécifique. Remplacez l’espace <collection-name> réservé par le nom d’une collection dans votre cluster.

    db.<collection-name>.find().limit(5)

    Conseil / Astuce

    Par exemple, si le nom de la collection est equipment, la commande serait db.equipment.find().limit(5).

Nettoyer les ressources

Lorsque vous avez terminé avec le cluster Azure DocumentDB, vous pouvez supprimer les ressources Azure que vous avez créées afin de ne pas entraîner de frais supplémentaires.

  1. Depuis la barre de recherche du portail Azure, recherchez et sélectionnez Groupes de ressources.

    Capture d’écran montrant l’option permettant de rechercher des groupes de ressources.

  2. Dans la liste, sélectionnez le groupe de ressources utilisé dans ce démarrage rapide.

    Capture d’écran montrant le groupe de ressources.

  3. Sur la page Groupe de ressources, sélectionnez Supprimer un groupe de ressources.

  4. Dans la boîte de dialogue de confirmation de la suppression, entrez le nom du groupe de ressources pour confirmer votre intention de le supprimer. Enfin, sélectionnez Supprimer pour supprimer définitivement le groupe de ressources.

    Capture d’écran montrant le bouton de confirmation de suppression du groupe de ressources.

Contenu connexe

  • Last updated on