Einrichtung

Gen 2

Stellen Sie eine „ IBM Cloud® Databases for Redis “-Bereitstellung über den Katalog, das CLI-Plugin „ Cloud Databases “, die „ Cloud Databases “-API oder mithilfe von Terraform bereit.

Bereitstellung über die „ IBM Cloud “-Konsole

Führen Sie die Bereitstellung über die Konsole durch, indem Sie die folgenden Parameter angeben.

  1. Konfigurieren Sie unter „ Dienstdetails “ Folgendes:

    • Standort Wählen Sie einen Standort aus, der Gen 2 unterstützt.
    • Dienstname: Der Name kann eine beliebige Zeichenfolge sein und dient im Web sowie in der CLI zur Identifizierung der neuen Instanz.
    • Ressourcengruppe: Wenn Sie Ihre Dienste in Ressourcengruppen organisieren. Weitere Informationen finden Sie unter Ressourcengruppen verwalten.

  2. Hosting-Modell: „Isolated“ ist ein sicheres Single-Tenant-Angebot für komplexe, hochleistungsfähige Unternehmens-Workloads. Weitere Informationen finden Sie unter „ Hosting-Modelle “.

  3. Ressourcenzuweisung: Passen Sie Ihre Ressourcenzuweisung an, indem Sie die für Ihre Bereitstellung erforderliche Hostgröße auswählen und die benötigte Festplattengröße angeben. Die Angaben für Hostgröße und Plattenzuordnung gelten pro Mitglied.

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

  4. Nehmen Sie in der Dienstkonfiguration folgende Einstellungen vor:

    • Datenbankversion Die Bereitstellungsversion Ihrer Datenbank. Um eine optimale Leistung zu gewährleisten, verwenden Sie bitte die empfohlene Version. Die neueste Nebenversion wird automatisch verwendet. Weitere Informationen finden Sie unter „ Richtlinie zur Datenbankversionierung “.
    • Verschlüsselung: Wenn Sie Key Protect, können eine Instanz und ein Schlüssel ausgewählt werden, um die Festplatte der Instanz zu verschlüsseln. Wenn Sie keinen eigenen Schlüssel verwenden, erstellt und verwaltet die Instanz automatisch einen eigenen Schlüssel zur Festplattenverschlüsselung.
    • Endpunkte: Konfigurieren Sie die Dienstendpunkte in Ihrer Bereitstellung. Die Standardeinstellung ist „privat “.

  5. Klicken Sie auf Erstellen. Die Seite „ Cloud Databases -Ressourcenliste“ wird geöffnet.

  6. Sobald Ihre Instanz bereitgestellt wurde, klicken Sie auf den Instanznamen, um weitere Informationen anzuzeigen.

Bereitstellung über die Befehlszeilenschnittstelle (CLI)

Führen Sie vor der Bereitstellung die in der Dokumentation beschriebenen Schritte zur Installation des CLI-Tools „ IBM Cloud “ durch.

  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. Eine Ressourcengruppe auswählen:

    ibmcloud target -g Default

  3. Erstellen Sie eine Instanz des Dienstes „ Databases for Redis “ unter IBM Cloud, indem Sie einen Befehl wie den folgenden ausführen:

    ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete

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

    ibmcloud resource service-instance-create redis-test-database databases-for-redis databases-for-redis-gen2-standard ca-mon -p '{"dataservices": {"redis": {"host_flavor":"bx3d.4x20"}}}' --user-tags test-redis,do-not-delete

    Der Parameter „ host_flavor “ legt die Größe Ihrer Compute-Instanz fest. Geben Sie den entsprechenden Wert für Ihre gewünschte CPU- und RAM-Konfiguration ein. Die verfügbaren Werte für die Host-Variante finden Sie unter „ Auswahl der Host-Variantengröße “.

    Die Felder des Befehls werden in der folgenden Tabelle beschrieben:

    Tabelle 1. Felder des grundlegenden Befehlsformats
    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 Redis “ verwenden Sie bitte databases-for-redis.
    SERVICE_PLAN_NAME Erforderlich Standard- gen2-Tarif (standard-gen2)
    LOCATION Erforderlich Der Standort, an dem Sie die Bereitstellung durchführen möchten. Um eine Liste der Regionen abzurufen, verwenden Sie den Befehl „ ibmcloud regions “. Bei einem API-Aufruf wird „Location“ als Ziel bezeichnet
    RESOURCE_GROUP Der Name der Ressourcengruppe. Der Standardwert ist Default. Geben Sie bei einem API-Aufruf die Ressourcengruppen-ID an. -g
    --parameters JSON-Datei oder JSON-Zeichenkette mit den Parametern zum Erstellen der Service-Instanz -p
    host_flavor Wählen Sie für „Isolated Compute“ die gewünschte CPU- und RAM-Konfiguration aus. Weitere Informationen finden Sie in der folgenden Tabelle oder unter „ Hosting-Modelle “.
    --user-tags Durch Kommas getrennte Liste von Benutzer-Tag-Namen

    Sie erhalten eine Antwort, die in etwa wie folgt aussieht:

    Creating service instance redis-test-database in resource group Default of account ICD as user@ibm.com...
