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

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 la describe gcloud CLI 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
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 se indican en la sección endpoints: para la entrada connectionType: CONNECTION_TYPE_DISCOVERY. Estos dos valores combinados 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. 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 anótalo.

  4. Conéctate al extremo de detección de tu instancia ejecutando 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. Conéctate al nodo que desees ejecutando 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 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 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 la versión 6.0 o posterior de valkey-cli en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.
  2. Instala la autoridad certificada de tu instancia en la VM de Linux siguiendo las instrucciones que se indican en Instala autoridades certificadas en tu cliente.

  3. Consulta el extremo de detección de tu instancia y anótalo.

  4. Conéctate al extremo de detección de tu instancia ejecutando 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. Conéctate al nodo que desees ejecutando 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 el extremo de lectura de tu instancia

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

gcloud

Para ver el extremo principal y el extremo de lector de tu instancia, ejecuta la describeCLI de 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 se indican en CONNECTION_TYPE_PRIMARY en la sección endpoints:. Estos dos valores combinados son el extremo principal de tu instancia.

Extremo de lectura: Toma nota de la dirección del extremo y el número de puerto que se indican en CONNECTION_TYPE_READER en la sección endpoints:. Estos dos valores juntos son el extremo de lectura 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. Instala valkey-cli en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.

  3. Consulta el extremo principal y de lectura de tu instancia y anótalo.

  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. Conéctate al extremo de lectura de tu instancia ejecutando 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 apliquen cargos a tu cuenta de Facturación de Cloud.

Conéctate 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 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 la versión 6.0 o posterior de valkey-cli en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.
  2. Instala la autoridad certificada de tu instancia en la VM de Linux siguiendo las instrucciones que se indican en Instala autoridades certificadas en tu cliente.

  3. Consulta el extremo principal y de lectura de tu instancia y anótalo.

  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. Conéctate al extremo de lectura de tu instancia ejecutando 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