Servicedetails

• Dienstname: Der Name kann eine beliebige Zeichenfolge sein und ist der Name, der im Web und in der Befehlszeile zur Identifizierung der neuen Bereitstellung verwendet wird.
• Ressourcengruppe: Wenn Sie Ihre Dienste in Ressourcengruppen organisieren, geben Sie die Ressourcengruppe in diesem Feld an. Andernfalls können Sie die Standardeinstellung beibehalten. Weitere Informationen finden Sie unter Verwaltung von Ressourcengruppen.
• Ort: Die öffentliche Cloud-Region des Einsatzes.

Hosting-Modell

• Isoliert: Sicheres Single-Tenant-Angebot für komplexe, hochleistungsfähige Unternehmensworkloads.
• Shared: Flexibles, mandantenfähiges Angebot für eine dynamische, fein abgestimmte und entkoppelte Kapazitätsauswahl.

Databases for MongoDB Unternehmensfunktionen sind nur auf Isolated Compute verfügbar.

Weitere Informationen finden Sie unter Hosting models und Databases for MongoDB-Pläne.

Ressourcenzuordnung

Optimieren Sie Ihre Ressourcenzuordnung. Die verfügbaren Optionen variieren je nach ausgewähltem Hosting-Modell.

• Isoliert: Verwenden Sie die Tabelle, um die Maschinengröße für jedes Member Ihrer Implementierung auszuwählen, und geben Sie die Plattengröße an.
• Gemeinsam genutzt: Standardmäßig ist die kleinste mögliche Ressourcenzuordnung ausgewählt. Dies ist ideal für kleine Anwendungen oder Tests. Wählen Sie für größere Zuordnungen die Kachel Angepasst aus, die eine flexible Ressourcenkonfiguration mit mehr als 2 Kernen ermöglicht.

Das Shared Compute-Hostingmodell unterstützt feinere Ressourcenzuweisungen, die aus Gründen der Übersichtlichkeit nicht in der Benutzeroberfläche angezeigt werden. Weitere Informationen finden Sie unter Hosting-Modelle.

Geben Sie die Plattengröße entsprechend Ihren Anforderungen an. Sie kann nach der Bereitstellung erhöht, aber nicht verringert werden, um Datenverlust zu verhindern.

Servicekonfiguration

• Datenbankversion: Wird nur bei der Bereitstellung festgelegt Dies ist die Bereitstellungsversion Ihrer Datenbank. Wir empfehlen, die bevorzugte Version zu verwenden, um eine optimale Leistung zu gewährleisten. Weitere Informationen finden Sie unter Versionsrichtlinie.
• Datenbank-Edition: Wird nur bei der Bereitstellung festgelegt Wählen Sie aus den Plänen Standard, Enterprise oder Enterprise Sharding. Beachten Sie, dass die Pläne Enterprise und Enterprise Sharding nicht mit Shared Hosting verfügbar sind. Weitere Informationen finden Sie unter Pläne.
• Verschlüsselung: Nur bei der Implementierung festlegen Wenn SieKey Protect verwenden, können eine Instanz und ein Schlüssel ausgewählt werden, um die Platte der Implementierung zu verschlüsseln. Wenn Sie nicht Ihren eigenen Schlüssel verwenden, erstellt die Bereitstellung automatisch ihren eigenen Verschlüsselungsschlüssel und verwaltet ihn.
• Endpunkte: Nur bei Bereitstellung festlegen Konfigurieren Sie dieDienstendpunkte auf Ihrer Bereitstellung. Die Standardeinstellung ist privat.

Ein Databases for MongoDB Einsatz kann nicht gleichzeitig öffentliche und private Endpunkte haben.

Klicken Sie nach Auswahl der entsprechenden Einstellungen auf Erstellen, um den Bereitstellungsprozess zu starten.

Erstellen einer Dienstinstanz über die CLI

Befolgen Sie vor der Bereitstellung die Anweisungen in der Dokumentation, um das IBM Cloud-CLI-Toolzu installieren.

1. Melden Sie sich bei IBM Cloud an. Wenn Sie eine föderierte Benutzer-ID verwenden, ist es wichtig, dass Sie Ihr System auf die Benutzung eines Einmalkenncodes (ibmcloud login --sso) umstellen oder einen API-Schlüssel (ibmcloud --apikey key or @key_file) zur Authentifizierung verwenden. Weitere Informationen zur Anmeldung über die CLI finden Sie unter Allgemeine CLI-Befehle(ibmcloud) unter ibmcloud login.

   ibmcloud login
   

2. Wählen Sie das Hosting-Modell aus, auf dem Ihre Datenbank bereitgestellt werden soll. Sie können diese Angaben später ändern.

3. Bereitstellen Ihrer Datenbank mit dem folgenden Befehl:

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

Um zum Beispiel eine Databases for MongoDB Shared Compute-Hosting-Modell-Instanz bereitzustellen, verwenden Sie einen Befehl wie diesen:

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"

