IBM Cloud Docs
Initiation à Databases for MongoDB

Initiation à Databases for MongoDB

Ce tutoriel vous guide à travers les étapes pour commencer à utiliser rapidement Databases for MongoDB en provisionnant une instance, en définissant votre mot de passe administrateur, en vous connectant et en écrivant et lisant un document simple.

Suivez les étapes suivantes pour terminer le tutoriel :

Suivez les étapes suivantes pour terminer le tutoriel :

Suivez les étapes suivantes pour terminer le tutoriel :

Suivez les étapes suivantes pour terminer le tutoriel :

Avant de commencer

Etape 1: Choisissez votre plan

Databases for MongoDB propose deux plans différents :

Utilisation des API

Utilisez l'APICloud Databases pour utiliser votre instance Databases for MongoDB. L'API du contrôleur de ressources est utilisée pour mettre à disposition une instance.

Vous aurez besoin d'une clé API pour effectuer des actions via l'API. Suivez ces étapes pour créer une IBM Cloud qui vous permet d'utiliser l'API pour provisionner l'infrastructure dans votre compte. Vous pouvez créer jusqu'à 20 clés d'API.

Pour des raisons de sécurité, la clé d'API ne peut être copiée ou téléchargée qu'au moment de sa création. Si la clé d'API est perdue, vous devez en créer une autre.

Etape 2: Mise à disposition via la console

  1. Connectez-vous à la console Web IBM Cloud.

  2. Cliquez sur le service Databases for MongoDB dans le catalogue.

  3. Suivez les étapes suivantes pour provisionner une instance Databases for MongoDB.

  4. Lorsque votre instance est provisionnée, cliquez sur le nom de l'instance pour afficher plus d'informations.

Etape 2: Mise à disposition via l'interface de ligne de commande

Vous pouvez mettre à disposition une instance Databases for MongoDB à l'aide de l'interface de ligne de commande. Si vous ne l'avez pas déjà, vous devez installer l'interface de ligne de commande IBM Cloud.

Vous pouvez suivre les étapes suivantes pour provisionner une instance Databases for MongoDB.

Etape 2: Mise à disposition via l'API du contrôleur de ressources

Suivez les étapes suivantes pour provisionner une instance Databases for MongoDB à l'aide de l'API du contrôleur de ressources.

Etape 2: Mise à disposition via Terraform

Vous avez besoin d'une clé API pour effectuer des actions via Terraform. Suivez ces étapes pour créer une IBM Cloud qui permet à Terraform de provisionner l'infrastructure dans votre compte. Vous pouvez créer jusqu'à 20 clés d'API.

Pour des raisons de sécurité, la clé d'API ne peut être copiée ou téléchargée qu'au moment de sa création. Si la clé d'API est perdue, vous devez en créer une autre.

Une fois que vous avez une clé API, suivez les étapes suivantes pour provisionner une instance Databases for MongoDB à l'aide de Terraform.

Étape 3 : Définir le mot de passe administrateur

Administrateur

Lorsque vous provisionnez un déploiement Databases for MongoDB, un utilisateur admin est automatiquement créé.

Définissez le mot de passe de l'administrateur avant de l'utiliser pour la connexion.

Définir le mot de passe de l'administrateur via l'interface utilisateur

Définissez votre mot de passe administrateur via l'interface utilisateur en sélectionnant votre instance dans la IBM Cloud Liste des ressources. Sélectionnez ensuite Paramètres. Sélectionnez ensuite Modifier le mot de passe de l'administrateur de base de données.

Définir le mot de passe de l'administrateur par l'intermédiaire de l'interface de ligne de commande

Utilisez la commande cdb user-password à partir du plug-in IBM Cloud de l'interface de ligne de commande Cloud Databases pour définir le mot de passe de l'administrateur.

Par exemple, pour définir le mot de passe administrateur de votre déploiement, utilisez la commande suivante :

ibmcloud cdb user-password <INSTANCE_NAME_OR_CRN> admin <NEWPASSWORD>

Définir le mot de passe de l'administrateur via l'API

Vous pouvez utiliser le paramètre id obtenu dans la réponse à l'étape 2 ci-dessus avec le point de terminaison Set specified user's password pour définir le mot de passe de l'administrateur.

curl -X PATCH -H "Authorization: Bearer <TOKEN>" \
     -H 'Content-Type: application/json' \
     -d '{"password":"newrootpasswordsupersecure21"}' \
      "https://api.<REGION>.databases.cloud.ibm.com/v5/ibm/deployments/<DEPLOYMENT_ID>/users/database/admin"

Le paramètre id doit être codé en URL pour que l'appel API ci-dessus fonctionne.

Définir le mot de passe de l'administrateur via Terraform

Le mot de passe administrateur est transmis comme l'un des paramètres de la ressource de la base de données dans le script Terraform. Il n'est pas nécessaire de prendre d'autres mesures.

Étape 4 : Connectez-vous à votre instance Databases for MongoDB

Vous pouvez facilement vous connecter à votre instance en utilisant soit Mongo Shell (une interface de ligne de commande), soit Mongo Compass, une interface graphique puissante pour l'interrogation et l'analyse de vos données. Ces deux outils sont fournis par MongoDB.

Utilisation du shell Mongo

Suivez ces instructions pour télécharger et vous connecter à Mongo Shell.

Vous pouvez ensuite tester votre déploiement en insérant un document dans une collection :

use sample_mflix

db.movies.insertOne(
  {
    title: "The Favourite",
    genres: [ "Drama", "History" ],
    runtime: 121,
    rated: "R",
    year: 2018,
    directors: [ "Yorgos Lanthimos" ],
    cast: [ "Olivia Colman", "Emma Stone", "Rachel Weisz" ],
    type: "movie"
  }
)

La commande ci-dessus bascule vers une base de données appelée sample_mflix (et la crée si elle n'existe pas encore), puis insère un document dans la collection movies (qui est également créée si elle n'existe pas encore).

Vous pouvez ensuite récupérer le document avec :

db.movies.find( { title: "The Favourite" } )

Vous êtes maintenant connecté à votre base de données et vous pouvez écrire et lire des données en utilisant le Mongo Shell.

Utilisation de MongoDB Compass

Suivez ces instructions pour télécharger MongoDB Compass et l'utiliser pour vous connecter à votre Databases for MongoDB instance. Vous pouvez écrire et lire des données en utilisant la MongoDB documentation Compass.

Etapes suivantes