Esta página foi traduzida pela API Cloud Translation.

Associe-se a uma instância do Memorystore for Valkey

Esta página explica como estabelecer ligação a uma instância do Memorystore for Valkey.

Apoio técnico ao cliente

Para ver exemplos e orientações sobre que clientes de ligação usar, consulte os exemplos de código da biblioteca cliente. .

Acesso entre regiões

Pode aceder a uma instância do Memorystore for Valkey a partir de um cliente localizado numa região diferente daquela onde a instância está localizada.

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

Esta secção explica como estabelecer ligação a uma instância do Memorystore para Valkey com o modo de cluster ativado.

Veja o ponto final de descoberta da sua instância

Para ver o ponto final de deteção da sua instância, use as seguintes instruções:

gcloud

Para ver o ponto final de deteção da sua instância, execute a describeCLI gcloud, conforme explicado em ver informações da instância.

O resultado deve ser semelhante ao seguinte:

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

Tome nota do endereço do ponto final e do número da porta indicados na secção endpoints: para a entrada connectionType: CONNECTION_TYPE_DISCOVERY. Estes dois valores usados em conjunto são o ponto final de deteção da sua instância.

Ligue a partir de uma VM do Compute Engine através do valkey-cli

Pode estabelecer ligação à instância do Memorystore for Valkey a partir de qualquer VM do Compute Engine que use a rede autorizada da instância do Memorystore.

Para estabelecer ligação à instância:

Se ainda não tiver uma VM do Compute Engine Linux que use a rede autorizada para a sua instância do Memorystore for Valkey, crie uma e ligue-se a ela seguindo o Início rápido para criar uma VM Linux.
Instale o valkey-cli na VM do Compute Engine seguindo as instruções em Instale o Valkey.
Veja o ponto final de deteção da sua instância e tome nota do mesmo.
Ligue-se ao ponto final de deteção da sua instância executando o seguinte comando:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
Onde:
- DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Nota: o comutador -c é usado para ativar o modo de suporte de cluster valkey-cli. Se o parâmetro -c não for fornecido, quando tenta aceder a chaves de um fragmento diferente daquele ao qual tem ligação, ocorre um erro MOVED. No modo de suporte de cluster, o cliente é automaticamente religado ao endereço devolvido na resposta de erro.
Execute o comando CLUSTER SHARDS para ver a topologia do nó. Tome nota de um dos endereços IP e números de porta do nó.
Estabeleça ligação ao nó pretendido executando o seguinte comando:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
Substitua o seguinte:
- NODE_IP_ADDRESS é o endereço IP do nó que encontrou no passo anterior.
- NODE_PORT é o número da porta do nó que encontrou no passo anterior.
Depois de estabelecer ligação ao nó, introduza alguns comandos do Valkey:

Introduza:
```
PING
```
Resultado:
```
PONG
```
Enter
```
SET HELLO WORLD
```
Resultado:
```
OK
```
Introduza:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Quando terminar de testar a ligação ao nó do Valkey, deve considerar eliminar a VM do Compute Engine que usou para se ligar à instância do Valkey. Desta forma, evita incorrer em cobranças na sua conta de faturação do Google Cloud.

Estabeleça ligação a uma instância com encriptação em trânsito ativada

Esta secção fornece um exemplo de como estabelecer ligação a uma instância do Memorystore for Valkey com o modo de cluster ativado que tem a encriptação em trânsito ativada.

Se ainda não tiver uma VM do Compute Engine que use a mesma rede autorizada que a instância do Valkey do passo anterior, crie uma e ligue-se a ela seguindo o Início rápido com uma VM Linux.
1. Instale a valkey-cli versão 6.0 ou mais recente na VM do Compute Engine seguindo as instruções em Instale o Valkey.
Instale a autoridade de certificação da sua instância na VM Linux seguindo as instruções em Instale autoridades de certificação no seu cliente.
Veja o ponto final de deteção da sua instância e tome nota do mesmo.
Ligue-se ao ponto final de deteção da sua instância executando o seguinte comando:
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
Onde:
- DISCOVERY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Nota: o comutador -c é usado para ativar o modo de suporte de cluster valkey-cli. Se o parâmetro -c não for fornecido, quando tenta aceder a chaves de um fragmento diferente daquele ao qual tem ligação, ocorre um erro MOVED. No modo de suporte de cluster, o cliente é automaticamente religado ao endereço devolvido na resposta de erro.
Execute o comando CLUSTER SHARDS para ver a topologia do nó. Tome nota de um dos endereços IP e números de porta do nó.
Estabeleça ligação ao nó pretendido executando o seguinte comando:
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
Substitua o seguinte:
- NODE_IP_ADDRESS é o endereço IP do nó que encontrou no passo anterior.
- NODE_PORT é o número da porta do nó que encontrou no passo anterior.
Depois de se ligar ao nó, introduza os seguintes comandos Valkey:

