Servicedetails

• Dienstname: Der Name kann eine beliebige Zeichenfolge sein und dient im Web sowie in der CLI zur Identifizierung der neuen Bereitstellung.
• 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 „ Verwalten von Ressourcengruppen “.
• Standort: Die Cloud-Region der Bereitstellung. In der Generation 2 ist Databases for MongoDB derzeit nur in den Regionen Montreal (ca-mon), Chennai – Airtel (in-che), Mumbai (in-mum), Frankfurt (eu-de), Washington (us-east), Madrid (eu-es), Sydney (au-syd), Dallas (us-south) und London (eu-gb) verfügbar.

Wählen Sie die Plattform für Ihre Bereitstellung aus.

• Gen 1: Die ursprüngliche Plattform von „ IBM Cloud® “, die in allen Rechenzentren von „ IBM Cloud “ verfügbar ist.
• Gen 2: Die neueste Plattform von IBM Cloud®, die auf einer hochsicheren, softwaredefinierten Netzwerkarchitektur basiert. Gen 2 ist für Cloud-native Anwendungen optimiert und derzeit nur in Montreal, Chennai, Mumbai, Frankfurt, Madrid, Sydney, Washington und London verfügbar.

Weitere Informationen finden Sie unter „ Übersicht über Gen 1(Classic)und Gen 2(VPC) “.

Hosting-Modell

Bei Gen 2 ist das einzige verfügbare Hosting-Modell „Isolated“ – ein sicheres Single-Tenant-Angebot für komplexe, hochleistungsfähige Unternehmens-Workloads. Weitere Informationen finden Sie unter „ Isolated Compute “.

Ressourcenzuordnung

Wählen Sie die anfängliche Host-Größe und die Festplattenkonfiguration für Ihre Bereitstellung aus. Die Hostgröße und die Festplattenzuweisung gelten pro Instanzmitglied.

• Host-Größe: Wählen Sie aus den verfügbaren Konfigurationen für „ vCPU “ und RAM diejenige aus, die Ihren Workload-Anforderungen entspricht.
• Festplatte: Legen Sie die anfängliche Festplattengröße für Ihre Bereitstellung fest. Stellen Sie die Festplattenkapazität mithilfe des Schiebereglers ein. Die Festplattengröße bestimmt die Zuweisung der IOPS. Jedes GB Festplattenspeicher bietet 5 IOPS.

Die Festplattengröße kann nach der Bereitstellung vergrößert, jedoch nicht verkleinert werden, um Datenverluste zu vermeiden.

Servicekonfiguration

