Introduzione a Databases for MongoDB

Questo tutorial vi guida attraverso i passi per iniziare rapidamente a usare Databases for MongoDB facendo il provisioning di un'istanza, impostando la password di amministrazione, collegandosi ad essa e scrivendo e leggendo un semplice documento.

Seguire questi passi per completare l'esercitazione:

Seguire questi passi per completare l'esercitazione:

Seguire questi passi per completare l'esercitazione:

Seguire questi passi per completare l'esercitazione:

Prima di iniziare

Passo 1: Scegli il tuo piano

Databases for MongoDB offre due piani diversi:

  • Databases for MongoDB Standard è un servizio di database NoSQL completamente gestito basato su MongoDB Community Edition.

  • Databases for MongoDB Enterprise offre funzioni avanzate, come il MongoDB Ops Manager e il ripristino point-in-time.

Utilizzo di API

Utilizza l'API Cloud Databases per gestire la tua istanza Databases for MongoDB. L'API del controller della risorsa viene utilizzato per eseguire il provisioning di un'istanza.

Per eseguire azioni tramite l'API è necessaria una chiave API. Seguire questi passaggi per creare una chiave API IBM Cloud che consente di utilizzare l'API per il provisioning dell'infrastruttura nel proprio account. Puoi creare fino a 20 chiavi API.

Per motivi di sicurezza, la chiave API è disponibile per essere copiata o scaricata solo durante la fase di creazione. Se la chiave API viene persa, dovrai crearne una nuova.

Passo 2: Esegui il provisioning tramite console

  1. Accedi alla console IBM Cloud.
  2. Fate clic sul Databases for MongoDB servizio nel catalogo.
  3. Seguire questi passi per eseguire il provisioning di un'istanza Databases for MongoDB.
  4. Una volta effettuato il provisioning dell'istanza, fai clic sul nome dell'istanza per visualizzare ulteriori informazioni.

Passo 2: Esegui il provisioning tramite la CLI

Puoi eseguire il provisioning di un'istanza Databases for MongoDB utilizzando la CLI. Se non lo hai già, devi installare la CLIIBM Cloud.

È possibile seguire questi passaggi per eseguire il provisioning di un'istanza Databases for MongoDB.

Passo 2: Esegui il provisioning tramite l'API del controller delle risorse

Seguire questi passaggi per eseguire il provisioning di un'istanza Databases for MongoDB usando l'API del controllore delle risorse.

Passo 2: Esegui il provisioning tramite Terraform

Per eseguire azioni tramite Terraform è necessaria una chiave API. Seguire questi passaggi per creare una chiave API IBM Cloud che consenta a Terraform di eseguire il provisioning dell'infrastruttura nel vostro account. Puoi creare fino a 20 chiavi API.

Per motivi di sicurezza, la chiave API è disponibile per essere copiata o scaricata solo durante la fase di creazione. Se la chiave API viene persa, dovrai crearne una nuova.

Una volta ottenuta la chiave API, seguire questi passi per effettuare il provisioning di un'istanza Databases for MongoDB usando Terraform.

Passo 3: Impostare la password di amministrazione

L'utente admin

Quando si effettua il provisioning di un'installazione Databases for MongoDB, viene creato automaticamente un utente admin.

Impostare la password amministratore prima di utilizzarla per la connessione.

Impostare la password di amministrazione tramite l'interfaccia utente

Impostare la password di amministrazione attraverso l'interfaccia utente, selezionando l'istanza dall'elenco IBM Cloud delle risorse. Quindi, selezionare Impostazioni. Successivamente, selezionare Modifica password amministratore database.

Impostare la password di amministrazione tramite la CLI

Utilizza il comando cdb user-password dal plug-in IBM Cloud CLI Cloud Databases per impostare la password dell'amministratore.

Ad esempio, per impostare la password di amministrazione per l'installazione, usare il seguente comando:

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

Impostare la password di amministrazione tramite l'API

Si può usare il parametro id ottenuto nella risposta al passo 2 con l'endpoint Imposta la password dell'utente specificato per impostare la password dell'amministratore.

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"

Il parametro id deve essere codificato URL affinché la chiamata API di cui sopra funzioni.

Impostazione della password di amministrazione tramite Terraform

La password di amministrazione viene passata come uno dei parametri delle risorse del database nello script di Terraform. Non è necessario intraprendere ulteriori azioni.

Passo 4: Connettersi all'istanza Databases for MongoDB

È possibile connettersi facilmente alla propria istanza utilizzando Mongo Shell (un'interfaccia a riga di comando) o Mongo Compass, una potente interfaccia grafica per interrogare e analizzare i dati. Entrambi questi strumenti sono forniti da MongoDB.

Usare la shell di Mongo

Seguite queste istruzioni per scaricare e connettervi a Mongo Shell.

È quindi possibile testare la distribuzione inserendo un documento in una raccolta:

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"
  }
)

Il comando precedente passa a un database chiamato sample_mflix (e lo crea se non esiste già), quindi inserisce un documento nella raccolta movies (che viene anch'essa creata se non esiste già).

È quindi possibile recuperare il documento con:

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

A questo punto ci si è collegati al database e si sono scritti e letti i dati usando la Mongo Shell.

Utilizzo di MongoDB Compass

Seguire queste istruzioni per scaricare MongoDB Compass e usarlo per connettersi alla propria istanza Databases for MongoDB. È possibile scrivere e leggere i dati utilizzando la documentazione di Compass MongoDB.

Passi successivi