Verbindung zu einer Memorystore for Valkey-Instanz herstellen

Auf dieser Seite wird erläutert, wie Sie eine Verbindung zu einer Memorystore for Valkey-Instanz herstellen.

Kundensupport

Beispiele und Informationen dazu, welche Verbindungsclients verwendet werden sollten, finden Sie unter Codebeispiele für Clientbibliotheken. .

Regionenübergreifender Zugriff

Sie können von einem Client, der sich in einer anderen Region als die Instanz befindet, auf eine Memorystore for Valkey-Instanz zugreifen.

Verbindung zu einer Instanz mit aktiviertem Clustermodus herstellen

In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zu einer Memorystore for Valkey-Instanz herstellen, für die der Clustermodus aktiviert ist.

Discovery-Endpunkt der Instanz aufrufen

So rufen Sie den Discovery-Endpunkt Ihrer Instanz auf:

gcloud

Wenn Sie den Discovery-Endpunkt Ihrer Instanz aufrufen möchten, führen Sie die describegcloud CLI wie unter Instanzinformationen aufrufen beschrieben aus.

Die Ausgabe sollte in etwa so aussehen:

--location=us-central1 \
authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
discoveryEndpoints:
- address: 10.128.0.58
  network: projects/my-project/global/networks/default
  port: 6379
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
       connectionType: CONNECTION_TYPE_DISCOVERY
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
       ipAddress: 10.128.0.58
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606778'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa
    - pscAutoConnection:
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
       ipAddress: 10.128.0.59
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606779'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa-2
replicaCount: 2
shardCount: 5
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

Notieren Sie sich die Endpunktadresse und die Portnummer, die im Abschnitt discovery_endpoints: aufgeführt sind. Diese beiden Werte zusammen bilden den Discover-Endpunkt Ihrer Instanz.

Verbindung über eine Compute Engine-VM mit valkey-cli herstellen

Sie können eine Verbindung zur Memorystore for Redis-Instanz über eine Compute Engine-VM herstellen, die das autorisierte Netzwerk der Memorystore-Instanz verwendet.

So stellen Sie eine Verbindung zur Instanz her:

  1. Wenn Sie noch keine Linux Compute Engine-VM haben, die das autorisierte Netzwerk für Ihre Memorystore for Redis-Instanz verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung zum Erstellen einer Linux-VM.

  2. Installieren Sie valkey-cli auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  3. Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie sich ihn.

  4. Stellen Sie eine Verbindung zum Discovery-Endpunkt Ihrer Instanz her, indem Sie den folgenden Befehl ausführen:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c

    Wobei:

    • DISCOVERY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Führen Sie den Befehl CLUSTER SHARDS aus, um die Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.

  6. Stellen Sie mit folgendem Befehl eine Verbindung zum gewünschten Knoten her:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    Ersetzen Sie Folgendes:

    • NODE_IP_ADDRESS ist die IP-Adresse des Knotens, die Sie im vorherigen Schritt ermittelt haben.
    • NODE_PORT ist die Portnummer des Knotens, die Sie im vorherigen Schritt ermittelt haben.

  7. Geben Sie nach der Verbindung zum Knoten einige Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Eingeben

    SET HELLO WORLD

    Ergebnis:

    OK

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  8. Nachdem Sie Ihre Verbindung zum Valkey-Knoten getestet haben, sollten Sie die Compute Engine-VM löschen, mit der Sie eine Verbindung zur Valkey-Instanz hergestellt haben. Dadurch vermeiden Sie, dass Ihrem Cloud-Rechnungskonto Gebühren berechnet werden.

Verbindung zu einer Instanz herstellen, für die die Verschlüsselung während der Übertragung aktiviert ist

In diesem Abschnitt wird ein Beispiel zum Herstellen einer Verbindung mit einer Memorystore for Valkey-Instanz im Clustermodus mit aktivierter Verschlüsselung während der Übertragung beschrieben.

  1. Wenn Sie noch keine Compute Engine-VM haben, die dasselbe autorisierte Netzwerk wie die Valkey-Instanz aus dem vorherigen Schritt verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung: Linux-VM verwenden.

    1. Installieren Sie valkey-cli Version 6.0 oder höher auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  2. Installieren Sie die Zertifizierungsstelle Ihrer Instanz auf der Linux-VM. Folgen Sie dazu der Anleitung unter Zertifizierungsstellen auf Ihrem Client installieren.

  3. Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie sich ihn.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum Discovery-Endpunkt Ihrer Instanz her:

    valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem

    Wobei:

    • DISCOVERY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Führen Sie den Befehl CLUSTER SHARDS aus, um die Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.

  6. Stellen Sie mit folgendem Befehl eine Verbindung zum gewünschten Knoten her:

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem

    Ersetzen Sie Folgendes:

    • NODE_IP_ADDRESS ist die IP-Adresse des Knotens, die Sie im vorherigen Schritt ermittelt haben.
    • NODE_PORT ist die Portnummer des Knotens, die Sie im vorherigen Schritt ermittelt haben.

  7. Nachdem Sie eine Verbindung zum Knoten hergestellt haben, geben Sie die folgenden Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

