Conectar-se a uma instância do Memorystore para Valkey

Nesta página, explicamos como se conectar a uma instância do Memorystore para Valkey.

Suporte ao cliente

Para exemplos e orientações sobre quais clientes de conexão usar, consulte Exemplos de código da biblioteca de cliente. .

Acesso entre regiões

É possível acessar uma instância do Memorystore para Valkey de um cliente localizado em uma região diferente da instância.

Conectar-se a uma instância com o modo de cluster ativado

Nesta seção, explicamos como se conectar a uma instância do Memorystore para Valkey com o modo de cluster ativado.

Ver o endpoint de descoberta da instância

Cada instância com o modo de cluster ativado tem um endpoint de descoberta a que seu cliente se conecta. Esse endpoint é uma combinação de um endereço IP e um número de porta.

É possível conferir o endpoint de descoberta de uma instância do Memorystore para Valkey usando o console do Google Cloud ou a CLI gcloud.

Importante: além do endpoint de descoberta, cada instância com o modo de cluster ativado tem um endpoint de dados. Esse endpoint é reservado para o Memorystore for Valkey usar para conectar seu cliente a nós na instância. Portanto, não se conecte a esse endpoint diretamente.

gcloud

Para conferir o endpoint de descoberta da instância, execute a CLI gcloud describe conforme explicado em Acessar informações da instância.

A saída será semelhante a esta:

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

Anote o endereço do endpoint e o número da porta listados na seção endpoints: para a entrada connectionType: CONNECTION_TYPE_DISCOVERY. Esses dois valores usados juntos são o endpoint de descoberta da instância.

Conectar-se de uma VM do Compute Engine usando valkey-cli

É possível se conectar à instância do Memorystore para Valkey de qualquer VM do Compute Engine que use a rede autorizada da instância do Memorystore.

Para se conectar à instância:

1. Se você ainda não tem uma VM do Compute Engine para Linux que use a rede autorizada para sua instância do Memorystore para Valkey, crie uma e conecte-se a ela seguindo o Guia de início rápido para criar uma VM do Linux.

2. Instale o valkey-cli na VM do Compute Engine seguindo as instruções em Instalar o Valkey.

3. Confira o endpoint de descoberta da instância e anote-o.

4. Conecte-se ao endpoint de descoberta da instância executando o seguinte comando:

   valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
   

   Em que:

   • DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.
   Observação: a opção -c é usada para ativar o modo de suporte do cluster valkey-cli. Se a chave -c não for fornecida, ao tentar acessar chaves de um shard diferente daquele a que você está conectado, isso vai resultar em um erro MOVED. No modo de suporte a cluster, o cliente é reconectado automaticamente ao endereço retornado na resposta de erro.

5. Execute o comando CLUSTER SHARDS para ver a topologia do nó. Anote um dos endereços IP e números de porta do nó.

6. Conecte-se ao nó desejado executando o seguinte comando:

   valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
   

   Substitua:

   • NODE_IP_ADDRESS é o endereço IP do nó que você encontrou na etapa anterior.
   • NODE_PORT é o número da porta do nó que você encontrou na etapa anterior.

7. Depois de se conectar ao nó, insira alguns comandos do Valkey:

   Insira o seguinte:

   PING
   

   Result:

   PONG
   

   Enter

   SET HELLO WORLD
   

   Result:

   OK
   

   Insira o seguinte:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Depois de testar a conexão com o nó do Valkey, considere excluir a VM do Compute Engine usada para se conectar à instância do Valkey. Isso ajuda a evitar cobranças na sua conta do Cloud Billing.

Conectar-se a uma instância com a criptografia em trânsito ativada

Nesta seção, você vai encontrar um exemplo de como se conectar a uma instância do Memorystore para Valkey com o modo de cluster ativado e a criptografia em trânsito ativada.

1. Se você ainda não tem uma VM do Compute Engine que use a mesma rede autorizada da instância do Valkey da etapa anterior, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.

   1. Instale a versão 6.0 ou mais recente do valkey-cli na VM do Compute Engine seguindo as instruções em Instalar o Valkey.

2. Instale os certificados da autoridade de certificação (CA) da instância na VM do Linux seguindo as instruções em Instalar certificados de CA no cliente.

3. Confira o endpoint de descoberta da instância e anote-o.

4. Conecte-se ao endpoint de descoberta da instância executando o seguinte comando:

   valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
   

   Em que:

   • DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.
   Observação: a opção -c é usada para ativar o modo de suporte do cluster valkey-cli. Se a chave -c não for fornecida, ao tentar acessar chaves de um shard diferente daquele a que você está conectado, isso vai resultar em um erro MOVED. No modo de suporte a cluster, o cliente é reconectado automaticamente ao endereço retornado na resposta de erro.

