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 Ressourcengruppen verwalten.
• Standort – Die öffentliche Cloud-Region des Einsatzes.

Hosting-Modell

• Isoliert: Sichere Single-Tenant-Lösung für komplexe, hochleistungsfähige Unternehmens-Workloads.
• Shared: Flexibles Multi-Tenant-Angebot für dynamische, fein abgestimmte und entkoppelte Kapazitätsauswahlmöglichkeiten.

Databases for Elasticsearch Platin-Funktionen sind nur auf Isolated Compute verfügbar.

Weitere Informationen finden Sie unter Hosting models und Databases for Elasticsearch-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 Hosting-Modell für gemeinsam genutzte Rechenressourcen unterstützt differenziertere Ressourcenzuordnungen, die aus Gründen der Übersichtlichkeit nicht in der Benutzerschnittstelle 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 Die Bereitstellungsversion Ihrer Datenbank. Führen Sie die bevorzugte Version aus, um eine optimale Leistung sicherzustellen. Die neueste Nebenversion wird automatisch verwendet. Weitere Informationen finden Sie unter Versionspolitik.
• Datenbank-Edition: Nur bei Bereitstellung einstellen Wählen Sie die Edition, die Sie bereitstellen möchten. Wählen Sie zwischen Enterprise und Platinum. Beachten Sie, dass Platinum nur für das Modell des isolierten Hostings verfügbar ist.
• Verschlüsselung: Nur bei Bereitstellung einstellen Wenn SieKey Protect verwenden, können eine Instanz und ein Schlüssel ausgewählt werden, 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: Setzen Sie nur bei der Bereitstellung Konfigurieren Sie dieDienst-Endpunkte auf Ihrer Bereitstellung. Die Standardeinstellung ist „privat “.

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

Serviceinstanz über die Befehlszeilenschnittstelle erstellen

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) “ auf 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. Stellen Sie Ihre Datenbank mit dem folgenden Befehl bereit:

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

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

   ibmcloud resource service-instance-create test-database databases-for-elasticsearch enterprise us-south -p '{ "backup_id": "<BACKUP_CRN>", "version": "<VERSION_STRING>", "members_memory_allocation_mb": "4096" }' --service-endpoints="private"
   

   Bereitstellung einesDatabases for Elasticsearch Einzelfall mit dem gleichen "members_host_flavor"-p Parameter, und stellen Sie ihn auf die gewünschte isolierte Größe ein. Die verfügbaren Hostgrößen und ihre Parameter members_host_flavor value sind in Tabelle 2 aufgelistet. Zum Beispiel {"members_host_flavor": "b3c.4x16.encrypted"}. Da die Auswahl der Hostvariante CPU-und RAM-Größen umfasst (b3c.4x16.encrypted ist 4 CPU und 16 RAM), akzeptiert diese Anforderung nicht beides, eine Auswahl für isolierte Größe und eine separate Auswahl für die CPU-und RAM-Zuordnung.

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

   Die Felder im Befehl werden in der folgenden Tabelle beschrieben.

   Grundlegende Befehlsformatfelder

   Feld	Beschreibung	Flag
   INSTANCE_NAME Erforderlich	Der Instanzname kann eine beliebige Zeichenfolge sein und dient im Web sowie in der CLI zur Identifizierung der neuen Bereitstellung.
   SERVICE_NAME Erforderlich	Der Name oder die ID des Service. Für Databases for Elasticsearchverwenden Sie databases-for-elasticsearch.
   SERVICE_PLAN_NAME Erforderlich	enterprise oder platinum. Beachten Sie, dass platinum einen isolated Host Flavor erfordert.
   LOCATION Erforderlich	Der Standort, an dem Sie die Bereitstellung durchführen möchten. Verwenden Sie den Befehl ibmcloud regions, um eine Liste der Regionen abzurufen.
   RESOURCE_GROUP	Der Name der Ressourcengruppe. Der Standardwert ist default.	-g
   --parameters	JSON-Datei oder JSON-Zeichenfolge zum Erstellen einer Serviceinstanz.	-p
   members_host_flavor	Verwenden Sie {"members_host_flavor": "<members_host_flavor value>"}, um eine isolierte oder gemeinsam genutzte Recheninstanz bereitzustellen. Für Shared Compute geben Sie einen Wert von multitenant an. Wählen Sie für Isolierte Berechnung die gewünschte CPU-und RAM-Konfiguration aus. Weitere Informationen finden Sie in der folgenden Tabelle oder unter Hosting-Modelle.
   --service-endpoints Erforderlich	Konfigurieren Sie die Service-Endpunkte Ihrer Bereitstellung, entweder public, private oder public-and-private.

   In der Befehlszeile ist „ service-endpoints “ ein Flag und 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 Recheninstanz bereitzustellen, geben Sie den entsprechenden Wert für die gewünschte CPU-und RAM-Konfiguration ein.

Es wird eine Antwort wie die folgende angezeigt:

```text {: codeblock}
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-elasticsearch: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
```
- To check provisioning status, use the following command:

  ```sh {: pre}
  ibmcloud resource service-instance <INSTANCE_NAME>
  ```
  When complete, you will see a response like:

  ```text {: codeblock}
  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-elasticsearch:us-south:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
  GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
  Location:              <LOCATION>
  Service Name:          databases-for-elasticsearch
  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 elasticsearch with version 7.17 (100%)
  ```
- Optional: To delete a service instance, run the following command:

  ```sh {: pre}
  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 den Parameter „ -p “, mit dem JSON-formatierte Parameter an den Provisioning-Prozess ü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 einem bestimmten Backup bereitgestellt wird und die neue Datenbankbereitstellung insgesamt 12 GB Arbeitsspeicher auf drei Knoten verteilt benötigt, sieht der Befehl zur Bereitstellung von 4 GB pro Knoten wie folgt aus:

ibmcloud resource service-instance-create databases-for-elasticsearch <INSTANCE_NAME> enterprise us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-elasticsearch: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 Recheninstanz bereitzustellen, geben Sie den entsprechenden Wert für die 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.

Bereitstellung von gemeinsam genutzter Rechenleistung mit Terraform

Stellen Sie eine Databases for Elasticsearch-Modellinstanz für gemeinsam genutztes Hosting 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-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  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 Elasticsearch database connection string" {
  value = "http://${ibm_database.test_acc.ibm_database_connection.icd_conn}"
}

Bereitstellung von isolierter Rechenleistung mit Terraform

Stellen Sie eine isolierte Databases for Elasticsearch-Instanz mit demselben Parameter "host_flavor" bereit und setzen Sie sie auf die gewünschte isolierte Größe. Verfügbare Hostgrößen und ihre host_flavor value-Parameter sind in Tabelle 1 aufgelistet. Zum Beispiel {"host_flavor": "b3c.4x16.encrypted"}. Da die Auswahl der Hostvariante CPU-und RAM-Größen umfasst (b3c.4x16.encrypted ist 4 CPU und 16 RAM), akzeptiert diese Anforderung nicht beides, eine Auswahl für isolierte Größe und eine separate Auswahl für die CPU-und RAM-Zuordnung.

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-elasticsearch"
  resource_group_id = data.ibm_resource_group.group.id
  service_endpoints = "private"
  tags              = ["tag1", "tag2"]
  adminpassword     = "password12"
  # Pin the database version at provision time.
  # If omitted, the newest available major/minor is selected (per service behavior).
  version = "<VERSION_STRING>"                  # e.g. "8.19" for Elasticsearch preferred major
  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 Elasticsearch 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.