Verbindung zu einer Instanz herstellen, für die der Clustermodus deaktiviert ist

In diesem Abschnitt wird beschrieben, wie Sie eine Verbindung zu einer Memorystore for Redis-Instanz herstellen, für die der Clustermodus deaktiviert ist.

Primären und Reader-Endpunkt der Instanz ansehen

So rufen Sie den primären und Leserendpunkt Ihrer Instanz auf:

gcloud

Wenn Sie den primären und Reader-Endpunkt Ihrer Instanz aufrufen möchten, führen Sie die describegcloud CLI aus, wie unter Instanzinformationen aufrufen beschrieben.

Die Ausgabe sollte in etwa so aussehen:

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_PRIMARY
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
      ipAddress: 10.128.0.124
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606778'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_READER
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
      ipAddress: 10.128.0.125
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606779'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa-2
replicaCount: 2
shardCount: 1
mode: CLUSTER_DISABLED
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

Primärer Endpunkt:Notieren Sie sich die Endpunktadresse und die Portnummer, die unter CONNECTION_TYPE_PRIMARY im Abschnitt endpoints: aufgeführt sind. Diese beiden Werte zusammen bilden den primären Endpunkt Ihrer Instanz.

Reader-Endpunkt:Notieren Sie sich die Endpunktadresse und die Portnummer, die unter CONNECTION_TYPE_READER im Bereich endpoints: aufgeführt sind. Diese beiden Werte zusammen bilden den Leser-Endpunkt Ihrer Instanz.

Verbindung über eine Compute Engine-VM mit valkey-cli herstellen

Sie können eine Verbindung zur Memorystore for Redis-Instanz über eine Compute Engine-VM herstellen, die das autorisierte Netzwerk der Memorystore-Instanz verwendet.

So stellen Sie eine Verbindung zur Instanz her:

  1. Wenn Sie noch keine Linux Compute Engine-VM haben, die das autorisierte Netzwerk für Ihre Memorystore for Redis-Instanz verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung zum Erstellen einer Linux-VM.

  2. Installieren Sie valkey-cli auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  3. Notieren Sie sich den primären und den Reader-Endpunkt Ihrer Instanz.

  4. Stellen Sie eine Verbindung zum primären Endpunkt Ihrer Instanz her, indem Sie den folgenden Befehl ausführen:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    Wobei:

    • PRIMARY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Nachdem Sie eine Verbindung zum primären Knoten hergestellt haben, geben Sie die folgenden Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Eingeben

    SET HELLO WORLD

    Ergebnis:

    OK

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  6. Stellen Sie eine Verbindung zum Leserendpunkt Ihrer Instanz her, indem Sie den folgenden Befehl ausführen:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    Wobei:

    • READER_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  7. Nachdem Sie eine Verbindung zum primären Knoten hergestellt haben, geben Sie die folgenden Valkey Get-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG

    Geben Sie Folgendes ein:

    GET HELLO

    Ergebnis:

    "WORLD"

  8. Nachdem Sie Ihre Verbindung zum Valkey-Knoten getestet haben, sollten Sie die Compute Engine-VM löschen, mit der Sie eine Verbindung zur Valkey-Instanz hergestellt haben. Dadurch vermeiden Sie, dass Ihrem Cloud-Rechnungskonto Gebühren berechnet werden.

Verbindung zu einer Instanz herstellen, für die die Verschlüsselung während der Übertragung aktiviert ist

In diesem Abschnitt wird ein Beispiel zum Herstellen einer Verbindung mit einer Memorystore for Valkey-Instanz im Clustermodus deaktiviert, für die die Verschlüsselung während der Übertragung aktiviert ist.

  1. Wenn Sie noch keine Compute Engine-VM haben, die dasselbe autorisierte Netzwerk wie die Valkey-Instanz aus dem vorherigen Schritt verwendet, erstellen Sie eine VM und stellen Sie eine Verbindung zu ihr her: Folgen Sie dazu der Kurzanleitung: Linux-VM verwenden.

    1. Installieren Sie valkey-cli Version 6.0 oder höher auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.

  2. Installieren Sie die Zertifizierungsstelle Ihrer Instanz auf der Linux-VM. Folgen Sie dazu der Anleitung unter Zertifizierungsstellen auf Ihrem Client installieren.

  3. Notieren Sie sich den primären und den Reader-Endpunkt Ihrer Instanz.

  4. Stellen Sie eine Verbindung zum primären Endpunkt Ihrer Instanz her, indem Sie den folgenden Befehl ausführen:

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    Wobei:

    • PRIMARY_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  5. Stellen Sie eine Verbindung zum Leseendpunkt Ihrer Instanz her, indem Sie den folgenden Befehl ausführen:

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    Wobei:

    • READER_ENDPOINT_ADDRESS und PORT_NUMBER sind die Werte, die Sie im vorherigen Schritt notiert haben.

  6. Geben Sie nach der Verbindung zum Knoten einige Valkey-Befehle ein:

    Geben Sie Folgendes ein:

    PING

    Ergebnis:

    PONG