OK
Service instance redis-test-database was created.
Name:                   redis-test-database
ID:                     crn:v1:bluemix:public:databases-for-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
GUID:                   4b6b8771-b44e-4687-9393-db8a2dec1942
Location:               ca-mon
State:                  provisioning
Type:                   service_instance
Sub Type:
Allow Cleanup:          false
Locked:                 false
One-time credentials:   false
Created at:             2026-06-25T12:48:00Z
Updated at:             2026-06-25T12:48:01Z
Last Operation:
                        Status    create in progress
                        Message   Started create instance operation

    Um den Status der Bereitstellung 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-redis:ca-mon:a/23b09aee04da4545b6e32805fa93249d:4b6b8771-b44e-4687-9393-db8a2dec1942::
GUID:                  4b6b8771-b44e-4687-9393-db8a2dec1942
Location:              <LOCATION>
Service Name:          databases-for-redis
Service Plan Name:     standard-gen2
Resource Group Name:   default
State:                 active
Type:                  service_instance
Sub Type:              Public
Locked:                false
Service Endpoints:     private
Created at:            2026-06-25T19:42:07Z
Created by:            USER
Updated at:            2026-06-25T19:53:25Z
Last Operation:
                       Status    create succeeded
                       Message   Provisioning redis with version 8.2 (100%)

Serviceinstanz aktualisieren

Sie können den Namen der Service-Instanz, die Service-Plan-ID und die Parameter mit einem Befehl wie dem folgenden aktualisieren:

ibmcloud resource service-instance-update service-instance-current-name --service-plan-id databases-for-redis-gen2-standard -p '{"dataservices": {"redis": {"storage_gb":20}}}' -g Default --name NEW_NAME

Serviceinstanz löschen

Löschen Sie eine Instanz, indem Sie einen Befehl wie den folgenden ausführen:

ibmcloud resource service-instance-delete <INSTANCE_NAME_OR_CRN>

Aus einer „ Redis “-Sicherung wiederherstellen

Sie können eine neue „ Redis “-Instanz anhand einer bestimmten Sicherung mit einem Befehl wie dem folgenden bereitstellen:

ibmcloud resource service-instance-create restore-instance-name databases-for-redis standard-gen2 ca-mon -g Default  -p '{
      "dataservices":{
            "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
}'

Einrichtung über die Ressourcencontroller-API

