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. .

Regionsübergreifender Zugriff

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

Discovery-Endpunkt der Instanz aufrufen

So rufen Sie den Discovery-Endpunkt Ihrer Instanz auf:

gcloud

Führen Sie den Befehl describe aus, um den Erkennungsendpunkt Ihrer Instanz anzusehen. gcloud CLI, wie unter Instanzinformationen anzeigen erläutert.

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. Wenn Sie diese beiden Werte zusammen verwenden, Erkennungsendpunkt der Instanz.

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

Sie können von jedem beliebigen Gerät aus eine Verbindung zur Instanz von Memorystore for Valkey herstellen Compute Engine-VM, die den Wert der Memorystore-Instanz verwendet autorisiertes Netzwerk.

So stellen Sie eine Verbindung zur Instanz her:

Wenn Sie noch keine Linux Compute Engine-VM haben, die den für Ihre Memorystore for Valkey-Instanz erstellen möchten, erstellen Sie eins und Stellen Sie eine Verbindung her. Folgen Sie dazu der Kurzanleitung zum Erstellen einer Linux-VM.
Installieren Sie valkey-cli auf der Compute Engine-VM, folgen Sie 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, wird beim Zugriff auf Schlüssel aus einem anderen Shard als dem, mit dem Sie verbunden sind, ein MOVED-Fehler ausgegeben. 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 anzusehen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.
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.
Sobald die Verbindung zum Knoten hergestellt ist, 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"
```
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 Konto Cloud-Rechnungskonto.

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 Erkennungsendpunkt Ihrer Instanz her: Befehl:
```
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, wird beim Zugriff auf Schlüssel aus einem anderen Shard als dem, mit dem Sie verbunden sind, ein MOVED-Fehler ausgegeben. 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 anzusehen. Notieren Sie sich eine der IP-Adressen und Portnummern des Knotens.
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.
Sobald die Verbindung zum Knoten hergestellt ist, geben Sie einige Valkey-Befehle ein:

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