Dettagli del servizio

• Nome del servizio: il nome può essere una stringa qualsiasi ed è quello utilizzato sul web e nell'interfaccia a riga di comando (CLI) per identificare la nuova distribuzione.
• Gruppo di risorse: se stai organizzando i tuoi servizi in gruppi di risorse, specifica il gruppo di risorse in questo campo. Altrimenti, puoi lasciare le impostazioni predefinite. Per ulteriori informazioni, consultare la sezione " Gestione dei gruppi di risorse ".
• Posizione: la regione cloud dell'implementazione. Su Gen 2, il servizio “ Databases for MongoDB ” è attualmente disponibile solo a Montreal (ca-mon), Chennai - Airtel (in-che), Mumbai (in-mum), Francoforte (eu-de), Washington (us-east), Madrid (eu-es), Sydney (au-syd), Dallas (us-south) e Londra (eu-gb).

Seleziona la piattaforma per la tua implementazione.

• Gen 1: la piattaforma originale di IBM Cloud®, disponibile in tutti i data center di IBM Cloud.
• Gen 2: l'ultima piattaforma di IBM Cloud®, basata su un'architettura di rete definita dal software (SDN) altamente sicura. Gen 2 è ottimizzato per le applicazioni cloud-native ed è attualmente disponibile solo a Montreal, Chennai, Mumbai, Francoforte, Madrid, Sydney, Washington e Londra.

Per ulteriori dettagli, consultare la panoramica su Gen 1(Classic)e Gen 2(VPC).

Modello di hosting

Nella versione Gen 2, l'unico modello di hosting disponibile è "Isolated", un'offerta sicura a tenant singolo pensata per carichi di lavoro aziendali complessi e ad alte prestazioni. Per ulteriori informazioni, consultare la sezione " Isolated Compute ".

Assegnazione delle risorse

Scegli la dimensione iniziale dell'host e la configurazione del disco per la tua implementazione. Le dimensioni dell’host e l’allocazione dello spazio su disco si applicano a ciascun membro dell’istanza.

• Dimensioni del server: scegli tra le configurazioni disponibili di process vCPU e e RAM in base alle esigenze del tuo carico di lavoro.
• Disco: Configura la dimensione iniziale del disco per la tua distribuzione. Utilizza il cursore per impostare la capacità del disco. La dimensione del disco determina l'allocazione degli IOPS. Ogni GB di spazio su disco fornisce 5 IOPS.

La dimensione del disco può essere aumentata dopo il provisioning, ma non può essere ridotta per evitare la perdita di dati.

Configurazione del servizio

