Esta página se ha traducido con Cloud Translation API.

Conectarse a una instancia de Memorystore for Valkey

En esta página se explica cómo conectarse a una instancia de Memorystore para Valkey.

Asistencia al cliente

Para ver ejemplos y directrices sobre qué clientes de conexión usar, consulta Ejemplos de código de bibliotecas de cliente. .

Acceso entre regiones

Puedes acceder a una instancia de Memorystore para Valkey desde un cliente que se encuentre en una región distinta a la de la instancia.

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

Ver el endpoint de descubrimiento de una instancia

Para ver el endpoint de descubrimiento de tu instancia, sigue estas instrucciones:

gcloud

Para ver el endpoint de descubrimiento de tu instancia, ejecuta la herramienta de línea de comandos describe gcloud como se explica en Ver información de la instancia.

La salida debería ser similar a la siguiente:

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

Anota la dirección del endpoint y el número de puerto que aparecen en la sección endpoints: de la entrada connectionType: CONNECTION_TYPE_DISCOVERY. Estos dos valores, usados conjuntamente, son el endpoint de descubrimiento de tu instancia.

Conectarse desde una VM de Compute Engine mediante valkey-cli

Puedes conectarte a la instancia de Memorystore for 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:

Si aún no tienes una máquina virtual de Linux de Compute Engine que use la red autorizada de tu instancia de Memorystore para Valkey, crea una y conéctate a ella siguiendo la guía de inicio rápido para crear una máquina virtual de Linux.
Instala valkey-cli en la máquina virtual de Compute Engine siguiendo las instrucciones de Instalar Valkey.
Consulta el endpoint de descubrimiento de tu instancia y anótalo.
Para conectarte al endpoint de descubrimiento de tu instancia, ejecuta el siguiente comando:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
Donde:
- DISCOVERY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Nota: El interruptor -c se usa para habilitar el modo de asistencia de clústeres valkey-cli. Si no se proporciona el interruptor -c, cuando intentes acceder a las claves de un fragmento diferente al que estás conectado, se producirá un error MOVED. En el modo de asistencia de clúster, el cliente se vuelve a conectar automáticamente a la dirección devuelta en la respuesta de error.
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.
Conéctate al nodo que quieras ejecutando el siguiente comando:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
Haz los cambios siguientes:
- NODE_IP_ADDRESS es la dirección IP del nodo que has encontrado en el paso anterior.
- NODE_PORT es el número de puerto del nodo que has encontrado en el paso anterior.
Una vez que te hayas conectado al nodo, introduce algunos comandos de Valkey:

Introduce estos datos:
```
PING
```
Resultado:
```
PONG
```
Intro
```
SET HELLO WORLD
```
Resultado:
```
OK
```
Introduce estos datos:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Cuando hayas terminado de probar la conexión al nodo de Valkey, te recomendamos que elimines la VM de Compute Engine que has usado para conectarte a la instancia de Valkey. De esta forma, evitarás que se te apliquen cargos en tu cuenta de facturación de Cloud.

Conectarse a una instancia con el cifrado en tránsito habilitado

En esta sección se muestra un ejemplo de cómo conectarse a una instancia de Memorystore for Valkey con el modo clúster habilitado y el cifrado en tránsito habilitado.

