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 Exemples de code de la bibliothèque cliente. .

Accès interrégional

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

Se connecter à une instance pour laquelle le mode cluster est activé

Cette section explique comment se connecter à une instance Memorystore pour Valkey en mode cluster activé.

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 ci-dessous :

gcloud

Pour afficher le point de terminaison de découverte de votre instance, exécutez gcloud CLI describe comme expliqué dans 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
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

Notez l'adresse du point de terminaison et le numéro de port indiqués dans la section endpoints: pour l'entrée connectionType: CONNECTION_TYPE_DISCOVERY. Ces deux valeurs combinées constituent le point de terminaison de détection de votre 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 VM Compute Engine utilisant 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 utilisant le même réseau autorisé que votre instance Memorystore pour Valkey, créez-en une et connectez-vous en suivant les instructions de la page 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 votre nœud. Notez l'une des adresses IP et l'un des numéros de port du nœud.

  6. Connectez-vous au nœud de votre choix en exécutant la commande suivante :

    valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c

    Remplacez les éléments suivants :

    • NODE_IP_ADDRESS correspond à 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 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"

  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 pour laquelle le chiffrement en transit est activé

Cette section fournit un exemple de connexion à une instance Memorystore pour Valkey en mode cluster 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 votre nœud. Notez l'une des adresses IP et l'un des numéros de port du nœud.

  6. Connectez-vous au nœud de votre choix 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 correspond à 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 les commandes Valkey suivantes :

    Saisissez cette commande :

    PING

    Résultat :

    PONG

Se connecter à une instance dont le mode cluster est désactivé

Cette section explique comment se connecter à une instance Memorystore pour Valkey en mode cluster désactivé.

Afficher le point de terminaison principal et de lecteur de votre instance

Pour afficher le point de terminaison principal et de lecteur de votre instance, suivez les instructions ci-dessous :

gcloud

Pour afficher le point de terminaison principal et de lecteur de votre instance, exécutez la gcloud CLI describe, comme expliqué dans Afficher les informations sur l'instance.

La sortie devrait ressembler à ce qui suit :

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

Point de terminaison principal : notez l'adresse du point de terminaison et le numéro de port indiqués sous CONNECTION_TYPE_PRIMARY dans la section endpoints:. Ces deux valeurs combinées constituent le point de terminaison principal de votre instance.

Point de terminaison du lecteur : notez l'adresse du point de terminaison et le numéro de port indiqués sous CONNECTION_TYPE_READER dans la section endpoints:. Ces deux valeurs combinées constituent le point de terminaison du lecteur de votre 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 VM Compute Engine utilisant 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 utilisant le même réseau autorisé que votre instance Memorystore pour Valkey, créez-en une et connectez-vous en suivant les instructions de la page 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 principal et le point de terminaison de lecteur de votre instance et notez-les.

  4. Connectez-vous au point de terminaison principal de votre instance en exécutant la commande suivante :

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER

    Où :

    • PRIMARY_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.

  5. Une fois connecté au nœud principal, saisissez les commandes Valkey suivantes :

    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"

  6. Connectez-vous au point de terminaison du lecteur de votre instance en exécutant la commande suivante :

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER

    Où :

    • READER_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.

  7. Une fois connecté au nœud principal, saisissez les commandes Valkey Get suivantes :

    Saisissez cette commande :

    PING

    Résultat :

    PONG

    Saisissez le code suivant :

    GET HELLO

    Résultat :

    "WORLD"

  8. Une fois que vous avez testé votre connexion au nœud Valkey, vous devez 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 pour laquelle le chiffrement en transit est activé

Cette section fournit un exemple de connexion à une instance Memorystore pour Valkey en mode cluster désactivé 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 principal et le point de terminaison de lecteur de votre instance et notez-les.

  4. Connectez-vous au point de terminaison principal de votre instance en exécutant la commande suivante :

    valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    Où :

    • PRIMARY_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.

  5. Connectez-vous au point de terminaison du lecteur de votre instance en exécutant la commande suivante :

    valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem

    Où :

    • READER_ENDPOINT_ADDRESS et PORT_NUMBER sont les valeurs que vous avez notées à l'étape précédente.

  6. Une fois connecté au nœud, saisissez quelques commandes Valkey :

    Saisissez cette commande :

    PING

    Résultat :

    PONG