Instanzbereitstellung in einem freigegebene VPC-Netzwerk

Auf dieser Seite werden die gcloud CLI-Befehle aufgeführt, die zum Einrichten von eine Instanz in einem Dienstprojekt bereitstellen, eine Instanz beschreiben, und eine Instanz löschen. Um diese Aufgaben zu erfüllen, sollten Sie die Anweisungen 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 Dienstverbindung erforderlich sind Richtlinie, Freigegebene VPC konfigurieren, und eine Instanz von Memorystore for Valkey erstellen.

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 freigegebenen 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 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 Hostprojekt-ID.
    • REGION ist die Region, in der Sie die Memorystore for Redis-Instanz bereitstellen möchten.

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

    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 freigegebenen 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=HOST_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 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 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 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 Dienstprojekt-ID.
  • 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 Dienstprojekt-ID.
  • REGION ist die Region, in der sich die Instanz befindet.