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.

Clientunterstützung

Beispiele und Anleitungen zur Verwendung von Clientverbindungen finden Sie unter Codebeispiele für Clientbibliotheken. .

Regionenübergreifender Zugriff

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

Verbindung zu einer Instanz im Clustermodus herstellen

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

Discovery-Endpunkt der Instanz ansehen

So rufen Sie den Discovery-Endpunkt Ihrer Instanz auf:

gcloud

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

Die Ausgabe sollte in etwa so aussehen:

--location=us-central1 \
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_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 endpoints: für den Eintrag connectionType: CONNECTION_TYPE_DISCOVERY aufgeführt sind. Zusammen bilden diese beiden Werte den Discovery-Endpunkt Ihrer Instanz.

Verbindung von einer Compute Engine-VM mit valkey-cli herstellen

Sie können eine Verbindung zur Memorystore for Valkey-Instanz über eine beliebige 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 Valkey-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, indem Sie der Anleitung unter Valkey installieren folgen.

  3. Discovery-Endpunkt der Instanz ansehen und notieren.

  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

    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 dem folgenden 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 mit aktivierter Verschlüsselung während der Übertragung herstellen

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

  1. Wenn Sie 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. Discovery-Endpunkt der Instanz ansehen und notieren.

  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 dem folgenden 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, bei der der Clustermodus deaktiviert ist

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

Primären Endpunkt und Reader-Endpunkt der Instanz ansehen

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

gcloud

Wenn Sie den primären Endpunkt und den Reader-Endpunkt Ihrer Instanz aufrufen möchten, führen Sie die describegcloud CLI aus, wie unter Instanzinformationen ansehen 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 im Abschnitt endpoints: unter CONNECTION_TYPE_PRIMARY aufgeführt sind. Zusammen bilden diese beiden Werte den primären Endpunkt Ihrer Instanz.

Lese-Endpunkt:Notieren Sie sich die Endpunktadresse und Portnummer, die im Abschnitt endpoints: unter CONNECTION_TYPE_READER aufgeführt sind. Zusammen bilden diese beiden Werte den Lese-Endpunkt Ihrer Instanz.

Verbindung von einer Compute Engine-VM mit valkey-cli herstellen

Sie können eine Verbindung zur Memorystore for Valkey-Instanz über eine beliebige 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 Valkey-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, indem Sie der Anleitung unter Valkey installieren folgen.

  3. Primären Endpunkt und Reader-Endpunkt Ihrer Instanz ansehen und notieren.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum primären Endpunkt Ihrer Instanz her:

    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 mit dem folgenden Befehl eine Verbindung zum Lese-Endpunkt Ihrer Instanz her:

    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. So vermeiden Sie, dass Ihrem Cloud-Rechnungskonto Gebühren berechnet werden.

Verbindung zu einer Instanz mit aktivierter Verschlüsselung während der Übertragung herstellen

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

  1. Wenn Sie 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. Primären Endpunkt und Reader-Endpunkt Ihrer Instanz ansehen und notieren.

  4. Stellen Sie mit dem folgenden Befehl eine Verbindung zum primären Endpunkt Ihrer Instanz her:

    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 mit dem folgenden Befehl eine Verbindung zum Lese-Endpunkt Ihrer Instanz her:

    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