Dettagli del servizio

• Nome servizio: il nome può essere qualsiasi stringa ed è il nome utilizzato sul Web e nella 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, è possibile lasciare il valore predefinito. Per ulteriori informazioni, vedere Gestione dei gruppi di risorse.
• Posizione: la regione del cloud pubblico della distribuzione.

Modello di hosting

• Isolato: offerta a singolo tenant sicura per carichi di lavoro aziendali complessi e ad alte prestazioni.
• Condiviso: Offerta flessibile multi-tenant per selezioni di capacità dinamiche, mirate e disaccoppiate.

Databases for MongoDB Le funzioni Enterprise sono disponibili solo su Isolated Compute.

Per ulteriori informazioni, consulta i piani Modelli di hosting e Databases for MongoDB.

Assegnazione delle risorse

Ottimizzare l'assegnazione delle risorse. Le opzioni disponibili differiscono in base al modello di host selezionato.

• Isolato: utilizzare la tabella per scegliere la dimensione della macchina per ciascun membro della distribuzione e specificare la dimensione del disco.
• Condiviso: per impostazione predefinita, viene selezionata l'allocazione di risorse più piccola possibile. Questo è l'ideale per piccole applicazioni o test. Per allocazioni più grandi, seleziona il riquadro Personalizzato, che consente la configurazione di risorse flessibili con 2 + core.

Il modello di hosting di calcolo condiviso supporta allocazioni di risorse più dettagliate che non vengono visualizzate nell'interfaccia utente per mantenere la chiarezza. Per ulteriori informazioni, vedere Modelli ospitanti.

Specificare la dimensione del disco in base ai requisiti. Può essere aumentato dopo il provisioning, ma non può essere diminuito per evitare la perdita di dati.

Configurazione del servizio

• Versione del database: Imposta solo al momento della distribuzione Questa è la versione di distribuzione del database. Si consiglia di eseguire la versione preferita per garantire prestazioni ottimali. Per ulteriori informazioni, vedere Politica di versione.
• Edizione del database: Impostato solo al momento della distribuzione Selezionare uno dei piani di sharding Standard, Enterprise o Enterprise. Si noti che i piani Enterprise e Enterprise Sharding non sono disponibili con l'hosting condiviso. Per ulteriori informazioni, vedere Piani.
• Codifica: Imposta solo durante la distribuzione Se si utilizzaKey Protect, è possibile selezionare un'istanza e una chiave per codificare il disco della distribuzione. Se non si utilizza la propria chiave, la distribuzione crea e gestisce automaticamente la propria chiave di codifica del disco.
• Endpoint: Impostato solo al momento della distribuzione Configura ilEndpoint del servizio sulla tua distribuzione. L'impostazione predefinita è privata.

Una distribuzione Databases for MongoDB non può avere contemporaneamente endpoint pubblici e privati.

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

Crea un'istanza del servizio tramite la CLI

Prima del provisioning, segui le istruzioni fornite nella documentazione per installare lo strumento CLI IBM Cloud.

1. Accedi a IBM Cloud. Se si utilizza un ID utente federato, è importante passare a un codice di accesso unico (ibmcloud login --sso) o utilizzare una chiave API (ibmcloud --apikey key or @key_file) per l'autenticazione. Per ulteriori informazioni su come effettuare il login utilizzando la CLI, vedere Comandi generali della CLI(ibmcloud) in ibmcloud login.

   ibmcloud login
   

2. Seleziona il modello host su cui vuoi che venga eseguito il provisioning del tuo database. Puoi modificarlo in un secondo momento.

3. Effettua il provisioning del database con il seguente comando:

   ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"
   

Ad esempio, per eseguire il provisioning di un'istanza del modello di hosting Databases for MongoDB Shared Compute, utilizzare un comando come:

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

Predisporre un'istanza Databases for MongoDB isolata con lo stesso parametro "members_host_flavor" -p, impostandolo alla dimensione isolata desiderata. Dimensioni di hosting disponibili e loro members_host_flavor value i parametri sono elencati in Tavolo 2. Per esempio,{"members_host_flavor": "b3c.4x16.encrypted"}. Si noti che, poiché la selezione del sapore dell'host include le dimensioni della CPU e della RAM (b3c.4x16.encrypted è 4 CPU e 16 RAM), questa richiesta non accetta sia una selezione di dimensioni isolate, sia selezioni separate di allocazione di CPU e RAM.

ibmcloud resource service-instance-create test-database databases-for-mongodb enterprise us-south -p '{"members_host_flavor": "b3c.4x16.encrypted"}' --service-endpoints="private"

I campi del comando sono descritti nella tabella seguente.

Nella CLI service-endpoints è un indicatore, non un parametro.

Il parametro members host flavor

Il parametro members_host_flavor definisce il dimensionamento del calcolo.

• Per eseguire il provisioning di un'istanza di Shared Compute, specificare multitenant. Per eseguire il provisioning di un'istanza di calcolo isolata, inserisci il valore appropriato per la configurazione desiderata di CPU e RAM.

  Parametro di dimensionamento del sapore dell'ospite dei membri

  Sapore dell'host dei membri	valore di Members_host_flavor
  Shared compute	multitenant
  4 CPU x 16 RAM	b3c.4x16.encrypted
  8 CPU x 32 RAM	b3c.8x32.encrypted
  8 CPU x 64 RAM	m3c.8x64.encrypted
  16 CPU x 64 RAM	b3c.16x64.encrypted
  32 CPU x 128 RAM	b3c.32x128.encrypted
  30 CPU x 240 RAM	m3c.30x240.encrypted

  Vedrai 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 controllare lo stato di provisioning, utilizzare il seguente comando:

  ibmcloud resource service-instance <INSTANCE_NAME>
  

  Al termine, verrà visualizzata una risposta come:

  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
  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%)
  

