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:
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.
Instala
valkey-cli
en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.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.
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 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.
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"
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.
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.
- Instala la versión 6.0 o posterior de
valkey-cli
en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.
- Instala la versión 6.0 o posterior de
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.
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.
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 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.
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 describe
CLI 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:
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.
Instala
valkey-cli
en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.Consulta el extremo principal y de lectura de tu instancia y anótalo.
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.
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"
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.
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"
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.
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.
- Instala la versión 6.0 o posterior de
valkey-cli
en la VM de Compute Engine siguiendo las instrucciones en Instala Valkey.
- Instala la versión 6.0 o posterior de
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.
Consulta el extremo principal y de lectura de tu instancia y anótalo.
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.
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.
Una vez que te conectes al nodo, ingresa algunos comandos de Valkey:
Escribe lo siguiente:
PING
Resultado:
PONG