Instanzen erstellen

Auf dieser Seite finden Sie eine Anleitung zum Erstellen von Memorystore for Valkey-Instanzen.

Hinweise

Führen Sie die Schritte im Abschnitt „Vorbereitung“ aus:

  1. Wählen Sie in der Google Cloud Console auf der Seite zur Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Hinweis:Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.


    Zur Projektauswahl
  2. Die Abrechnung für Ihr Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist.
  3. Installieren und initialisieren Sie die Google Cloud CLI.

    Hinweis:Wenn Sie die gcloud CLI bereits installiert haben, prüfen Sie, ob Sie die aktuelle Version haben, indem Sie gcloud components update ausführen. Sie benötigen mindestens die gcloud CLI-Version 489.0.0, um auf die gcloud CLI-Befehle für Memorystore for Valkey zuzugreifen.

  4. Aktivieren Sie die Memorystore for Valkey API.
    Memorystore for Valkey
  5. Aktivieren Sie die Network Connectivity API.
    Network Connectivity API
  6. Service Consumer Management API aktivieren
    Service Consumer Management API

Weitere Voraussetzungen

  • Sie benötigen eine der folgenden IAM-Rollen im Google Cloud Projekt, das Sie verwenden:
    • roles/memorystore.admin (die vordefinierte IAM-Rolle „Memorystore Admin“)
    • roles/owner (einfache IAM-Rolle „Inhaber“)
    • roles/editor (einfache IAM-Rolle „Bearbeiter“)

Netzwerk einrichten

Lesen Sie die Seite Netzwerk, um festzustellen, ob Sie eine Richtlinie für Dienstverbindungen einrichten müssen.

Wenn für das Netzwerk, mit dem Sie die Valkey-Instanz erstellen, noch keine Richtlinie für Dienstverbindungen erstellt wurde, folgen Sie der Netzwerkanleitung, um sie zu erstellen.

Instanz erstellen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Memorystore for Valkey auf.

    Memorystore for Valkey

  2. Klicken Sie auf Instanz erstellen.

  3. Wählen Sie auf der Seite Valkey-Instanz erstellen die gewünschten Konfigurationen für die neue Instanz aus.

    • Geben Sie unter Instanz benennen eine Instanz-ID ein. Die Instanz-ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Er muss auch mit einem Buchstaben beginnen und darf in der Region nur einmal vorkommen.
      • Beispiel: my-instance-1.
    • Wählen Sie unter Region auswählen eine Region für Ihre Instanz aus.
    • Wählen Sie unter Knotentyp den gewünschten Knotentyp aus.
    • Wählen Sie unter Modus zwischen Clustermodus aktiviert und Clustermodus deaktiviert aus.
    • Geben Sie unter Instanzgröße die Anzahl der Shards für Ihre Instanz an. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Instanzen mit deaktiviertem Clustermodus unterstützen nur einen Shard. Weitere Informationen finden Sie unter Instanz- und Shard-Spezifikation.
    • Wenn Sie eine Instanz mit Replikaten erstellen möchten, geben Sie unter Replikate die gewünschte Anzahl von Replikaten (pro Shard) ein. Die zulässigen Werte sind „Keine Replik“, „1 Replik“ und „2 Replikate“. Der Standardwert ist 1 Replikat, wenn Sie die Google Cloud Konsole verwenden.
    • Wählen Sie unter Verbindung einrichten das gewünschte Netzwerk aus. Weitere Informationen zu privaten Netzwerken für Memorystore for Valkey finden Sie unter Netzwerk.
    • Wenn Sie die IAM-Authentifizierung aktivieren möchten, wählen Sie IAM-Authentifizierung aktivieren aus.
    • Wenn Sie die Verschlüsselung bei der Übertragung aktivieren möchten, wählen Sie Transport Layer Security (TLS) aktivieren aus.
    • Wählen Sie unter Version auswählen Ihre Valkey-Version aus. Die Standardversion ist Valkey 7.2.
  4. Klicken Sie auf Instanz erstellen.

gcloud

Führen Sie den Befehl create aus, um eine Memorystore for Valkey-Instanz zu erstellen:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--mode=MODE