Stellen Sie eine Databases for MongoDB Isolierte Instanz mit demselben "members_host_flavor" -p Parameter bereit und setzen Sie ihn auf die gewünschte isolierte Größe. Verfügbare Hosting-Größen und deren members_host_flavor value Parameter sind aufgelistet in Tabelle 2. Zum Beispiel {"members_host_flavor": "b3c.4x16.encrypted"}. Da die Auswahl der Host-Variante CPU- und RAM-Größen umfasst (b3c.4x16.encrypted ist 4 CPU und 16 RAM), akzeptiert diese Anforderung nicht sowohl die Auswahl einer isolierten Größe als auch die separate Auswahl der CPU- und RAM-Zuweisung.

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

Die Felder im Befehl werden in der folgenden Tabelle beschrieben.

In der CLI ist service-endpoints ein Flag, kein Parameter.

Parameter members host flavor

Der Parameter members_host_flavor definiert Ihre Berechnungsdimensionierung.

• Um eine Shared Compute-Instanz bereitzustellen, geben Sie multitenant an. Um eine isolierte Compute-Instanz bereitzustellen, geben Sie den entsprechenden Wert für Ihre gewünschte CPU- und RAM-Konfiguration ein.

  Mitglieder host flavor sizing Parameter

  Gastgebergeschmack der Mitglieder	Mitglieder_host_flavor Wert
  Gemeinsam genutzte Rechenressourcen	multitenant
  4 CPUs x 16 RAM	b3c.4x16.encrypted
  8 CPUs x 32 RAM	b3c.8x32.encrypted
  8 CPUs x 64 RAM	m3c.8x64.encrypted
  16 CPUs x 64 RAM	b3c.16x64.encrypted
  32 CPUs x 128 RAM	b3c.32x128.encrypted
  30 CPUs x 240 RAM	m3c.30x240.encrypted

  Sie erhalten eine Antwort wie:

  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
  

• Verwenden Sie den folgenden Befehl, um den Bereitstellungsstatus zu überprüfen:

  ibmcloud resource service-instance <INSTANCE_NAME>
  

  Nach Abschluss werden Sie eine Antwort wie die folgende sehen:

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

• Optional: Um eine Dienstinstanz zu löschen, führen Sie den folgenden Befehl aus:

  ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
  

Die automatische CPU- und RAM-Skalierung wird auf Cloud Databases Isolated Compute nicht unterstützt. Automatische Plattenskalierung ist verfügbar. Wenn Sie eine isolierte Instanz bereitgestellt haben oder von einer Bereitstellung mit Autoscaling umgestiegen sind, sollten Sie Ihre Ressourcen mithilfe der IBM Cloud® Monitoring-Integration im Auge behalten, die Metriken für Arbeitsspeicher, Festplattenspeicher und Festplatten-E/A-Auslastung liefert. Um Ressourcen zu Ihrer Instanz hinzuzufügen, skalieren Sie Ihre Bereitstellung manuell.

Parameter --parameters

Der Befehl service-instance-create unterstützt das Flag -p, mit dem JSON-formatierte Parameter an den Bereitstellungsprozess übergeben werden können. Sie können beispielsweise Cloudressourcennamen (CRNs) als Parameterwerte übergeben, die eine Ressource in der Cloud eindeutig identifizieren. Alle Parameternamen und -werte werden als Zeichenfolgen übergeben.

Wenn beispielsweise eine Datenbank aus einer bestimmten Sicherung bereitgestellt wird und die neue Datenbankbereitstellung insgesamt 12 GB Speicher für drei Mitglieder benötigt, sieht der Befehl zur Bereitstellung von 4 GB pro Mitglied wie folgt aus:

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"

Parameter members_host_flavor

Der Parameter members_host_flavor definiert Ihre Berechnungsdimensionierung. Zur Bereitstellung einer gemeinsam genutzten Recheninstanz geben Sie multitenant an. Um eine isolierte Compute-Instanz bereitzustellen, geben Sie den entsprechenden Wert für Ihre gewünschte CPU- und RAM-Konfiguration ein.

Die automatische CPU- und RAM-Skalierung wird auf Cloud Databases Isolated Compute nicht unterstützt. Automatische Plattenskalierung ist verfügbar. Wenn Sie eine isolierte Instanz bereitgestellt haben oder von einer Bereitstellung mit Autoscaling umgestiegen sind, sollten Sie Ihre Ressourcen mithilfe der IBM Cloud® Monitoring-Integration im Auge behalten, die Metriken für Arbeitsspeicher, Festplattenspeicher und Festplatten-E/A-Auslastung liefert. Um Ressourcen zu Ihrer Instanz hinzuzufügen, skalieren Sie Ihre Bereitstellung manuell.

Liste der zusätzlichen Parameter

Im --parameters-Objekt können Sie zusätzliche Informationen zur Erstellung Ihrer Dienstinstanz angeben, einschließlich:

• backup_id – CRN einer Sicherungsressource, aus der wiederhergestellt werden soll. Die Sicherung muss von einem Datenbankeinsatz mit der gleichen Service-ID erstellt werden. Die Sicherung wird nach der Einrichtung geladen und die neue Bereitstellung, die diese Daten verwendet, wird gestartet. Ein Sicherungs-CRN hat das Format crn:v1:<...>:backup:<uuid>. Wenn diese Option nicht angegeben ist, wird die Datenbank leer bereitgestellt.

• version – Der Version der einzurichtenden Datenbank. Wenn diese Option nicht angegeben ist, wird die Datenbank mit der neuesten Haupt- und Nebenversion erstellt.

• disk_encryption_key_crn- Die CRN eines KMS-Schlüssels ( Key Protect ), der dann für die Festplattenverschlüsselung verwendet wird. Die CRN eines KMS-Schlüssels hat das Format crn:v1:<...>:key:<id>.

• backup_encryption_key_crn- Die CRN eines KMS-Schlüssels ( Key Protect ), der dann für die Backup-Verschlüsselung verwendet wird. Die CRN eines KMS-Schlüssels hat das Format crn:v1:<...>:key:<id>.

  Um einen Schlüssel für Ihre Backups zu verwenden, müssen Sie zunächst die Delegation von Dienst zu Dienst aktivieren.

• members_memory_allocation_mb – Gesamtmenge an Speicher, der von den Datenbankmembern innerhalb der Datenbank gemeinsam genutzt wird. Wenn der Wert beispielsweise "12288" lautet und es drei Datenbankmitglieder gibt, erhält der Einsatz insgesamt 12 GB RAM, was 4 GB RAM pro Mitglied ergibt. Wenn diese Option nicht angegeben wird, wird als Datenbanktyp der Standardwert verwendet. Dieser Parameter gilt nur für 'multitenant'.

• members_disk_allocation_mb – Gesamtmenge an Plattenspeicher, der von den Datenbankteilmembern innerhalb der Datenbank gemeinsam genutzt wird. Wenn der Wert beispielsweise '30720' lautet und es drei Member gibt, so erhält die Bereitstellung insgesamt 30 GB Plattenspeicher, wobei jedes Member 10 GB Plattenspeicher erhält. Wenn diese Option nicht angegeben wird, wird als Datenbanktyp der Standardwert verwendet. Dieser Parameter gilt nur für 'multitenant'.

• members_cpu_allocation_count- Aktiviert und weist die angegebene Anzahl von Kernen für Ihre Bereitstellung zu. Verwenden Sie beispielsweise "members_cpu_allocation_count":"2", um zwei dedizierte Cores pro Member zu verwenden. Wird diese Angabe weggelassen, wird das Standardverhältnis von Shared Compute CPU:RAM verwendet. Dieser Parameter gilt nur für 'multitenant'.

• members_allocation_count- Die Gesamtzahl der Datenbankmitglieder. Dieser Parameter gilt nur für horizontal skalierbare Datenbanken.

Gemeinsame Rechenleistung mit Terraform bereitstellen

Stellen Sie eine Databases for Elasticsearch Shared-Hosting-Modellinstanz bereit, wobei der Parameter "host_flavor" auf multitenant gesetzt ist. Sehen Sie sich das folgende Beispiel an:

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

Bereitstellung von isolierter Rechenleistung mit Terraform

Bereitstellung eines Databases for MongoDB Einzelfall mit dem gleichen "host_flavor" Parameter, und stellen Sie ihn auf die gewünschte isolierte Größe ein. Die verfügbaren Hostinggrößen und ihre host_flavor value Parameter sind in Tabelle 1 aufgeführt. Zum Beispiel {"host_flavor": "b3c.4x16.encrypted"}. Beachten Sie, dass die Auswahl der Host-Varianten CPU- und RAM-Größen umfasst (b3c.4x16.encrypted sind 4 CPU und 16 RAM), diese Anfrage akzeptiert nicht sowohl eine isolierte Größenauswahl als auch separate Auswahlen für die CPU- und RAM-Zuweisung.

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

Parameter host flavor

Der Parameter host_flavor definiert Ihre Berechnungsdimensionierung.

• Shared Compute- Um eine Shared Compute-Instanz bereitzustellen, geben Sie multitenant an.
• Isolated Compute- Um eine Isolated Compute-Instanz bereitzustellen, geben Sie den entsprechenden Wert für Ihre gewünschte CPU- und RAM-Konfiguration ein. Siehe die Werte in der folgenden Tabelle.

Die automatische CPU- und RAM-Skalierung wird auf Cloud Databases Isolated Compute nicht unterstützt. Automatische Plattenskalierung ist verfügbar. Wenn Sie eine isolierte Instanz bereitgestellt haben oder von einer Bereitstellung mit Autoscaling umgestiegen sind, sollten Sie Ihre Ressourcen mithilfe der IBM Cloud® Monitoring-Integration im Auge behalten, die Metriken für Arbeitsspeicher, Festplattenspeicher und Festplatten-E/A-Auslastung liefert. Um Ressourcen zu Ihrer Instanz hinzuzufügen, skalieren Sie Ihre Bereitstellung manuell.