Instanzbereitstellung in einem freigegebenen VPC-Netzwerk

Auf dieser Seite werden die gcloud CLI-Befehle aufgeführt, die zum Einrichten von Voraussetzungen, zum Bereitstellen einer Instanz in einem Dienstprojekt, zum Beschreiben einer Instanz und zum Löschen einer Instanz erforderlich sind. Folgen Sie der Anleitung in den einzelnen Abschnitten dieser Seite, um diese Aufgaben zu erledigen.

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

APIs aktivieren

Aktivieren Sie die folgenden APIs, die zum Konfigurieren einer Dienstverbindungsrichtlinie, zum Konfigurieren einer freigegebenen VPC und zum Erstellen einer Memorystore for 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 Valkey-Instanz bereitstellen möchten. Normalerweise wird dies von Ihrem Netzwerkadministrator erledigt. Möglicherweise haben Sie aber auch die erforderliche Berechtigung zum Ausführen des Befehls, 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 Name der Richtlinie.
    • HOST_PROJECT_ID ist die Hostprojekt-ID.
    • REGION ist dieselbe Region, in der Sie Ihre Memorystore for Valkey-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 Hostprojekt-ID.
    • 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 an die freigegebene VPC angehängt ist:

gcloud

gcloud memorystore instances create INSTANCE \
--project=SERVICE_PROJECT_ID \
--location=REGION \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--replica-count=REPLICA_COUNT \
--endpoints='[{"connections": [{"pscAutoConnection": {"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 Ihre 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

  • SHARD_COUNT bestimmt die Anzahl der Shards in Ihrer Instanz. 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 von Lesereplikaten (pro Shard). Zulässige Werte sind 0, 1 und 2.

  • HOST_PROJECT_ID ist die Hostprojekt-ID.

Instanz beschreiben

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

gcloud

gcloud 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 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.