Si aún no tienes una máquina virtual 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 con una máquina virtual de Linux.
1. Instala la versión valkey-cli 6.0 o posterior en la máquina virtual de Compute Engine siguiendo las instrucciones de Instalar Valkey.
Instala la autoridad de certificación de tu instancia en la VM Linux siguiendo las instrucciones de Instalar autoridades de certificación en el cliente.
Consulta el endpoint de descubrimiento de tu instancia y anótalo.
Para conectarte al endpoint 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
```
Donde:
- DISCOVERY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Nota: El interruptor -c se usa para habilitar el modo de asistencia de clústeres valkey-cli. Si no se proporciona el interruptor -c, cuando intentes acceder a las claves de un fragmento diferente al que estás conectado, se producirá un error MOVED. En el modo de asistencia de clúster, el cliente se vuelve a conectar automáticamente a la dirección devuelta en la respuesta de error.
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.
Conéctate al nodo que quieras ejecutando el siguiente comando:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
Haz los cambios siguientes:
- NODE_IP_ADDRESS es la dirección IP del nodo que has encontrado en el paso anterior.
- NODE_PORT es el número de puerto del nodo que has encontrado en el paso anterior.
Después de conectarte al nodo, introduce los siguientes comandos de Valkey:

Introduce estos datos:
```
PING
```
Resultado:
```
PONG
```

Conectarse a una instancia con el modo 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.

Ver el endpoint principal y de lectura de una instancia

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

gcloud

Para ver el endpoint principal y el endpoint de lectura de tu instancia, ejecuta la describe CLI de gcloud, tal como se explica en Ver información de la instancia.

La salida debería ser similar a la siguiente:

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

Endpoint principal: anota la dirección del endpoint y el número de puerto que se indican en CONNECTION_TYPE_PRIMARY en la sección endpoints:. Estos dos valores combinados son el endpoint principal de tu instancia.

Endpoint de lectura: anota la dirección del endpoint y el número de puerto que aparecen en CONNECTION_TYPE_READER en la sección endpoints:. Estos dos valores combinados son el endpoint de lectura de tu instancia.

Conectarse desde una VM de Compute Engine mediante valkey-cli

Puedes conectarte a la instancia de Memorystore for 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:

Si aún no tienes una máquina virtual de Linux de Compute Engine que use la red autorizada de tu instancia de Memorystore para Valkey, crea una y conéctate a ella siguiendo la guía de inicio rápido para crear una máquina virtual de Linux.
Instala valkey-cli en la máquina virtual de Compute Engine siguiendo las instrucciones de Instalar Valkey.
Consulta el endpoint principal y el de lectura de tu instancia y anótalo.
Para conectarte al endpoint principal de tu instancia, ejecuta el siguiente comando:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Donde:
- PRIMARY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Después de conectarte al nodo principal, introduce los siguientes comandos de Valkey:

Introduce estos datos:
```
PING
```
Resultado:
```
PONG
```
Intro
```
SET HELLO WORLD
```
Resultado:
```
OK
```
Introduce estos datos:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Conéctate al endpoint de lectura de tu instancia ejecutando el siguiente comando:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Donde:
- READER_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Después de conectarte al nodo principal, introduce los siguientes comandos de Valkey Get:

Introduce estos datos:
```
PING
```
Resultado:
```
PONG
```
Introduce estos datos:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Después de probar la conexión al nodo de Valkey, debes eliminar la VM de Compute Engine que has usado para conectarte a la instancia de Valkey. De esta forma, evitarás que se te apliquen cargos en tu cuenta de facturación de Cloud.

Conectarse a una instancia con el cifrado en tránsito habilitado

En esta sección se muestra un ejemplo de cómo conectarse a una instancia de Memorystore for Valkey con el modo clúster inhabilitado y el cifrado en tránsito habilitado.

Si aún no tienes una máquina virtual 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 con una máquina virtual de Linux.
1. Instala la versión valkey-cli 6.0 o posterior en la máquina virtual de Compute Engine siguiendo las instrucciones de Instalar Valkey.
Instala la autoridad de certificación de tu instancia en la VM Linux siguiendo las instrucciones de Instalar autoridades de certificación en el cliente.
Consulta el endpoint principal y el de lectura de tu instancia y anótalo.
Para conectarte al endpoint principal de tu instancia, ejecuta el siguiente comando:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Donde:
- PRIMARY_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Conéctate al endpoint de lectura de tu instancia ejecutando el siguiente comando:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Donde:
- READER_ENDPOINT_ADDRESS y PORT_NUMBER son los valores que has anotado en el paso anterior.
Una vez que te hayas conectado al nodo, introduce algunos comandos de Valkey:

Introduce estos datos:
```
PING
```
Resultado:
```
PONG
```

Conectarse a una instancia de Memorystore for Valkey Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Asistencia al cliente

Acceso entre regiones

Conectarse a una instancia con el modo de clúster habilitado

Ver el endpoint de descubrimiento de una instancia

gcloud

Conectarse desde una VM de Compute Engine mediante valkey-cli

Conectarse a una instancia con el cifrado en tránsito habilitado

Conectarse a una instancia con el modo Clúster inhabilitado

Ver el endpoint principal y de lectura de una instancia

gcloud

Conectarse desde una VM de Compute Engine mediante valkey-cli

Conectarse a una instancia con el cifrado en tránsito habilitado

Conectarse a una instancia de Memorystore for Valkey