Conéctate a una instancia de Memorystore para Valkey

En esta página, se explica cómo conectarse a una instancia de Memorystore para Valkey.

Compatibilidad con el cliente

Para obtener ejemplos y orientación sobre qué clientes de conexión usar, consulta Muestras de código de la biblioteca cliente. .

Acceso entre regiones

Puedes acceder a una instancia de Memorystore para Valkey desde un cliente ubicado en una región diferente a la de la instancia.

Conéctate a una instancia con el modo de clúster habilitado

En esta sección, se explica cómo conectarse a una instancia de Memorystore para Valkey con el modo de clúster habilitado.

Consulta el extremo de detección de tu instancia

Cada instancia con el modo de clúster habilitado tiene un extremo de detección al que se conecta tu cliente. Este extremo es una combinación de una dirección IP y un número de puerto.

Puedes ver el extremo de detección de una instancia de Memorystore para Valkey con la Google Cloud consola o la CLI de gcloud.

Importante: Además del extremo de detección, cada instancia con el modo de clúster habilitado tiene un extremo de datos. Este extremo está reservado para que Memorystore para Valkey lo use para conectar tu cliente a los nodos de la instancia. Por lo tanto, no te conectes a este extremo directamente.

gcloud

Para ver el extremo de detección de tu instancia, ejecuta la describe gcloud CLI como se explica en Ver la información de la instancia.

El resultado debería ser similar al siguiente ejemplo:

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

Toma nota de la dirección del extremo y el número de puerto que aparecen en la sección endpoints: para la entrada connectionType: CONNECTION_TYPE_DISCOVERY. Estos dos valores usados juntos son el extremo de detección de tu instancia.

Conéctate desde una VM de Compute Engine con valkey-cli

Puedes conectarte a la instancia de Memorystore para Valkey desde cualquier VM de Compute Engine que use la red autorizada de la instancia de Memorystore.

Para conectarte a la instancia, haz lo siguiente:

1. Si aún no tienes una VM de Compute Engine de Linux que use la red autorizada para tu instancia de Memorystore para Valkey, crea una y conéctate a ella siguiendo la Guía de inicio rápido para crear una VM de Linux.

2. Instala valkey-cli en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.

3. Consulta el extremo de detección de tu instancia y toma nota de él.

4. Para conectarte al extremo de detección de tu instancia, ejecuta el siguiente comando:

   valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
   

   Aquí:

   • DISCOVERY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.
   Nota: El modificador -c se usa para habilitar el modo de compatibilidad con clústeres de valkey-cli. Si no se proporciona el modificador -c, cuando intentas acceder a claves de un fragmento diferente al que estás conectado, se produce un error MOVED. En el modo de compatibilidad con clústeres, el cliente se vuelve a conectar automáticamente a la dirección que se muestra en la respuesta de error.

5. Ejecuta el comando CLUSTER SHARDS para ver la topología de tu nodo. Toma nota de una de las direcciones IP y los números de puerto del nodo.

6. Para conectarte al nodo deseado, ejecuta el siguiente comando:

   valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
   

   Reemplaza lo siguiente:

   • NODE_IP_ADDRESS es la dirección IP del nodo que encontraste en el paso anterior.
   • NODE_PORT es el número de puerto del nodo que encontraste en el paso anterior.

7. Una vez que te conectes al nodo, ingresa algunos comandos de Valkey:

   Escribe lo siguiente:

   PING
   

   Resultado:

   PONG
   

   Ingresa:

   SET HELLO WORLD
   

   Resultado:

   OK
   

   Ingrese:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Una vez que termines de probar tu conexión con el nodo de Valkey, debes considerar borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. Esto te ayuda a evitar que se generen cargos en tu cuenta de Facturación de Cloud.

Conéctate a una instancia con la encriptación en tránsito habilitada

En esta sección, se proporciona un ejemplo de cómo conectarse a una instancia de Memorystore para Valkey con el modo de clúster habilitado que tiene habilitada la encriptación en tránsito.

1. Si aún no tienes una VM de Compute Engine que use la misma red autorizada que la instancia de Valkey del paso anterior, crea una y conéctate a ella siguiendo la Guía de inicio rápido sobre el uso de una VM de Linux.

   1. Instala valkey-cli versión 6.0 o posterior en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.

2. Instala los certificados de la autoridad certificadora (AC) de tu instancia en la VM de Linux siguiendo las instrucciones en Instala certificados de AC en el cliente.

3. Consulta el extremo de detección de tu instancia y toma nota de él.

4. Para conectarte al extremo de detección de tu instancia, ejecuta el siguiente comando:

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

   Aquí:

   • DISCOVERY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.
   Nota: El modificador -c se usa para habilitar el modo de compatibilidad con clústeres de valkey-cli. Si no se proporciona el modificador -c, cuando intentas acceder a claves de un fragmento diferente al que estás conectado, se produce un error MOVED. En el modo de compatibilidad con clústeres, el cliente se vuelve a conectar automáticamente a la dirección que se muestra en la respuesta de error.