5. Execute o comando CLUSTER SHARDS para ver a topologia do nó. Anote um dos endereços IP e números de porta do nó.

6. Conecte-se ao nó desejado executando o seguinte comando:

   valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
   

   Substitua:

   • NODE_IP_ADDRESS é o endereço IP do nó que você encontrou na etapa anterior.
   • NODE_PORT é o número da porta do nó que você encontrou na etapa anterior.

7. Depois de se conectar ao nó, insira os seguintes comandos do Valkey:

   Insira o seguinte:

   PING
   

   Resultado:

   PONG
   

Conectar-se a uma instância com o modo de cluster desativado

Nesta seção, explicamos como se conectar a uma instância do Memorystore for Valkey com o modo de cluster desativado.

Ver o endpoint principal e de leitura da instância

Para conferir o endpoint principal e de leitura da instância, siga estas instruções:

gcloud

Para conferir o endpoint principal e de leitura da instância, execute a CLI gcloud describe, conforme explicado em Visualizar informações da instância.

A saída será semelhante a esta:

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:anote o endereço do endpoint e o número da porta listados em CONNECTION_TYPE_PRIMARY na seção endpoints:. Esses dois valores usados juntos são o endpoint principal da sua instância.

Endpoint de leitura:anote o endereço do endpoint e o número da porta listados em CONNECTION_TYPE_READER na seção endpoints:. Esses dois valores usados juntos são o endpoint de leitura da instância.

Conectar-se de uma VM do Compute Engine usando valkey-cli

É possível se conectar à instância do Memorystore para Valkey de qualquer VM do Compute Engine que use a rede autorizada da instância do Memorystore.

Para se conectar à instância:

1. Se você ainda não tem uma VM do Compute Engine para Linux que use a rede autorizada para sua instância do Memorystore para Valkey, crie uma e conecte-se a ela seguindo o Guia de início rápido para criar uma VM do Linux.

2. Instale o valkey-cli na VM do Compute Engine seguindo as instruções em Instalar o Valkey.

3. Confira e anote o endpoint principal e de leitura da instância.

4. Conecte-se ao endpoint principal da instância executando o seguinte comando:

   valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
   

   Em que:

   • PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.

5. Depois de se conectar ao nó principal, insira os seguintes comandos do Valkey:

   Insira o seguinte:

   PING
   

   Result:

   PONG
   

   Enter

   SET HELLO WORLD
   

   Result:

   OK
   

   Insira o seguinte:

   GET HELLO
   

   Resultado:

   "WORLD"
   

6. Execute o comando a seguir para se conectar ao endpoint de leitura da instância:

   valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
   

   Em que:

   • READER_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.

7. Depois de se conectar ao nó principal, insira os seguintes comandos Valkey Get:

   Insira o seguinte:

   PING
   

   Resultado:

   PONG
   

   Insira o seguinte:

   GET HELLO
   

   Resultado:

   "WORLD"
   

8. Depois de testar a conexão com o nó do Valkey, exclua a VM do Compute Engine usada para se conectar à instância do Valkey. Isso ajuda a evitar cobranças na sua conta do Cloud Billing.

Conectar-se a uma instância com a criptografia em trânsito ativada

Nesta seção, você vai encontrar um exemplo de como se conectar a uma instância do Memorystore para Valkey com o modo de cluster desativado e a criptografia em trânsito ativada.

1. Se você ainda não tem uma VM do Compute Engine que use a mesma rede autorizada da instância do Valkey da etapa anterior, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.

   1. Instale a versão 6.0 ou mais recente do valkey-cli na VM do Compute Engine seguindo as instruções em Instalar o Valkey.

2. Verifique o modo de autoridade certificadora (CA) que você está usando na sua instância.

   • Se o modo de CA for por instância, instale os certificados de CA da instância seguindo as instruções em Instalar certificados de CA no cliente.

   • Se o modo de CA for compartilhado, siga as instruções em Instalar o pacote de certificados de CA no cliente para instalar o pacote de certificados de CA da sua instância.

   • Se o modo de AC for gerenciado pelo cliente, seus aplicativos poderão se conectar à instância sem que você precise baixar e instalar outros certificados de AC. Portanto, você pode pular esta etapa.

3. Confira e anote o endpoint principal e de leitura da instância.

4. Conecte-se ao endpoint principal da instância executando o seguinte comando:

   valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
   

   Em que:

   • PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.

5. Execute o comando a seguir para se conectar ao endpoint de leitura da instância:

   valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
   

   Em que:

   • READER_ENDPOINT_ADDRESS e PORT_NUMBER são os valores anotados na etapa anterior.

6. Depois de se conectar ao nó, insira alguns comandos do Valkey:

   Insira o seguinte:

   PING
   

   Resultado:

   PONG