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

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.

Cómo ver el extremo de detección de tu instancia

Para ver el extremo de detección de tu instancia, sigue estas instrucciones:

gcloud

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

El resultado debería ser similar al siguiente ejemplo:

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

Anota la dirección del extremo y el número de puerto que aparecen en la sección discovery_endpoints:. Estos dos valores 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, sigue estos pasos:

  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. Para instalar valkey-cli en la VM de Compute Engine, sigue las instrucciones que se indican en Cómo instalar Valkey.

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

  4. Ejecuta el siguiente comando para conectarte al extremo de detección de tu instancia:

    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.

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

  6. Ejecuta el siguiente comando para conectarte al nodo que desees:

    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.

Cómo conectarse a una instancia habilitada para la encriptación en tránsito

En esta sección, se proporciona un ejemplo de cómo conectarse a una instancia de Memorystore para Valkey 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 mediante los siguientes pasos: Guía de inicio rápido para usar una VM de Linux.

    1. Instala valkey-cli versión 6.0 o posterior en la VM de Compute Engine. Para ello, sigue las instrucciones que se indican en Cómo instalar Valkey.

  2. Instala la autoridad certificadora de tu instancia en la VM de Linux. Para ello, sigue las instrucciones que se indican en Cómo instalar autoridades certificadoras en tu cliente.

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

  4. Ejecuta el siguiente comando para conectarte al extremo de detección de tu instancia:

    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.

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

  6. Ejecuta el siguiente comando para conectarte al nodo que desees:

    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. Una vez que te conectes al nodo, ingresa algunos comandos de Valkey:

    Escribe lo siguiente:

    PING

    Resultado:

    PONG