5. Ejecuta el comando CLUSTER SHARDS para ver la topología de tu nodo. Toma nota de una de las direcciones IP y los números de puerto del nodo.

6. Para conectarte al nodo deseado, ejecuta el siguiente comando:

   valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
   

   Reemplaza lo siguiente:

   • NODE_IP_ADDRESS es la dirección IP del nodo que encontraste en el paso anterior.
   • NODE_PORT es el número de puerto del nodo que encontraste en el paso anterior.

7. Después de conectarte al nodo, ingresa los siguientes comandos de Valkey:

   Escribe lo siguiente:

   PING
   

   Resultado:

   PONG
   

Conéctate a una instancia con el modo de clúster inhabilitado

En esta sección, se explica cómo conectarse a una instancia de Memorystore para Valkey con el modo de clúster inhabilitado.

Consulta el extremo principal y de lector de tu instancia

Para ver el extremo principal y de lector de tu instancia, sigue estas instrucciones:

gcloud

Para ver el extremo principal y de lector de tu instancia, ejecuta la describe gcloud CLI, como se explica en Ver la información de la instancia.

El resultado debería ser similar al siguiente ejemplo:

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

Extremo principal: Toma nota de la dirección del extremo y el número de puerto que aparecen en CONNECTION_TYPE_PRIMARY en la sección endpoints:. Estos dos valores usados juntos son el extremo principal de tu instancia.

Extremo de lector: Toma nota de la dirección del extremo y el número de puerto que aparecen en CONNECTION_TYPE_READER en la sección endpoints:. Estos dos valores usados juntos son el extremo de lector de tu instancia.

Conéctate desde una VM de Compute Engine con valkey-cli

Puedes conectarte a la instancia de Memorystore para Valkey desde cualquier VM de Compute Engine que use la red autorizada de la instancia de Memorystore.

Para conectarte a la instancia, haz lo siguiente:

1. Si aún no tienes una VM de Compute Engine de Linux que use la red autorizada para tu instancia de Memorystore para Valkey, crea una y conéctate a ella siguiendo la Guía de inicio rápido para crear una VM de Linux.

2. Instala valkey-cli en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.

3. Consulta el extremo principal y de lector de tu instancia y toma nota de él.

4. Para conectarte al extremo principal de tu instancia, ejecuta el siguiente comando:

   valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
   

   Aquí:

   • PRIMARY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.

5. Después de conectarte al nodo principal, ingresa los siguientes comandos de Valkey:

   Escribe lo siguiente:

   PING
   

   Resultado:

   PONG
   

   Ingresa:

   SET HELLO WORLD
   

   Resultado:

   OK
   

   Ingrese:

   GET HELLO
   

   Resultado:

   "WORLD"
   

6. Para conectarte al extremo de lector de tu instancia, ejecuta el siguiente comando:

   valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
   

   Aquí:

   • READER_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.

7. Después de conectarte al nodo principal, ingresa los siguientes comandos de Valkey Get:

   Escribe lo siguiente:

   PING
   

   Resultado:

   PONG
   

   Ingrese:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Después de probar tu conexión con el nodo de Valkey, debes borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. Esto te ayuda a evitar que se generen cargos en tu cuenta de Facturación de Cloud.

Conéctate a una instancia con la encriptación en tránsito habilitada

En esta sección, se proporciona un ejemplo de cómo conectarse a una instancia de Memorystore para Valkey con el modo de clúster inhabilitado que tiene habilitada la encriptación en tránsito.

1. Si aún no tienes una VM de Compute Engine que use la misma red autorizada que la instancia de Valkey del paso anterior, crea una y conéctate a ella siguiendo la Guía de inicio rápido sobre el uso de una VM de Linux.

   1. Instala valkey-cli versión 6.0 o posterior en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.

2. Verifica el modo de la autoridad certificadora (AC) que usas para tu instancia.

   • Si el modo de AC es por instancia, instala los certificados de AC de tu instancia siguiendo las instrucciones en Instala certificados de AC en el cliente.

   • Si el modo de AC es compartido, entonces instala el paquete de certificados de la AC de tu instancia siguiendo las instrucciones en Instala el paquete de certificados de la AC en el cliente.

   • Si el modo de AC es administrado por el cliente, tus aplicaciones pueden conectarse a la instancia sin que tengas que descargar e instalar certificados de AC adicionales. Por lo tanto, puedes omitir este paso.

3. Consulta el extremo principal y de lector de tu instancia y toma nota de él.

4. Para conectarte al extremo principal de tu instancia, ejecuta el siguiente comando:

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

   Aquí:

   • PRIMARY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.

5. Para conectarte al extremo de lector de tu instancia, ejecuta el siguiente comando:

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

   Aquí:

   • READER_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que anotaste en el paso anterior.

6. Una vez que te conectes al nodo, ingresa algunos comandos de Valkey:

   Escribe lo siguiente:

   PING
   

   Resultado:

   PONG