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é conexión de clientes 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

Toma nota de la dirección del endpoint y del número de puerto que aparecen en el discovery_endpoints:. Estos dos valores juntos son tu el extremo de detección de la instancia.

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

Puedes conectarte a la instancia de Memorystore para Valkey desde cualquier una VM de Compute Engine que usa la puerta de enlace red autorizada.

Para conectarte a la instancia, haz lo siguiente:

  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. Instala valkey-cli en la VM de Compute Engine de la siguiente manera: siguiendo las instrucciones que se indican en Instala 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. Crear una nota de una de las direcciones IP y números de puerto del nodo.

  6. Ejecuta el siguiente comando para conectarte al nodo deseado:

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

    Ingrese:

    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 ayudará a evitar que se apliquen cargos 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 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 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. Crear una nota de una de las direcciones IP y números de puerto del nodo.

  6. Ejecuta el siguiente comando para conectarte al nodo deseado:

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

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

    Escribe lo siguiente:

    PING

    Resultado:

    PONG