Diese Seite wurde von der Cloud Translation API übersetzt.

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.

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 aus, wie unter Instanzinformationen aufrufen beschrieben.

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
pscAutoConnections:
- 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
  projectId: my-project
  pscConnectionId: '38876592440606778'
- 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
  projectId: my-project
  pscConnectionId: '38876592440606779'
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:

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.
Installieren Sie valkey-cli auf der Compute Engine-VM. Folgen Sie dazu der Anleitung unter Valkey installieren.
Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie sich ihn.
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 Cluster-Supportmodus valkey-cli aktiviert. Wenn der -c-Schalter nicht angegeben ist, führt ein Zugriff auf Schlüssel von einem anderen Shard als dem, mit dem Sie verbunden sind, zu einem MOVED-Fehler. Im Cluster-Supportmodus wird der Client automatisch wieder mit der Adresse verbunden, die in der Fehlerantwort zurückgegeben wurde.
Führen Sie den Befehl CLUSTER SHARDS aus, um die Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.
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.
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"
```
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 dargestellt, bei der die Verschlüsselung während der Übertragung aktiviert ist.

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.
Installieren Sie die Zertifizierungsstelle Ihrer Instanz auf der Linux-VM. Folgen Sie dazu der Anleitung unter Zertifizierungsstellen auf Ihrem Client installieren.
Rufen Sie den Discovery-Endpunkt Ihrer Instanz auf und notieren Sie sich ihn.
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 Cluster-Supportmodus valkey-cli aktiviert. Wenn der -c-Schalter nicht angegeben ist, führt ein Zugriff auf Schlüssel von einem anderen Shard als dem, mit dem Sie verbunden sind, zu einem MOVED-Fehler. Im Cluster-Supportmodus wird der Client automatisch wieder mit der Adresse verbunden, die in der Fehlerantwort zurückgegeben wurde.
Führen Sie den Befehl CLUSTER SHARDS aus, um die Knotentopologie aufzurufen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.
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.
Geben Sie nach der Verbindung zum Knoten einige Valkey-Befehle ein:

Geben Sie Folgendes ein:
```
PING
```
Ergebnis:
```
PONG
```