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 Amostras 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 localização da instância.

Conferir o endpoint de descoberta da sua instância

Para conferir o endpoint de descoberta da sua instância, siga estas instruções:

gcloud

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

A saída será semelhante a esta:

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

Anote o endereço do endpoint e o número da porta listados na seção discovery_endpoints:. Esses dois valores usados juntos são o endpoint de descoberta da sua instância.

Conectar-se de uma VM do Compute Engine usando o 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 valkey-cli na VM do Compute Engine seguindo as instruções em Instalar Valkey.

  3. Acesse o endpoint de descoberta da sua instância e anote o endereç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.

  5. Execute o comando CLUSTER SHARDS para conferir 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ó encontrado na etapa anterior.
    • NODE_PORT é o número da porta do nó encontrado na etapa anterior.

  7. Depois de se conectar ao nó, digite alguns comandos da Valkey:

    Insira o seguinte:

    PING

    Result:

    PONG

    Enter

    SET HELLO WORLD

    Result:

    OK

    Insira o seguinte:

    GET HELLO

    Resultado:

    "WORLD"

  8. Após concluir o teste de conexão com o nó 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 criptografia em trânsito ativada

Esta seção mostra um exemplo de como se conectar a uma instância do Memorystore para Valkey com 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 Valkey.

  2. Instale a autoridade de certificação da sua instância na VM do Linux seguindo as instruções em Instalar autoridades de certificação no cliente.

  3. Acesse o endpoint de descoberta da sua instância e anote o endereç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.

  5. Execute o comando CLUSTER SHARDS para conferir 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ó encontrado na etapa anterior.
    • NODE_PORT é o número da porta do nó encontrado na etapa anterior.

  7. Depois de se conectar ao nó, digite alguns comandos da Valkey:

    Insira o seguinte:

    PING

    Resultado:

    PONG