Introduza:
```
PING
```
Resultado:
```
PONG
```

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

Esta secção explica como estabelecer ligação a uma instância do Memorystore para Valkey com o modo de cluster desativado.

Veja o ponto final principal e de leitura da sua instância

Para ver o ponto final principal e de leitor da sua instância, siga estas instruções:

gcloud

Para ver o ponto final principal e de leitura da sua instância, execute a describeCLI gcloud, conforme explicado em ver informações da instância.

O resultado deve ser semelhante ao seguinte:

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

Ponto final principal: tome nota do endereço do ponto final e do número da porta indicados em CONNECTION_TYPE_PRIMARY na secção endpoints:. Estes dois valores usados em conjunto são o ponto final principal da sua instância.

Ponto final do leitor: tome nota do endereço do ponto final e do número da porta indicados em CONNECTION_TYPE_READER na secção endpoints:. Estes dois valores usados em conjunto são o ponto final do leitor da sua instância.

Ligue a partir de uma VM do Compute Engine através do valkey-cli

Pode estabelecer ligação à instância do Memorystore for Valkey a partir de qualquer VM do Compute Engine que use a rede autorizada da instância do Memorystore.

Para estabelecer ligação à instância:

Se ainda não tiver uma VM do Compute Engine Linux que use a rede autorizada para a sua instância do Memorystore for Valkey, crie uma e ligue-se a ela seguindo o Início rápido para criar uma VM Linux.
Instale o valkey-cli na VM do Compute Engine seguindo as instruções em Instale o Valkey.
Veja o ponto final principal e de leitura da sua instância e tome nota.
Ligue-se ao ponto final principal da sua instância executando o seguinte comando:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Onde:
- PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Depois de se ligar ao nó principal, introduza os seguintes comandos Valkey:

Introduza:
```
PING
```
Resultado:
```
PONG
```
Enter
```
SET HELLO WORLD
```
Resultado:
```
OK
```
Introduza:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Ligue-se ao ponto final do leitor da sua instância executando o seguinte comando:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
```
Onde:
- READER_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Depois de se ligar ao nó principal, introduza os seguintes comandos Valkey Get:

Introduza:
```
PING
```
Resultado:
```
PONG
```
Introduza:
```
GET HELLO
```
Resultado:
```
"WORLD"
```
Depois de testar a ligação ao nó Valkey, deve eliminar a VM do Compute Engine que usou para se ligar à instância do Valkey. Isto ajuda a evitar incorrer em custos na sua conta de faturação do Google Cloud.

Estabeleça ligação a uma instância com encriptação em trânsito ativada

Esta secção fornece um exemplo de como estabelecer ligação a uma instância do Memorystore for Valkey com o modo de cluster desativado que tem a encriptação em trânsito ativada.

Se ainda não tiver uma VM do Compute Engine que use a mesma rede autorizada que a instância do Valkey do passo anterior, crie uma e ligue-se a ela seguindo o Início rápido com uma VM Linux.
1. Instale a valkey-cli versão 6.0 ou mais recente na VM do Compute Engine seguindo as instruções em Instale o Valkey.
Instale a autoridade de certificação da sua instância na VM Linux seguindo as instruções em Instale autoridades de certificação no seu cliente.
Veja o ponto final principal e de leitura da sua instância e tome nota.
Ligue-se ao ponto final principal da sua instância executando o seguinte comando:
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Onde:
- PRIMARY_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Ligue-se ao ponto final do leitor da sua instância executando o seguinte comando:
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
Onde:
- READER_ENDPOINT_ADDRESS e PORT_NUMBER são os valores que anotou no passo anterior.
Depois de estabelecer ligação ao nó, introduza alguns comandos do Valkey:

Introduza:
```
PING
```
Resultado:
```
PONG
```

Associe-se a uma instância do Memorystore for Valkey Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Apoio técnico ao cliente

Acesso entre regiões

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

Veja o ponto final de descoberta da sua instância

gcloud

Ligue a partir de uma VM do Compute Engine através do valkey-cli

Estabeleça ligação a uma instância com encriptação em trânsito ativada

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

Veja o ponto final principal e de leitura da sua instância

gcloud

Ligue a partir de uma VM do Compute Engine através do valkey-cli

Estabeleça ligação a uma instância com encriptação em trânsito ativada

Associe-se a uma instância do Memorystore for Valkey