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.

Conectar a uma instância com o modo cluster ativado

Esta seção explica como se conectar a uma instância do Memorystore para Valkey com o modo cluster ativado.

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 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
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 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, 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 criptografia em trânsito ativada

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

  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 os seguintes comandos do Valkey:

    Insira o seguinte:

    PING

    Resultado:

    PONG

Conectar a uma instância com o modo cluster desativado

Esta seção explica como se conectar a uma instância do Memorystore para Valkey com o modo cluster desativado.

Conferir o endpoint principal e de leitura da instância

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

gcloud

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

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

  4. Para se conectar ao endpoint principal da instância, execute 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. Conecte-se ao endpoint de leitura da instância executando o seguinte comando:

    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, digite 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ó 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 criptografia em trânsito ativada

Esta seção mostra 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 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 principal e de leitor da sua instância e anote-o.

  4. Para se conectar ao endpoint principal da instância, execute 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. Conecte-se ao endpoint de leitura da instância executando o seguinte comando:

    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ó, digite alguns comandos da Valkey:

    Insira o seguinte:

    PING

    Resultado:

    PONG