Se connecter avec la CLI au service Public Cloud Databases pour MongoDB
Connectez-vous à votre service Public Cloud Databases pour MongoDB en utilisant l'interface en ligne de commande (CLI)
Objectif
Public Cloud Databases vous permet de vous concentrer sur la création et le déploiement de vos applications cloud, pendant qu'OVHcloud prend en charge l'infrastructure de base de données et son maintien en conditions opérationnelles.
Ce guide explique comment se connecter à une instance de base de données MongoDB avec une interface en ligne de commande (CLI).
Prérequis
- Un projet Public Cloud dans votre compte OVHcloud
- Une base de données MongoDB active sur votre service Public Cloud Databases OVHcloud (vous pouvez utiliser ce guide pour remplir ce prérequis)
- Configurer votre instance MongoDB pour accepter les connexions entrantes
Concept
Une instance MongoDB peut être gérée de plusieurs façons. L'une des plus simples, mais aussi des plus puissantes, consiste à utiliser une interface en ligne de commande (CLI), aussi appelée console ou terminal. Pour interagir correctement avec l'instance MongoDB, nous devons d'abord installer un élément appelé client MongoDB, afin de nous connecter et de contrôler le service MongoDB à distance. Il s'agit d'une interaction client-serveur.
En pratique
Installer MongoDB Shell sur votre client
Veuillez noter que MongoDB Shell est également intégré nativement dans le package logiciel communautaire de MongoDB.
Vous devez d'abord installer un logiciel pour interagir avec votre instance MongoDB à distance. Ce logiciel officiel peut être installé sur divers supports comme votre propre ordinateur, un VPS, une machine virtuelle... la seule règle étant de pouvoir accéder au réseau public (Internet) et de disposer des droits suffisants pour l'installer.
Pour cela, et selon votre configuration, vous devrez peut-être suivre la documentation officielle de MongoDB pour installer MongoDB Shell (appelé mongosh).
Suivez les étapes ici après avoir sélectionné le système d'exploitation Windows, MacOS ou Linux : https://docs.mongodb.com/mongodb-shell/install/#std-label-mdb-shell-install
Nous allons maintenant suivre la documentation officielle de MongoDB pour effectuer notre première connexion.
Dans votre CLI, tapez mongosh --version. Le résultat devrait ressembler à ceci :
Cela signifie que mongosh est correctement installé et fonctionne normalement. Si vous n'obtenez pas un résultat similaire, veuillez revenir à l'étape précédente et réinstaller MongoDB Shell.
Se connecter à votre instance MongoDB
Pour établir une connexion, tapez simplement mongosh suivi du Service URI copié précédemment :
N'oubliez pas de modifier le nom d'utilisateur, le mot de passe et le nom d'hôte.
Une fois correctement connecté, vous devriez voir quelque chose de similaire à :
Félicitations ! Vous êtes maintenant pleinement capable d'interagir avec votre instance MongoDB !
Utilisation de MongoDB Shell
Une fois connecté, vous pouvez gérer votre instance MongoDB avec les méthodes intégrées de MongoDB Shell.
Veuillez suivre la documentation officielle de MongoDB.
Pour vérifier :
- db : indiquera sur quelle base de données vous vous trouvez
- use myNewDatabase basculera vers une autre base de données (en créera une si elle n'existe pas)
- db.myCollection.insertOne( ... ) insérera des données dans votre collection
Dans notre exemple, cela ressemblera à ceci :
Aller plus loin
Configurer le vRack pour Public Cloud
Visitez le dépôt d'exemples GitHub pour découvrir comment connecter votre base de données avec plusieurs langages.
Visitez notre chaîne Discord dédiée : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l’équipe qui développe nos services de bases de données.
Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur ce lien pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services.
Rejoignez notre communauté d'utilisateurs.