Führen Sie die folgenden Schritte aus, um die Bereitstellung über die Resource Controller-API durchzuführen.

  1. Rufen Sie mit dem folgenden Befehl ein IAM-Token ab:

    IAM_TOKEN=$(ibmcloud iam oauth-tokens -o json | jq .iam_token -r)

  2. Sie müssen die ID der Ressourcengruppe kennen, in der Sie die Bereitstellung durchführen möchten. Diese Informationen sind über die IBM Cloud-CLI verfügbar.

    Verwenden Sie einen Befehl wie:

    ibmcloud resource groups

    Notieren Sie sich die ID der gewünschten Ressourcengruppe. In den meisten Fällen verwenden wir den Standardwert für die Ressourcengruppe.

  3. Sie müssen die Region kennen, in der Sie die Bereitstellung vornehmen möchten.

    Um alle Regionen aufzulisten, in denen Deployments von der aktuellen Region aus bereitgestellt werden können, verwenden Sie das CLI-Plugin „ Cloud Databases “.

    Der Befehl sieht wie folgt aus:

    ibmcloud cdb regions --json

  4. Der Parameter „ host_flavor “ legt die Größe Ihrer Compute-Instanz fest. Wählen Sie den für Ihre Bereitstellung geeigneten Wert aus. Die verfügbaren Werte für die Host-Varianten finden Sie unter „ Gen 2 Isolated Compute “.

  5. Wenn Sie alle Informationen haben, führen Sie den Befehl „ eine neue Ressourceninstanz bereitstellen “ mit dem „ IBM Cloud Resource Controller“ aus.

    curl -X POST https://resource-controller.cloud.ibm.com/v2/resource_instances -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
    "name": "redis-test",
    "target": "ca-mon",
    "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
    "resource_plan_id": "databases-for-redis-gen2-standard",
    "parameters": {
      "dataservices": {
        "redis": {
          "host_flavor": "bx3d.4x20"
        }
      },
      "service_endpoints": "private",
      "version": "8.2"
    },
    "tags": [
      "redis-test",
      "do-not-delete"
    ]
  }'

    Die Felder im Befehl werden in der folgenden Tabelle beschrieben.

    Tabelle 3. Felder des grundlegenden Befehlsformats
    Feld Beschreibung Flag
    name Erforderlich Der Instanzname kann eine beliebige Zeichenfolge sein und dient im Web sowie in der CLI zur Identifizierung der neuen Bereitstellung.
    target Erforderlich Der Standort, an dem Sie die Bereitstellung durchführen möchten. Um eine Liste der Regionen abzurufen, verwenden Sie den Befehl „ ibmcloud regions “.
    resource_group Erforderlich Die ID der Ressourcengruppe. Der Standardwert ist Default.
    resource_plan_id Erforderlich Standard- gen2-Tarif (databases-for-redis)
    parameters JSON-Objekt mit den Parametern zum Erstellen einer Service-Instanz
    host_flavor Wählen Sie für „Isolated Compute“ die gewünschte CPU- und RAM-Konfiguration aus. Weitere Informationen finden Sie unter „ Hosting-Modelle “.
    service_endpoints Erforderlich Konfigurieren Sie die Service-Endpunkte Ihrer Bereitstellung: entweder public, private oder public-and-private.
    version Die Version der Datenbank, die bereitgestellt werden soll. Wenn diese Option nicht angegeben ist, wird die Datenbank mit der neuesten Haupt- und Nebenversion erstellt.
    tags Array mit Namen von Benutzer-Tags

Details zur Service-Instanz abrufen

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" | jq

Serviceinstanz aktualisieren

Sie können den Namen der Dienstinstanz und die Parameter mit dem folgenden Befehl aktualisieren:

curl -X PATCH https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}" -H 'Content-Type: application/json' -d '{
"name": "redis-test-testing-patch",
"parameters":{"dataservices":{"redis":{"host_flavor":"bx3d.8x40"}}}
}' | jq

Serviceinstanz löschen

Löschen Sie eine Instanz, indem Sie den folgenden Befehl ausführen:

curl -X DELETE https://resource-controller.cloud.ibm.com/v2/resource_instances/<service-instance-id> -H "Authorization: ${IAM_TOKEN}"

Aus einer „ Redis “-Sicherung wiederherstellen

Mit dem folgenden Befehl können Sie eine neue „ Redis “-Instanz aus einem bestimmten Backup bereitstellen:

curl -X POST   https://resource-controller.cloud.ibm.com/v2/resource_instances   -H "Authorization: ${IAM_TOKEN}"   -H 'Content-Type: application/json' -d '{
    "name": "redis-test-restore",
    "target": "ca-mon",
    "resource_group": "c21a4e8564c14d1aab2a9a8b441904eb",
    "resource_plan_id": "databases-for-redis-gen2-standard",
    "parameters": {
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    },
    "tags": [
      "redis-test"
    ]
  }'

Einrichtung mit Terraform

