Instanzbereitstellung in einem freigegebene VPC-Netzwerk

Auf dieser Seite sind die gcloud CLI-Befehle aufgeführt, die zum Einrichten der Voraussetzungen, zum Bereitstellen einer Instanz in einem Dienstprojekt, zum Beschreiben einer Instanz und zum Löschen einer Instanz erforderlich sind. Um diese Aufgaben auszuführen, folgen Sie der Anleitung in den einzelnen Abschnitten auf dieser Seite.

Ausführlichere 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 gemeinsam genutzten 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 Ihre Dienstprojekt-ID.

  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, das Netzwerk, die Region und die Subnetze, in denen Sie die Memorystore for Valkey-Instanz bereitstellen möchten. Normalerweise wird dies von Ihrem Netzwerkadministrator ausgeführt, Möglicherweise haben Sie aber auch die erforderliche Berechtigung, den Befehl auszuführen, wenn Sie die erforderliche Rollehaben.

In dieser Kurzanleitung werden das default-Netzwerk und das default-Subnetz verwendet. IP-Adressen für Ihre Instanz werden in dieser Region in diesem Standardsubnetz 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 Dienstprojekt-ID.

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

  • NODE_TYPE ist der Knotentyp, den Sie für die Instanz verwenden möchten.

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

  • REPLICA_COUNT ist die Anzahl der Lesereplikate (pro Shard). Zulässige Werte sind 0–5.

  • 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 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 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 Ihre Instanz befindet.