Cette page a été traduite par l'API Cloud Translation.

Se connecter à une instance Memorystore pour Valkey

Cette page explique comment se connecter à une instance Memorystore pour Valkey.

Service client

Pour obtenir des exemples et des conseils sur les clients de connexion à utiliser, consultez la section Exemples de code de bibliothèque cliente. .

Accès interrégional

Vous pouvez accéder à une instance Memorystore pour Valkey à partir d'un client situé dans une région différente de celle de l'instance.

Afficher le point de terminaison de découverte de votre instance

Pour afficher le point de terminaison de découverte de votre instance, procédez comme suit:

gcloud

Pour afficher le point de terminaison de découverte de votre instance, exécutez la commande describe gcloud CLI comme expliqué dans la section Afficher les informations sur les instances.

La sortie devrait ressembler à ce qui suit :

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

Notez l'adresse du point de terminaison et le numéro de port indiqués dans la section discovery_endpoints:. Ces deux valeurs utilisées ensemble correspondent point de terminaison de découverte de l'instance.

Se connecter à partir d'une VM Compute Engine à l'aide de valkey-cli

Vous pouvez vous connecter à l'instance Memorystore pour Valkey depuis n'importe quelle Une VM Compute Engine qui utilise l'instance Memorystore réseau autorisé.

Pour vous connecter à l'instance:

Si vous ne disposez pas encore d'une VM Compute Engine Linux qui utilise le réseau autorisé pour votre instance Memorystore for Redis, créez-en une et connectez-vous en suivant la procédure de démarrage rapide pour créer une VM Linux.
Installez valkey-cli sur la VM Compute Engine en exécutant la commande suivante : en suivant les instructions de la section Installer Valkey.
Afficher le point de terminaison de découverte de votre instance et prenez-en note.
Connectez-vous au point de terminaison de détection de votre instance en exécutant la commande suivante :
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
Où :
- DISCOVERY_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.
Remarque :Le bouton bascule -c permet d'activer le mode de prise en charge du cluster valkey-cli. Si le commutateur -c n'est pas fourni, lorsque vous essayez d'accéder aux clés depuis un un segment différent de celui auquel vous êtes connecté, vous obtenez une MOVED . En mode d'assistance du cluster, le client est automatiquement reconnecté à l'adresse renvoyée dans la réponse d'erreur.
Exécutez la commande CLUSTER SHARDS pour afficher la topologie des nœuds. Créer une note de l'un des numéros de port et adresses IP du nœud.
Connectez-vous au nœud souhaité en exécutant la commande suivante:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
Remplacez les éléments suivants :
- NODE_IP_ADDRESS est l'adresse IP du nœud que vous avez trouvée à l'étape précédente.
- NODE_PORT est le numéro de port du nœud que vous avez trouvé à l'étape étape.
Une fois connecté au nœud, saisissez quelques commandes Valkey:

Saisissez cette commande :
```
PING
```
Résultat :
```
PONG
```
Saisissez les informations suivantes :
```
SET HELLO WORLD
```
Résultat :
```
OK
```
Saisissez le code suivant :
```
GET HELLO
```
Résultat :
```
"WORLD"
```
Une fois que vous avez terminé de tester votre connexion au nœud Valkey, vous devez envisagez de supprimer la VM Compute Engine que vous avez utilisée pour vous connecter Instance Valkey. Vous éviterez ainsi que des frais ne soient facturés sur votre Compte de facturation Cloud.

Se connecter à une instance pour laquelle le chiffrement en transit est activé

Cette section fournit un exemple de connexion à une instance Memorystore pour Valkey pour laquelle le chiffrement en transit est activé.

Si aucune de vos VM Compute Engine n'utilise le même réseau autorisé comme instance Valkey de l'étape précédente, créez-en un et connectez-vous à celle-ci en suivant la procédure Démarrage rapide avec une VM Linux.
1. Installer valkey-cli version 6.0 ou ultérieure sur la VM Compute Engine en suivant les instructions de la section Installer Valkey.
Installez l'autorité de certification de votre instance sur la VM Linux en suivant les instructions de la section Installer des autorités de certification sur votre client.
Affichez le point de terminaison de découverte de votre instance et notez-le.
Connectez-vous au point de terminaison de découverte de votre instance en exécutant la commande suivante : commande:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
Où :
- DISCOVERY_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.
Remarque :Le bouton bascule -c permet d'activer le mode de prise en charge du cluster valkey-cli. Si le commutateur -c n'est pas fourni, lorsque vous essayez d'accéder aux clés depuis un un segment différent de celui auquel vous êtes connecté, vous obtenez une MOVED . En mode d'assistance du cluster, le client est automatiquement reconnecté à l'adresse renvoyée dans la réponse d'erreur.
Exécutez la commande CLUSTER SHARDS pour afficher la topologie des nœuds. Créer une note de l'un des numéros de port et adresses IP du nœud.
Connectez-vous au nœud souhaité en exécutant la commande suivante:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
Remplacez les éléments suivants :
- NODE_IP_ADDRESS est l'adresse IP du nœud que vous avez trouvée à l'étape précédente.
- NODE_PORT est le numéro de port du nœud que vous avez trouvé à l'étape étape.
Une fois connecté au nœud, saisissez quelques commandes Valkey:

Saisissez cette commande :
```
PING
```
Résultat :
```
PONG
```