Ersetzen Sie Folgendes:

  • INSTANCE ist die ID der Memorystore for Valkey-Instanz, die Sie erstellen. Die Instanz-ID muss zwischen 1 und 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.

  • REGION_ID ist die Region, in der sich die Instanz befinden soll.

  • PROJECT_ID ist die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • NETWORK_ID ist die ID des Netzwerks, das Sie zum Erstellen der Instanz verwenden möchten.

  • REPLICA_COUNT ist die gewünschte Anzahl von Replikaten (pro Shard). Zulässige Werte sind 0, 1 und 2.

  • NODE_TYPE ist der von Ihnen ausgewählte Knotentyp. Zulässige Werte:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge
  • ENGINE_VERSION ist die von Ihnen ausgewählte Valkey-Engine-Version. Zulässige Werte sind VALKEY_7_2 und VALKEY_8_0.

  • SHARD_COUNT bestimmt die Anzahl der Shards in der Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Instanzen mit deaktiviertem Clustermodus unterstützen nur einen Shard. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.

  • MODE bestimmt, ob für die Instanz der Clustermodus aktiviert oder deaktiviert ist. Wenn dieses Feld ausgelassen wird, wird für die Instanz standardmäßig der Clustermodus aktiviert. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.

Beispiel:

Beispiel für den aktivierten Clustermodus


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--replica-count=2 \
--node-type=highmem-medium \
--shard-count=8 \
--mode=cluster

Beispiel für deaktivierten Clustermodus


gcloud memorystore instances create my-instance \
--location=us-central1 \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/my-project/global/networks/default", "projectId": "my-project"}}]}]' \
--shard-count=1 \
--replica-count=2 \
--node-type=highmem-medium \
--mode=cluster-disabled

Standardmäßig ist die Verschlüsselung bei der Übertragung deaktiviert und das autorisierte Netzwerk ist default.

Einzelzoneninstanz erstellen

In diesem Abschnitt finden Sie eine Anleitung zum Erstellen einer Instanz mit einer Zone.

gcloud

Führen Sie den Befehl create aus, um eine Einzelzoneninstanz zu erstellen:

gcloud memorystore instances create INSTANCE \
--location=REGION_ID \
--endpoints='[{"connections": [{"pscAutoConnection": {"network": "projects/PROJECT_ID/global/networks/NETWORK_ID", "projectId": "PROJECT_ID"}}]}]' \
--replica-count=REPLICA_COUNT \
--node-type=NODE_TYPE \
--engine-version=ENGINE_VERSION \
--shard-count=SHARD_COUNT \
--zone-distribution-config-mode=ZONE_DISTRIBUTION_CONFIG_MODE \
--zone-distribution-config=ZONE \
--mode=MODE

Ersetzen Sie Folgendes:

  • INSTANCE ist die ID der Memorystore for Valkey-Instanz, die Sie erstellen. Die Instanz-ID muss 1 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern oder Bindestriche enthalten. Er muss mit einem Kleinbuchstaben beginnen und mit einem Kleinbuchstaben oder einer Ziffer enden.

  • REGION_ID ist die Region, in der sich die Instanz befinden soll.

  • PROJECT_ID ist die ID des Projekts, in dem Sie die Instanz erstellen möchten.

  • NETWORK_ID ist die ID des Netzwerks, das Sie zum Erstellen der Instanz verwenden möchten.

  • REPLICA_COUNT ist die von Ihnen gewählte Anzahl von Replikaten (pro Shard). Zulässige Werte sind 0, 1 und 2.

  • NODE_TYPE ist der von Ihnen ausgewählte Knotentyp. Zulässige Werte:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge
  • ENGINE_VERSION ist die von Ihnen ausgewählte Valkey-Engine-Version. Zulässige Werte sind VALKEY_7_2 und VALKEY_8_0.

  • SHARD_COUNT bestimmt die Anzahl der Shards in der Instanz. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Wenn Sie den Modus „Clustermodus deaktiviert“ auswählen, können Sie nur einen Shard für Ihre Instanz angeben. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.

  • MODE bestimmt, ob für die Instanz der Clustermodus aktiviert oder deaktiviert werden soll. Wenn Sie dieses Feld weglassen, wird standardmäßig der Clustermodus aktiviert. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.

  • ZONE_DISTRIBUTION_CONFIG_MODE ist der Modus, mit dem Sie zwischen der Bereitstellung einer Instanz mit einer einzelnen Zone oder einer Instanz mit mehreren Zonen wählen können. Die Standardeinstellung ist „Mehrere Zonen“. Zulässige Werte sind single-zone und multi-zone.

  • ZONE ist die Zone, in der Sie Ihre Knoten bereitstellen möchten. Dieses Flag gilt nur, wenn --zone-distribution-config-mode= auf single-zone gesetzt ist.