Verwenden Sie Terraform zur Verwaltung Ihrer Infrastruktur mithilfe der „ ibm_database “-Ressource für Terraform, die die Bereitstellung von „ Cloud Databases “-Bereitstellungen unterstützt.

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

Stellen Sie eine „ Databases for Redis “-Instanz bereit, wobei der Parameter „ "host_flavor" “ auf den gewünschten Host-Flavor gesetzt ist. Zum Beispiel:

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "your_instance_name"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["terraform", "redis"]
  resource_group_id = data.ibm_resource_group.group.id
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

Bevor Sie ein Terraform-Skript auf einer bestehenden Instanz ausführen, sollten Sie den Befehl „ terraform plan “ verwenden, um den aktuellen Zustand der Infrastruktur mit dem in Ihren Terraform-Dateien definierten Sollzustand zu vergleichen. Jede Änderung an den Attributen „ resource_group_id “, „ service plan “, „ version “, „ key_protect_instance “, „ key_protect_key “ oder „ backup_encryption_key_crn “ führt zur Neuerstellung Ihrer Instanz. Eine Liste der aktuellen Argumentreferenzen zur „ Forces new resource “-Spezifikation finden Sie in der ibm_database Terraform Registry.

Details zur Service-Instanz abrufen

data "ibm_resource_group" "group" {
  name = "<your_resource_group>"
}
data "ibm_resource_instance" "<your_instance_name>" {
  name              = "<your_instance_name>"
  location          = "us-east"
  resource_group_id = data.ibm_resource_group.group.id
  service = "databases-for-redis"
}
output "<your_instance_name>_output" {
  value ={
    id = data.ibm_resource_instance.<your_instance_name>.id
    name = data.ibm_resource_instance.<your_instance_name>.name
    extensions = data.ibm_resource_instance.<your_instance_name>.extensions
    group_id = data.ibm_resource_instance.<your_instance_name>.resource_group_id
  }
}

Serviceinstanz aktualisieren

Sie können den Parameter „host flavor“ mit dem folgenden Befehl aktualisieren:

data "ibm_resource_group" "group" {
  name = "your_resource_group"
}
resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags              = ["scaling","tf"]
  resource_group_id = data.ibm_resource_group.group.id
  parameters_json = jsonencode({
  "dataservices": {
      "redis": {
        "host_flavor": "bx2.8x32"
      }
  }
})
  timeouts {
    create = "120m"
    update = "120m"
    delete = "15m"
  }
}

Serviceinstanz löschen

Um von Terraform verwaltete Ressourcen zu löschen, führen Sie folgenden Befehl aus: terraform destroy

  • Wenn Terraform einen Benutzer anlegt, erstellt es automatisch eine State-Datei ( terraform.tfstate ), und die Details werden zu den Ressourcen der State-Datei hinzugefügt. Diese Datei erfasst alle verwalteten Ressourcen und wird von Terraform verwendet, um zu ermitteln, was beim Löschen entfernt werden soll.

  • Terraform kann nur Ressourcen löschen, die es selbst erstellt hat. Ressourcen, die über die Benutzeroberfläche, die Befehlszeilenschnittstelle oder die API bereitgestellt wurden, können von Terraform nicht gelöscht werden, es sei denn, sie wurden zuvor in den Terraform-Zustand importiert.

  • Alle Einträge, die in den Ressourcen der State-Datei vorhanden sind, werden gelöscht, wenn Sie den Befehl „destroy“ ausführen. Stellen Sie daher sicher, dass sich in der Ressourcenliste ausschließlich die Ressourcen befinden, die Sie löschen möchten, bevor Sie den Befehl ausführen. terraform destroy

Aus einer „ Redis “-Sicherung wiederherstellen

Mit dem folgenden Befehl können Sie eine neue „ Redis “-Instanz aus einem bestimmten Backup bereitstellen:

resource "ibm_resource_instance" "<your_instance_name>" {
  name = "<your_instance_name>"
  plan = "databases-for-redis-gen2-standard"
  service = "databases-for-redis"
  location = "us-east"
  tags      = ["terraform", "redis"]
    parameters_json = jsonencode({
      "dataservices": {
        "restore_backup_id": "<service-instance-crn>:backup:<backup-uuid>"
      }
    })
}