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.

Asistencia al cliente

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

Permite puertos en tu firewall

Si no permites los puertos correctos en tu firewall, es posible que tu instancia encuentre errores de conexión porque el firewall podría bloquear los puertos que usa Memorystore para Valkey.

Para todos los extremos de Private Service Connect de tu instancia, debes permitir el puerto TCP 6379, así como los puertos TCP del 11000 al 13047. Para obtener más información, consulta Soluciona problemas.

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.

Visualiza el extremo de descubrimiento de tu instancia

Cada instancia con el modo de clúster habilitado tiene un extremo de descubrimiento 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 descubrimiento de una instancia de Memorystore para Valkey con la Google Cloud consola o la CLI de gcloud.

Importante: Además del extremo de descubrimiento, cada instancia con el modo de clúster habilitado tiene un extremo de datos. Este extremo está reservado para que Memorystore for 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 descubrimiento de tu instancia, ejecuta la gcloud CLI describe como se explica en Visualiza 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 en conjunto son el extremo de descubrimiento 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. Visualiza el extremo de descubrimiento de tu instancia y toma nota de él.

4. Para conectarte al extremo de descubrimiento 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:

   Ingresa:

   PING
   

   Resultado:

   PONG
   

   Ingresa:

   SET HELLO WORLD
   

   Resultado:

   OK
   

   Ingrese:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Una vez que termines de probar tu conexión al nodo de Valkey, debes borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. De esta manera, se ayuda a evitar que se apliquen cargos a 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. Visualiza el extremo de descubrimiento de tu instancia y toma nota de la dirección IP y el número de puerto del extremo.

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

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

   Reemplaza lo siguiente:

   • DISCOVERY_ENDPOINT_ADDRESS: la dirección IP del extremo de descubrimiento que anotaste en el paso anterior
   • PORT_NUMBER: el número de puerto que anotaste en el paso anterior

   Para habilitar el modo de compatibilidad con valkey-cli, usa el modificador -c. Si no proporcionas este modificador, cuando intentes acceder a claves de un fragmento diferente al que estás conectado, la instancia mostrará un error MOVED. Sin embargo, si usas el modificador, el cliente se vuelve a conectar automáticamente a la dirección que se proporciona en la respuesta de error.

   Si habilitas la autenticación de Identity and Access Management (IAM) o la autenticación básica basada en tokens en la instancia, debes proporcionar credenciales de autenticación junto con las marcas de seguridad de la capa de transporte (TLS). Por ejemplo:

   valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN
   

   Reemplaza lo siguiente:

   • USERNAME: el nombre de usuario de la instancia
   • TOKEN: el token de autenticación

   Para obtener más información sobre cómo generar o administrar tus credenciales de autenticación, consulta Administra la autenticación de IAM y Protege el acceso a tus instancias con la autenticación básica basada en tokens.

5. Ejecuta el comando CLUSTER SHARDS para ver la topología de tu nodo. Toma nota de la dirección IP y el número de puerto de uno de los nodos.

6. Para conectarte al nodo, 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: la dirección IP del nodo que anotaste en el paso anterior.
   • NODE_PORT: el número de puerto del nodo que anotaste en el paso anterior.

   Si tu clúster usa la autenticación de IAM o la autenticación básica basada en tokens, asegúrate de incluir las marcas --user y -a, como lo hiciste en el paso del extremo de descubrimiento.

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

   Ingresa:

   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.

Visualiza 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 Visualiza 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 en conjunto 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 en conjunto 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. Visualiza 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:

   Ingresa:

   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:

   Ingresa:

   PING
   

   Resultado:

   PONG
   

   Ingrese:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Después de probar tu conexión al nodo de Valkey, debes borrar la VM de Compute Engine que usaste para conectarte a la instancia de Valkey. De esta manera, se ayuda a evitar que se apliquen cargos a 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 la AC de tu instancia siguiendo las instrucciones en Instala certificados de la 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 la AC adicionales. Por lo tanto, puedes omitir este paso.

3. Visualiza los extremos principal y de lector de tu instancia y toma nota de la dirección IP y el número de puerto de cada extremo.

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
   

   Reemplaza lo siguiente:

   • PRIMARY_ENDPOINT_ADDRESS: la dirección IP del extremo principal que anotaste en el paso anterior
   • PORT_NUMBER: el número de puerto de este extremo 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
   

   Reemplaza lo siguiente:

   • READER_ENDPOINT_ADDRESS: la dirección IP del extremo de lector que anotaste
   • PORT_NUMBER: el número de puerto de este extremo que anotaste

   Si habilitas la autenticación de IAM o la autenticación básica basada en tokens en la instancia, debes proporcionar credenciales de autenticación junto con las marcas de TLS para los extremos principal y de lector.

   Por ejemplo:

   valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN
   

   y

   valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls --cacert /tmp/server_ca.pem --user USERNAME -a TOKEN
   

   Reemplaza lo siguiente:

   • USERNAME: el nombre de usuario de la instancia
   • TOKEN: el token de autenticación

   Para obtener más información sobre cómo generar o administrar tus credenciales de autenticación, consulta Administra la autenticación de IAM y Protege el acceso a tus instancias con la autenticación básica basada en tokens.

6. Después de conectarte al nodo, ingresa algunos comandos de Valkey:

   Ingresa:

   PING
   

   Resultado:

   PONG