Se connecter à une instance Memorystore pour Valkey

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

Assistance 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étection de votre instance

Pour afficher le point de terminaison de détection de votre instance, suivez les instructions suivantes:

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

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 VM Compute Engine qui utilise le réseau autorisé de l'instance Memorystore.

Pour vous connecter à l'instance:

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

2. Installez valkey-cli sur la VM Compute Engine en suivant les instructions de la section Installer Valkey.

3. Affichez le point de terminaison de découverte de votre instance et notez-le.

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

5. Exécutez la commande CLUSTER SHARDS pour afficher la topologie de vos nœuds. Notez l'une des adresses IP et des numéros de port du nœud.

6. 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 correspond au numéro de port du nœud que vous avez trouvé à l'étape précédente.

7. Une fois connecté au nœud, saisissez des 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"
   

8. Une fois que vous avez terminé de tester la connexion au nœud Valkey, pensez à supprimer la VM Compute Engine que vous avez utilisée pour vous connecter à l'instance Valkey. Vous éviterez ainsi que des frais soient facturés sur votre compte de facturation Cloud.

Se connecter à une instance avec chiffrement en transit activé

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

1. Si vous ne disposez pas encore d'une VM Compute Engine utilisant le même réseau autorisé que l'instance Valkey de l'étape précédente, créez-en une et connectez-vous en suivant les instructions de la page Démarrage rapide à l'aide d'une VM Linux.

   1. Installez la version 6.0 ou ultérieure de valkey-cli sur la VM Compute Engine en suivant les instructions de la section Installer Valkey.

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

3. Affichez le point de terminaison de découverte de votre instance et notez-le.

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

5. Exécutez la commande CLUSTER SHARDS pour afficher la topologie de vos nœuds. Notez l'une des adresses IP et des numéros de port du nœud.

6. 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 correspond au numéro de port du nœud que vous avez trouvé à l'étape précédente.

7. Une fois connecté au nœud, saisissez des commandes Valkey:

   Saisissez cette commande :

   PING
   

   Résultat :

   PONG