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 es distinta de la región de ubicación de la instancia.

Visualiza el extremo de detección de tu instancia

Para ver el extremo de descubrimiento de tu instancia, sigue las siguientes instrucciones:

gcloud

Para ver el extremo de descubrimiento de tu instancia, ejecuta describe. gcloud CLI como se explica en Visualiza 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 para Linux que use red autorizada a tu instancia de Memorystore for Valkey, crea una y sigue 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. Visualiza el extremo de descubrimiento de tu instancia y anótala.

  4. Conéctate al extremo de descubrimiento de tu instancia con 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.
  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 deseas:

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

    Ingresa:

    GET HELLO
    

    Resultado:

    "WORLD"
    
  8. Una vez que termines de probar tu conexión al nodo de Valkey, deberías considera borrar la VM de Compute Engine que usaste para conectarte al 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 habilitada de encriptación en tránsito

En esta sección, se proporciona un ejemplo de cómo conectarse a Memorystore para Valkey que tenga habilitada la encriptación en tránsito.

  1. Si aún no tienes una VM de Compute Engine que use el mismo red autorizada como la instancia de Valkey del paso anterior, crea una y conectarte a ella siguiendo la 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 de la siguiente manera: 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. Conéctate al extremo de descubrimiento de tu instancia con 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.
  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 deseas:

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

    Escribe lo siguiente:

    PING
    

    Resultado:

    PONG