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 à partir d'un client situé dans une région différente de celle où se trouve l'instance.

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

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

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

Chaque instance pour laquelle le mode cluster est activé dispose d'un point de terminaison de détection auquel votre client se connecte. Ce point de terminaison est une combinaison d'une adresse IP et d'un numéro de port.

Vous pouvez afficher le point de terminaison de détection d'une instance Memorystore pour Valkey en utilisant la Google Cloud console ou la gcloud CLI.

gcloud

Pour afficher le point de terminaison de détection de votre instance, exécutez la describe gcloud CLI, 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_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 listés sous endpoints: pour l'entrée connectionType: CONNECTION_TYPE_DISCOVERY. Ces deux valeurs utilisées ensemble 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 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é de 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étection 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'adresse IP et le numéro de port de l'un des nœuds.

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

  1. Si vous ne disposez pas encore d'une VM Compute Engine qui utilise 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 valkey-cli version 6.0 ou ultérieure sur la VM Compute Engine en suivant les instructions de la section Installer Valkey.

  2. Installez les certificts de l'autorité de certification (CA) de votre instance sur la VM Linux en suivant les instructions de la section Installer les certificats CA sur le client.

  3. Affichez le point de terminaison de détection 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'adresse IP et le numéro de port de l'un des nœuds.

  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 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 pour laquelle le mode cluster est désactivé

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

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

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

gcloud

Pour afficher le point de terminaison principal et le point de terminaison de lecteur de votre instance, exécutez la describe gcloud CLI, 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 listés sous CONNECTION_TYPE_PRIMARY dans la section endpoints:. Ces deux valeurs utilisées ensemble constituent le point de terminaison principal de votre instance.

Point de terminaison de lecteur : notez l'adresse du point de terminaison et le numéro de port listés sous CONNECTION_TYPE_READER dans la section endpoints:. Ces deux valeurs utilisées ensemble constituent le point de terminaison de 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 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é de 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 de 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é la connexion au nœud Valkey, supprimez 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 pour laquelle le mode cluster est désactivé et le chiffrement en transit est activé.

  1. Si vous ne disposez pas encore d'une VM Compute Engine qui utilise 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 valkey-cli version 6.0 ou ultérieure sur la VM Compute Engine en suivant les instructions de la section Installer Valkey.

  2. Vérifiez le mode d'autorité de certification (CA) que vous utilisez pour votre instance.

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