• Versione del database: Set only at deployment Questa è la versione della tua installazione di MongoDB. La console evidenzia la versione consigliata per garantire prestazioni ottimali. Per ulteriori informazioni, consultare la Politica di gestione delle versioni.
• Edizione del database: Set only at deployment Su Gen 2 è disponibile solo l'edizione Standard.
• Crittografia: Set only at deployment Se si utilizzaKey Protect, è possibile selezionare un'istanza e una chiave per crittografare il disco della distribuzione. Se non si utilizza una chiave propria, l'implementazione crea e gestisce automaticamente una propria chiave di crittografia del disco.
• Endpoint Set only at deployment[Set only at deployment- Per la Gen 2, sono supportati solo gli endpoint privati.

Dopo aver selezionato le impostazioni appropriate, fare clic su Crea per avviare il processo di provisioning.

Creare un'istanza di servizio tramite la CLI

Prima di procedere al provisioning, seguire le istruzioni riportate nella documentazione per installare lo strumento CLI IBM Cloud.

1. Accedi a IBM Cloud. Se utilizzi un ID utente federato, è importante che tu passi a un codice di accesso monouso (ibmcloud login --sso) oppure che utilizzi una chiave API (ibmcloud --apikey key or @key_file) per l'autenticazione. Per ulteriori informazioni su come effettuare l'accesso tramite CLI, consultare la sezione " Comandi generali della CLI(ibmcloud) " all'indirizzo ibmcloud login.

   ibmcloud login
   

2. È possibile creare istanze di IBM Cloud® Databases for MongoDB con il modello di hosting " Isolated Compute " sulla piattaforma Gen 2.

3. Configurare il database con il seguente comando:

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <RESOURCE_GROUP> -p '{"host_flavor": "<host_flavor value>"}'
   

   Ad esempio, per configurare un'istanza di Databases for MongoDB, utilizzare un comando del tipo:

   ibmcloud resource service-instance-create test-database databases-for-mongodb standard-gen2 us-south -p '{"host_flavor": "bx3d.4x20.encrypted", "storage_gb": 10 }'
   

   Configurare un'istanza isolata di Databases for MongoDB con lo stesso parametro host_flavor -p, impostandolo sulla dimensione desiderata per l'istanza isolata. Le dimensioni disponibili per l'hosting e i relativi parametri di host_flavor value sono elencati nella Tabella 2.

   Poiché la selezione delle configurazioni offerte ai membri include le dimensioni della CPU e della RAM (bx3d.4x20.encrypted prevede 4 CPU e 20 RAM), questa richiesta non consente di scegliere sia una selezione della dimensione "Isolated" sia allocazioni separate per CPU e RAM.

   I campi presenti nel comando sono descritti nella tabella che segue.

   Campi del formato di base dei comandi

   Campo	Descrizione	Indicatore
   INSTANCE_NAME Required	Il nome dell'istanza può essere una stringa qualsiasi ed è il nome utilizzato sul web e nella CLI per identificare la nuova distribuzione.
   SERVICE_NAME Required	Nome o ID del servizio. Per " Databases for MongoDB ", usa " databases-for-mongodb".
   SERVICE_PLAN_NAME Required	standard-gen2
   LOCATION Required	La posizione in cui desideri effettuare l'implementazione. Per recuperare un elenco di regioni, utilizzare il comando ibmcloud regions.
   RESOURCE_GROUP	Il nome del gruppo di risorse. Il valore predefinito è default.	-g
   --parameters	File o stringa JSON dei parametri per creare l'istanza del servizio	-p
   host_flavor	Per configurare un'istanza Isolated Compute, utilizzare {"host_flavor": "<host_flavor value>"}. Per "Isolated Compute", selezionare la configurazione di CPU e RAM desiderata. Per ulteriori informazioni, consultare la Tabella 2 riportata di seguito.

   Verrà visualizzata una risposta del tipo:

   Creating service instance INSTANCE_NAME in resource group default of account USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-mongodb:us-south:a/40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                       Status    create in progress
                       Message   Started create instance operation
   

   • Per verificare lo stato del provisioning, utilizzare il seguente comando:

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   Una volta completata l'operazione, vedrai una risposta simile a questa:

   Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
   OK
   Name:                  INSTANCE_NAME
   ID:                    crn:v1:bluemix:public:databases-for-mongodb:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
   Location:              <LOCATION>
   Service Name:          databases-for-mongodb
   Service Plan Name:     standard-gen2
   Resource Group Name:   default
   State:                 active
   Type:                  service_instance
   Sub Type:              Public
   Locked:                false
   Service Endpoints:     private
   Created at:            2023-06-26T19:42:07Z
   Created by:            USER
   Updated at:            2023-06-26T19:53:25Z
   Last Operation:
                          Status    create succeeded
                          Message   Provisioning mongodb with version 7.17 (100%)
   

   • Facoltativo: per eliminare un'istanza di servizio, eseguire il seguente comando:

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

Il parametro host_flavor

Il parametro " host_flavor " definisce le dimensioni del tuo Compute. Per configurare un'istanza Isolated Compute, inserisci il valore appropriato per la configurazione di CPU e RAM desiderata.

Il parametro --parameters

Il comando service-instance-create supporta il flag -p , che consente di passare parametri in formato JSON al processo di provisioning. Ad esempio, è possibile passare come valori dei parametri i nomi delle risorse cloud (CRN), che identificano in modo univoco una risorsa nel cloud. Tutti i nomi e i valori dei parametri vengono passati come stringhe.

Ad esempio, se si sta creando un database a partire da un determinato backup e la nuova distribuzione del database richiede un host di dimensioni maggiori ( 16x80 ), il comando sarà il seguente:

ibmcloud resource service-instance-create databases-for-mongodb <SERVICE_NAME> standard-gen2 us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-mongodb:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "host_flavor": "bx3d.16x80.encrypted"
}'

Esempio

Per creare un'istanza Isolated Compute, segui questo esempio:

```sh {: pre}
  curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: Bearer <IAM token>" -H 'Content-Type: application/json' -d '{
  "name": "my-instance",
  "target": "ca-mon",
  "resource_group": "5c49eabc-f5e8-5881-a37e-2d100a33b3df",
  "resource_plan_id": databases-for-mongodb-gen2-standard",
  "dataservices": {
    "mongodb": {
        "storage_gb": 10,
        "host_flavor": "bx3d.4x20.encrypted"
      },
    "encryption": {
      "disk": "crn:v1..."
    },
    "version": "8",
  },
}'
```
Configurare un'istanza isolata di Databases for MongoDB con lo stesso parametro `host_flavor`, impostandolo sulla dimensione desiderata per l'istanza isolata. Le dimensioni disponibili per l'hosting e i relativi parametri di `host_flavor value` sono elencati nella [Tabella 2](#members_host-flavor-parameter-api). Ad esempio, `{"host_flavor": "bx3d.4x20.encrypted"}`.

Poiché la selezione delle configurazioni offerte ai membri include le dimensioni della CPU e della RAM (bx3d.4x20.encrypted prevede 4 CPU e 20 RAM), questa richiesta non consente di scegliere sia una selezione della dimensione "Isolated" sia allocazioni separate per CPU e RAM.

I campi presenti nel comando sono descritti nella tabella che segue.

Il parametro host_flavor

Il parametro " host_flavor " definisce le dimensioni del tuo Compute. Per configurare un'istanza Isolated Compute, inserisci il valore appropriato per la configurazione di CPU e RAM desiderata.

Elenco dei parametri aggiuntivi

Nell'oggetto --parameters è possibile specificare ulteriori informazioni per creare l'istanza del servizio, tra cui:

• backup_id- Il CRN di una risorsa di backup da cui eseguire il ripristino. Il backup deve essere creato tramite una distribuzione del database con lo stesso ID servizio. Il backup viene caricato dopo il provisioning e viene avviata la nuova distribuzione che utilizza tali dati. Un CRN di backup ha il formato crn:v1:<...>:backup:<uuid>. Se omesso, il database viene creato vuoto.
• version- La versione del database da configurare. Se omesso, il database viene creato con la versione principale e secondaria più recenti.
• disk_encryption_key_crn- Il CRN di una chiave KMS ( Key Protect ), che viene poi utilizzata per la crittografia del disco. Il CRN di una chiave KMS ha il formato crn:v1:<...>:key:<id>.
• backup_encryption_key_crn- Il CRN di una chiave KMS ( Key Protect ), che viene poi utilizzato per la crittografia del backup. Il CRN di una chiave KMS ha il formato crn:v1:<...>:key:<id>.

Per utilizzare una chiave per i backup, è necessario innanzitutto [abilitare la delega da servizio a servizio](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok).
{: note}

Configurazione di risorse di calcolo isolate con Terraform

Configurare un'istanza isolata di Databases for MongoDB con lo stesso parametro "host_flavor", impostandolo sulla dimensione desiderata per l'istanza isolata. Le dimensioni disponibili per l'hosting e i relativi parametri di host_flavor value sono elencati nella Tabella 1. Ad esempio, {"host_flavor": "bx3d.4x20.encrypted"}. Si noti che, poiché la selezione della configurazione dell'host include le dimensioni della CPU e della RAM (bx3d.4x20.encrypted corrisponde a 4 CPU e 16 RAM), questa richiesta non accetta sia la selezione della dimensione "Isolated" sia le selezioni separate relative all'allocazione di CPU e RAM.

data "ibm_resource_group" "group" {
  name = "<your_group>"
}
resource "ibm_database" "<your_database>" {
  name              = "<your_database_name>"
  plan              = "standard"
  location          = "eu-gb"
  service           = "databases-for-mongodb"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword                = "password12"
  group {
    group_id = "member"
    host_flavor {
      id = "bx3d.4x20.encrypted"
    }
    disk {
      allocation_mb = 256000
    }
  }
  users {
    name     = "user123"
    password = "password12"
  }
  allowlist {
    address     = "172.168.1.1/32"
    description = "desc"
  }
}
output "ICD MongoDB database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

Il parametro host flavor

Il parametro " host_flavor " definisce le dimensioni del tuo Compute. Per configurare un'istanza Isolated Compute, inserisci il valore appropriato per la configurazione di CPU e RAM desiderata. Si vedano i valori riportati nella tabella seguente.