• Datenbankversion: Set only at deployment Dies ist die Version Ihrer MongoDB-Bereitstellung. Die Konsole hebt die bevorzugte Version hervor, um eine optimale Leistung zu gewährleisten. Weitere Informationen finden Sie unter Richtlinie zur Versionsverwaltung.
• Datenbank-Edition: Set only at deployment Bei Gen 2 ist nur die Standard-Edition verfügbar.
• Verschlüsselung: Set only at deployment Wenn SieKey Protect verwenden, können Sie eine Instanz und einen Schlüssel auswählen, um die Festplatte der Bereitstellung zu verschlüsseln. Wenn Sie nicht Ihren eigenen Schlüssel verwenden, erstellt die Bereitstellung automatisch ihren eigenen Verschlüsselungsschlüssel und verwaltet ihn.
• Endpunkte Set only at deployment[Set only at deployment – Für Gen 2 werden nur private Endpunkte unterstützt.

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

Eine Service-Instanz über die CLI erstellen

Befolgen Sie vor der Bereitstellung die Anweisungen in der Dokumentation, um das CLI-Tool „ IBM Cloud “ zu 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. Sie können „ IBM Cloud® Databases for MongoDB “-Instanzen im Hosting-Modell „Isolated Compute“ auf der Gen-2-Plattform bereitstellen.

3. Richten Sie Ihre Datenbank mit dem folgenden Befehl ein:

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

   Um beispielsweise eine „ Databases for MongoDB “-Instanz bereitzustellen, verwenden Sie einen Befehl wie den folgenden:

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

   Stellen Sie eine isolierte Instanz von „ Databases for MongoDB “ mit demselben Parameter „ host_flavor “ -p bereit und legen Sie die gewünschte Größe für die isolierte Instanz fest. Die verfügbaren Hosting-Größen und ihre „ host_flavor value “-Parameter sind in Tabelle 2 aufgeführt.

   Da die Auswahl der Host-Konfigurationen für Mitglieder die CPU- und RAM-Größen umfasst (bx3d.4x20.encrypted entspricht 4 CPUs und 20 RAM), akzeptiert diese Anfrage nicht sowohl die Auswahl einer isolierten Größe als auch separate Auswahlen für die CPU- und RAM-Zuweisung.

   Die Felder im Befehl werden in der folgenden Tabelle beschrieben.

   Felder des grundlegenden Befehlsformats

   Feld	Beschreibung	Flag
   INSTANCE_NAME Required	Der Instanzname kann eine beliebige Zeichenfolge sein und dient im Web sowie in der CLI zur Identifizierung der neuen Bereitstellung.
   SERVICE_NAME Required	Der Name oder die ID des Service. Für „ Databases for MongoDB “ verwenden Sie bitte databases-for-mongodb.
   SERVICE_PLAN_NAME Required	standard-gen2
   LOCATION Required	Der Standort, an dem Sie die Bereitstellung vornehmen möchten. Um eine Liste der Regionen abzurufen, verwenden Sie den Befehl „ ibmcloud regions “.
   RESOURCE_GROUP	Der Name der Ressourcengruppe. Der Standardwert ist default.	-g
   --parameters	JSON-Datei oder JSON-Zeichenfolge zum Erstellen einer Serviceinstanz.	-p
   host_flavor	Um eine „Isolated Compute“-Instanz bereitzustellen, verwenden Sie {"host_flavor": "<host_flavor value>"}. Wählen Sie für „Isolated Compute“ die gewünschte CPU- und RAM-Konfiguration aus. Weitere Informationen finden Sie in der folgenden Tabelle 2.

   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
   

   • Um den Bereitstellungsstatus zu überprüfen, verwenden Sie den folgenden Befehl:

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   Sobald der Vorgang abgeschlossen ist, wird eine Antwort wie die folgende angezeigt:

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

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

   ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>
   

Der Parameter „ host_flavor “

Der Parameter „ host_flavor “ legt die Größe Ihrer Compute-Instanz fest. Um eine „Isolated Compute“-Instanz bereitzustellen, geben Sie den entsprechenden Wert für die gewünschte CPU- und RAM-Konfiguration ein.

Der Parameter „ --parameters “

Der service-instance-create Befehl unterstützt ein Flag -p, mit dem Parameter im JSON-Format an den Bereitstellungsprozess übergeben werden können. Sie können beispielsweise Cloud-Ressourcennamen (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 einem bestimmten Backup bereitgestellt wird und für die Bereitstellung der neuen Datenbank ein größerer Host mit der Größe „ 16x80 “ benötigt wird, sieht der Befehl wie folgt aus:

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

Beispiel

Um eine „Isolated Compute“-Instanz zu erstellen, gehen Sie wie in diesem Beispiel vor:

```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",
  },
}'
```
Stellen Sie eine isolierte Instanz vom Typ „ Databases for MongoDB “ mit demselben Parameter „ `host_flavor` “ bereit und legen Sie diesen auf die gewünschte Größe der isolierten Instanz fest. Die verfügbaren Hosting-Größen und ihre „ `host_flavor value` “-Parameter sind in [Tabelle 2](#members_host-flavor-parameter-api) aufgeführt. Zum Beispiel `{"host_flavor": "bx3d.4x20.encrypted"}`.

Da die Auswahl der Host-Konfigurationen für Mitglieder die CPU- und RAM-Größen umfasst (bx3d.4x20.encrypted entspricht 4 CPUs und 20 RAM), akzeptiert diese Anfrage nicht sowohl die Auswahl einer isolierten Größe als auch separate Auswahlen für die CPU- und RAM-Zuweisung.

Die Felder im Befehl werden in der folgenden Tabelle beschrieben.

Der Parameter „ host_flavor “

Der Parameter „ host_flavor “ legt die Größe Ihrer Compute-Instanz fest. Um eine „Isolated Compute“-Instanz bereitzustellen, geben Sie den entsprechenden Wert für die gewünschte CPU- und RAM-Konfiguration ein.

Liste der zusätzlichen Parameter

Im Objekt „ --parameters “ können Sie zusätzliche Informationen zur Erstellung Ihrer Service-Instanz angeben, darunter:

• backup_id – CRN einer Sicherungsressource, aus der wiederhergestellt werden soll. Das Backup muss von einer Datenbankbereitstellung mit derselben 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 ), die anschließend für die Festplattenverschlüsselung verwendet wird. Eine KMS-Schlüssel-CRN hat das Format crn:v1:<...>:key:<id>.
• backup_encryption_key_crn- Die CRN eines KMS-Schlüssels ( Key Protect ), die anschließend für die Verschlüsselung von Backups verwendet wird. Eine KMS-Schlüssel-CRN hat das Format crn:v1:<...>:key:<id>.

Um einen Schlüssel für Ihre Backups zu verwenden, müssen Sie zunächst [die Delegierung von Dienst zu Dienst aktivieren](/docs/cloud-databases?topic=cloud-databases-key-protect&interface=api#key-byok).
{: note}

Bereitstellung isolierter Rechenressourcen mit Terraform

Stellen Sie eine isolierte Instanz vom Typ „ Databases for MongoDB “ mit demselben Parameter „ "host_flavor" “ bereit und legen Sie diesen auf die gewünschte Größe der isolierten Instanz fest. Die verfügbaren Hosting-Größen und ihre Parameter für „ host_flavor value “ sind in Tabelle 1 aufgeführt. Zum Beispiel {"host_flavor": "bx3d.4x20.encrypted"}. Beachten Sie, dass die Auswahl der Host-Variante bereits Angaben zu CPU- und RAM-Kapazität enthält (bx3d.4x20.encrypted entspricht 4 CPUs und 16 RAM), weshalb bei dieser Anfrage nicht sowohl eine Auswahl der „Isolated“-Größe als auch separate Zuweisungen für CPU und RAM möglich sind.

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

Der Parameter „ host flavor “

Der Parameter „ host_flavor “ legt die Größe Ihrer Compute-Instanz fest. Um eine „Isolated Compute“-Instanz bereitzustellen, geben Sie den entsprechenden Wert für die gewünschte CPU- und RAM-Konfiguration ein. Siehe die Werte in der folgenden Tabelle.