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 Informationen dazu, welche Clients für die Verbindung verwendet werden sollten, 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 mit aktiviertem Clustermodus herstellen.

Discovery-Endpunkt der Instanz ansehen

Jede Instanz mit aktiviertem Clustermodus hat einen Erkennungs-Endpunkt, mit dem sich Ihr Client verbindet. Dieser Endpunkt ist eine Kombination aus einer IP-Adresse und einer Portnummer.

Sie können den Discovery-Endpunkt einer Memorystore for Valkey-Instanz entweder über die Google Cloud Console oder die gcloud CLI aufrufen.

Wichtig :Zusätzlich zum Discovery-Endpunkt hat jede Instanz, für die der Clustermodus aktiviert ist, einen Datenendpunkt. Dieser Endpunkt ist für Memorystore for Valkey reserviert, um Ihren Client mit Knoten in der Instanz zu verbinden. Stellen Sie daher keine direkte Verbindung zu diesem Endpunkt her.

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:

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 im Abschnitt endpoints: für den Eintrag connectionType: CONNECTION_TYPE_DISCOVERY aufgeführte Endpunktadresse und Portnummer. Diese beiden Werte zusammen bilden den Discover-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.
   Hinweis: Mit dem Schalter -c wird der valkey-cli-Clustermodus aktiviert. Wenn der Schalter -c nicht angegeben ist und Sie versuchen, auf Schlüssel aus einem anderen Shard als dem zuzugreifen, mit dem Sie verbunden sind, führt dies zu einem MOVED-Fehler. Im Cluster-Support-Modus wird der Client automatisch wieder mit der Adresse verbunden, die in der Fehlerantwort zurückgegeben wird.

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. Sobald Sie eine Verbindung zum Knoten hergestellt haben, geben Sie 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 für die Verbindung mit einer Memorystore for Valkey-Instanz im Clustermodus mit aktivierter Verschlüsselung während der Übertragung beschrieben.

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 Zertifizierungsstellenzertifikate (Certificate Authority, CA) Ihrer Instanz auf der Linux-VM. Folgen Sie dazu der Anleitung unter CA-Zertifikate auf dem 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.
   Hinweis: Mit dem Schalter -c wird der valkey-cli-Clustermodus aktiviert. Wenn der Schalter -c nicht angegeben ist und Sie versuchen, auf Schlüssel aus einem anderen Shard als dem zuzugreifen, mit dem Sie verbunden sind, führt dies zu einem MOVED-Fehler. Im Cluster-Support-Modus wird der Client automatisch wieder mit der Adresse verbunden, die in der Fehlerantwort zurückgegeben wird.

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 mit deaktiviertem Clustermodus herstellen

In diesem Abschnitt wird beschrieben, 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 describe gcloud 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. Diese beiden Werte zusammen bilden den primären Endpunkt Ihrer Instanz.

Lese-Endpunkt:Notieren Sie sich die Endpunktadresse und die Portnummer, die im Abschnitt endpoints: unter CONNECTION_TYPE_READER aufgeführt sind. Diese beiden Werte zusammen ergeben 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 die 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 Ihr Cloud-Rechnungskonto mit Gebühren belastet wird.

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

In diesem Abschnitt wird ein Beispiel für die Verbindung mit einer Memorystore for Valkey-Instanz dargestellt, für die 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. Prüfen Sie den Zertifizierungsstellenmodus, den Sie für Ihre Instanz verwenden.

   • Wenn der CA-Modus per-instance lautet, installieren Sie die CA-Zertifikate Ihrer Instanz gemäß der Anleitung unter CA-Zertifikate auf dem Client installieren.

   • Wenn der CA-Modus shared ist, installieren Sie das CA-Zertifikatsbündel Ihrer Instanz gemäß der Anleitung unter CA-Zertifikatsbündel auf dem Client installieren.

   • Wenn der Zertifizierungsstellenmodus customer-managed ist, können Ihre Anwendungen eine Verbindung zur Instanz herstellen, ohne dass Sie zusätzliche Zertifizierungsstellenzertifikate herunterladen und installieren müssen. Sie können diesen Schritt daher überspringen.

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. Sobald Sie eine Verbindung zum Knoten hergestellt haben, geben Sie einige Valkey-Befehle ein:

   Geben Sie Folgendes ein:

   PING
   

   Ergebnis:

   PONG