• Opzionale: Per eliminare un'istanza di servizio, eseguire il seguente comando:

  ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
  

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.

Il parametro --parameters

Il comando service-instance-create supporta un flag -p, che consente di passare al processo di provisioning parametri in formato JSON. Ad esempio, puoi passare i CRN (Cloud Resource Name) come valori di parametro, 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 eseguendo il provisioning di un database da un particolare backup e la nuova distribuzione del database necessita di un totale di 12 GB di memoria su tre membri, il comando per eseguire il provisioning di 4 GB per membro si presenta come segue:

ibmcloud resource service-instance-create databases-for-mongodb <SERVICE_NAME> standard 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",
  "members_memory_allocation_mb": "4096"
}' --service-endpoints="private"

Il parametro members_host_flavor

Il parametro members_host_flavor definisce il dimensionamento del calcolo. Per eseguire il provisioning di un'istanza di calcolo condiviso, specificare multitenant. Per eseguire il provisioning di un'istanza di calcolo isolata, inserisci il valore appropriato per la configurazione desiderata di CPU e RAM.

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.

Elenco dei parametri aggiuntivi

Nell'oggetto --parameters si possono fornire informazioni aggiuntive per creare l'istanza del servizio, tra cui:

• backup_id- Un CRN di una risorsa di backup da cui ripristinare. Il backup deve essere creato da una installazione 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 è nel formato crn:v1:<...>:backup:<uuid>. Se omesso, il database viene fornito vuoto.

• version- La versione del database da approvvigionare. Se omesso, il database viene creato con la versione principale e secondaria più recente.

• disk_encryption_key_crn- Il CRN di una chiave KMS ( Key Protect ), che viene poi utilizzata per la crittografia del disco. Una chiave KMS CRN ha il formato crn:v1:<...>:key:<id>.

• backup_encryption_key_crn- Il CRN di una chiave KMS ( Key Protect ), che viene poi utilizzata per la crittografia di backup. Una chiave KMS CRN ha il formato crn:v1:<...>:key:<id>.

  Per utilizzare una chiave per i backup, è necessario innanzitutto abilitare la delega da servizio a servizio.

• members_memory_allocation_mb- Quantità totale di memoria da condividere tra i membri del database all'interno del database. Ad esempio, se il valore è "12288" e ci sono tre membri del database, l'installazione riceve 12 GB di RAM in totale, con 4 GB di RAM per membro. Se omesso, viene utilizzato il valore predefinito per il tipo di database. Questo parametro si applica solo a 'multitenante'.

• members_disk_allocation_mb- Quantità totale di disco da condividere tra i membri del database all'interno del database. Ad esempio, se il valore è "30720" e ci sono tre membri, l'installazione riceve 30 GB di disco totale, con 10 GB di disco per membro. Se omesso, viene utilizzato il valore predefinito per il tipo di database. Questo parametro si applica solo a 'multitenante'.

• members_cpu_allocation_count- Abilita e alloca il numero di core specificato per l'installazione. Ad esempio, per utilizzare due core dedicati per membro, utilizzare "members_cpu_allocation_count":"2". Se si omette, verranno applicati i rapporti CPU:RAM predefiniti di Shared Compute. Questo parametro si applica solo a 'multitenante'.

• members_allocation_count- Il numero totale di membri del database. Questo parametro si applica solo ai database scalabili orizzontalmente.

Provisioning del calcolo condiviso con Terraform

Predisporre un'istanza del modello di hosting condiviso Databases for Elasticsearch con il parametro "host_flavor" impostato su multitenant. Vedi il seguente esempio:

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 = "multitenant"
    },
    cpu {
      allocation_count = 6
    }
    memory {
      allocation_mb = 24576
    }
    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}"
}

Provisioning di calcolo isolato con Terraform

Disposizione a Databases for MongoDB Istanza isolata con lo stesso "host_flavor" parametro, impostandolo sulla dimensione isolata desiderata. Le dimensioni di hosting disponibili e i relativi parametri host_flavor value sono elencati nella Tabella 1. Per esempio,{"host_flavor": "b3c.4x16.encrypted"}. Tieni presente che, poiché la selezione del tipo di host include le dimensioni della CPU e della RAM (b3c.4x16.encrypted è 4 CPU e 16 RAM), questa richiesta non accetta sia una selezione di dimensioni isolate sia selezioni separate di 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 = "b3c.8x32.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 il dimensionamento del calcolo.

• Compute condiviso- Per eseguire il provisioning di un'istanza di Shared Compute, specificare multitenant.
• Isolated compute- Per eseguire il provisioning di un'istanza Isolated Compute, immettere il valore appropriato per la configurazione di CPU e RAM desiderata. Vedere i valori nella tabella seguente.

L'autoscaling di CPU e RAM non è supportato su Cloud Databases Isolated Compute. Il ridimensionamento automatico del disco è disponibile. Se avete effettuato il provisioning di un'istanza isolata o siete passati da un'implementazione con autoscaling, tenete d'occhio le vostre risorse usando l'integrazione di IBM Cloud® Monitoring, che fornisce metriche per la memoria, lo spazio su disco e l'utilizzo dell'I/O su disco. Per aggiungere risorse alla tua istanza, ridimensiona manualmente la tua distribuzione.