Instanzbereitstellung in einem freigegebene VPC-Netzwerk

Auf dieser Seite finden Sie die gcloud CLI-Befehle, die zum Einrichten der Voraussetzungen, zum Bereitstellen einer Instanz in einem Dienstprojekt, zum Beschreiben einer Instanz und zum Löschen einer Instanz erforderlich sind. Folgen Sie dazu der Anleitung in den einzelnen Abschnitten dieser Seite.

Ausführliche Informationen zu diesen Aufgaben finden Sie auf den folgenden Seiten:

APIs aktivieren

Aktivieren Sie die folgenden APIs, die zum Konfigurieren einer Richtlinie für Dienstverbindungen, zum Konfigurieren einer freigegebenen VPC und zum Erstellen eines Memorystore für die Valkey-Instanz erforderlich sind.

gcloud

  1. Aktivieren Sie die folgenden APIs im Dienstprojekt:

    gcloud services enable --project=SERVICE_PROJECT_ID networkconnectivity.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID serviceconsumermanagement.googleapis.com
gcloud services enable --project=SERVICE_PROJECT_ID memorystore.googleapis.com

    Ersetzen Sie SERVICE_PROJECT_ID durch die ID Ihres Dienstprojekts.

  2. Aktivieren Sie die folgenden APIs im Hostprojekt:

    gcloud services enable --project=HOST_PROJECT_ID networkconnectivity.googleapis.com

    Ersetzen Sie HOST_PROJECT_ID durch die ID Ihres Hostprojekts.

Richtlinie für Dienstverbindungen erstellen

Als Nächstes muss eine Richtlinie für Dienstverbindungen für das Hostprojekt der freigegebene VPC erstellt werden, in der die Richtlinie definiert ist, sowie für das Netzwerk, die Region und die Subnetze, in denen Sie die Memorystore for Redis-Instanz bereitstellen möchten. Normalerweise wird dies von Ihrem Netzwerkadministrator erledigt. Möglicherweise haben Sie aber auch die erforderliche Berechtigung, den Befehl auszuführen, wenn Sie die erforderliche Rolle haben.

In dieser Kurzanleitung werden das Netzwerk default und das Subnetz default verwendet. IP-Adressen für Ihre Instanz werden in diesem Standardsubnetz in der Region zugewiesen.

gcloud

  1. Führen Sie den Befehl create aus, um die Richtlinie für Dienstverbindungen zu erstellen:

    gcloud network-connectivity service-connection-policies create POLICY_NAME \
  --network=default \
  --project=HOST_PROJECT_ID \
  --region=REGION \
  --service-class=gcp-memorystore \
  --subnets=https://www.googleapis.com/compute/v1/projects/HOST_PROJECT_ID/regions/REGION/subnetworks/default

    Ersetzen Sie Folgendes:

    • POLICY_NAME ist der gewünschte Richtlinienname.
    • HOST_PROJECT_ID ist die ID des Hostprojekts.
    • REGION ist die Region, in der Sie die Memorystore for Redis-Instanz bereitstellen möchten.

  2. Führen Sie den Befehl list aus, um zu prüfen, ob die Richtlinie erfolgreich erstellt wurde:

    gcloud network-connectivity service-connection-policies list \
  --region=REGION \
  --project=HOST_PROJECT_ID

    Ersetzen Sie Folgendes:

    • HOST_PROJECT_ID ist die ID des Hostprojekts.
    • REGION ist die Region, in der die Richtlinie für Dienstverbindungen definiert ist.

Instanz erstellen

Führen Sie den folgenden Befehl aus, um eine Instanz im Dienstprojekt zu erstellen, das mit der freigegebene VPC verknüpft ist:

gcloud

gcloud beta memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--psc-auto-connections=network=projects/HOST_PROJECT_ID/global/networks/default,projectId=SERVICE_PROJECT_ID

Ersetzen Sie Folgendes:

  • INSTANCE ist die Instanz-ID.
  • SERVICE_PROJECT_ID ist die ID des Dienstprojekts.

  • REGION ist die Region, in der Sie die Instanz bereitstellen möchten.

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

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    Weitere Informationen zu Knotentypen und Instanzkonfigurationen finden Sie in der Spezifikation für Instanzen und Knoten.

  • SHARD_COUNT gibt die Anzahl der Shards in Ihrer Instanz an. Die Anzahl der Shards bestimmt die Gesamtspeicherkapazität für das Speichern von Instanzdaten. Weitere Informationen zur Instanzspezifikation finden Sie unter Instanz- und Knotenspezifikation.

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

  • HOST_PROJECT_ID ist die ID des Hostprojekts.

Instanz beschreiben

Führen Sie den folgenden Befehl aus, um die Instanzdetails aufzurufen:

gcloud

gcloud beta memorystore instances describe INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Ersetzen Sie Folgendes:

  • INSTANCE ist die Instanz-ID.
  • SERVICE_PROJECT_ID ist die ID des Dienstprojekts.
  • REGION ist die Region, in der sich Ihre Instanz befindet.

Instanz löschen

Führen Sie folgenden Befehl aus, um eine Instanz zu löschen:

gcloud

gcloud beta memorystore instances delete INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION

Ersetzen Sie Folgendes:

  • INSTANCE ist die Instanz-ID.
  • SERVICE_PROJECT_ID ist die ID des Dienstprojekts.
  • REGION ist die Region, in der sich Ihre Instanz befindet.