Esta página descreve como se conectar à instância do Redis usando Telnet e
redis-cli
. Além disso, nesta página você verá instruções sobre como se conectar ao usar recursos como réplicas de leitura, AUTH e criptografia em trânsito.
Por fim, nesta página, fornecemos instruções sobre como se conectar em um ambiente do Google Kubernetes Engine.
Para uma lista dos ambientes do Google Cloud compatíveis com o Memorystore para Redis, consulte Ambientes compatíveis. Alguns ambientes sem servidor compatíveis com o Memorystore exigem um conector de acesso VPC sem servidor. Consulte Requisitos do conector de acesso VPC sem servidor para mais detalhes.
Como se conectar a uma instância do Redis a partir de uma VM do Compute Engine usando telnet
É possível se conectar à instância do Redis de qualquer VM do Compute Engine que use a rede autorizada da instância do Redis usando um endereço IP RFC 1918 compatível.
Se você ainda não tem uma VM do Compute Engine que usa a mesma rede autorizada que sua instância do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.
Instale
telnet
usandoapt-get
:sudo apt-get install telnet
A partir do terminal, use o telnet para acessar o endereço IP da instância do Redis, substituindo variables pelos valores apropriados.
telnet instance-ip-address 6379
Se for bem-sucedido, o comando retornará este resultado:
Trying instance-ip-address… Connected to instance-ip-address
Na sessão telnet, digite alguns comandos do Redis:
Insira:
PING
Result:
PONG
Enter
SET HELLO WORLD
Result:
+OK
Insira o seguinte:
GET HELLO
Result:
$5 WORLD
Como se conectar a uma instância do Redis a partir de uma VM do Compute Engine usando redis-cli
É possível se conectar à instância do Redis de qualquer VM do Compute Engine que use a rede autorizada da instância do Redis usando um endereço IP RFC 1918 compatível.
Se você ainda não tem uma VM do Compute Engine que usa a rede autorizada para sua instância do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.
Instale
redis-cli
na VM do Compute Engine executando o seguinte comando no terminal SSH do Compute Engine:sudo apt-get install redis-tools
Execute o seguinte comando no terminal do Compute Engine, substituindo variables pelos valores apropriados.
redis-cli -h redis-instance-ip-address
Agora você está conectado à instância do Redis usando
redis-cli
.Após concluir o teste de conexão com a instância do Redis, exclua a VM do Compute Engine usada para se conectar à instância do Redis. Isso ajuda a evitar cobranças na sua conta do Cloud Billing.
Como se conectar a uma instância do Redis que usa o AUTH
Nesta seção, descrevemos como se conectar a uma instância do Redis que tem o recurso AUTH ativado.
Se você ainda não tem uma VM do Compute Engine que use a mesma rede autorizada da instância do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.
Instale
redis-cli
na VM do Compute Engine executando o seguinte comando no terminal SSH do Compute Engine:sudo apt-get install redis-tools
Consiga a string AUTH de sua instância
Execute o seguinte comando e use
redis-cli
para autenticar e se conectar à instância, substituindo variables pelos valores apropriados:redis-cli -h instance-ip-address -a auth-string
Ou:
redis-cli -h instance-ip-address AUTH auth-string
Execute os comandos
SET
eGET
do Redis para verificar se você estabeleceu uma conexão autenticada com a instância.Após concluir o teste de conexão com a instância do Redis, exclua a VM do Compute Engine usada para se conectar à instância do Redis. Isso ajuda a evitar cobranças na sua conta do Cloud Billing.
Como se conectar a uma instância do Redis usando o endpoint de leitura
Se a instância tiver réplicas de leitura ativadas, será possível se conectar ao endpoint de leitura usando as seguintes instruções:
Se você ainda não tem uma VM do Compute Engine que usa a mesma rede autorizada que sua instância do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.
Instale
telnet
usandoapt-get
:sudo apt-get install telnet
Encontre o endereço IP do endpoint de leitura da sua instância em Como ver as informações de réplica de leitura da instância.
Do terminal, o telnet para o endereço IP do endpoint de leitura da instância do Redis, substituindo variables pelos valores apropriados.
telnet read-endpoint-ip 6379
Se for bem-sucedido, o comando retornará este resultado:
Trying read-endpoint-ip… Connected to read-endpoint-ip
Na sessão telnet, digite alguns comandos do Redis:
Insira:
PING
Result:
PONG
Como se conectar a uma instância do Redis com segurança usando stunnel e telnet
Nesta seção, você verá um exemplo de como se conectar a uma instância do Redis com criptografia em trânsito ativada usando o stunnel.
Se você ainda não tem uma instância do Redis com a criptografia em trânsito ativada, siga estas etapas para Criar uma instância do Redis com criptografia em trânsito.
Se você ainda não tem uma VM do Compute Engine que use a mesma rede autorizada da instância anterior do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.
Instale as ferramentas necessárias para este guia executando os seguintes comandos:
sudo apt-get install stunnel4
sudo apt-get install telnet
Configure a VM do Compute Engine para uso com o stunnel:
Crie um novo arquivo para colocar a Autoridade de certificação (CA, na sigla em inglês) executando o seguinte comando:
sudo vim /tmp/server_ca.pem
Visualize as autoridades de certificação da instância do Redis executando o seguinte comando no terminal padrão que você usa para gerenciar os recursos do Google Cloud, e não o terminal do Compute Engine:
gcloud redis instances describe instance-id --region=region
Pode haver até três CAs.
Copie todas as autoridades de certificação visíveis, incluindo a linha
-----BEGIN CERTIFICATE-----
e as linhas-----END CERTIFICATE-----
, e cole e salve o arquivoserver_ca.pem
criado anteriormente.Faça o seguinte comando para colocar as informações de configuração do stunnel executando o seguinte comando:
sudo vim /etc/stunnel/redis-client.conf
Cole o seguinte texto no arquivo, substituindo redis-instance-ip pelo endereço IP da instância do Redis:
output=/tmp/stunnel.log CAfile=/tmp/server_ca.pem client=yes pid=/var/run/stunnel.pid verifyChain=yes sslVersion=TLSv1.2 [redis] accept=127.0.0.1:6378 connect=redis-instance-ip:6378
Inicie o stunnel executando o seguinte comando:
sudo stunnel /etc/stunnel/redis-client.conf
Verifique se o stunnel é executado:
ps aux | grep stunnel
Reinicie o stunnel executando os seguintes comandos:
sudo systemctl restart stunnel4
Para se conectar à instância do Redis usando o Telnet, execute o seguinte comando:
telnet localhost 6378
Na sessão Telnet, dê um ping na instância do Redis:
Insira:
PING
Result:
PONG
Como se conectar de uma máquina local com encaminhamento de portas
Pode ser útil se conectar à instância do Redis da máquina local durante o desenvolvimento. Para fazer isso, você precisa criar uma instância do Compute Engine para usar no encaminhamento de portas para a instância do Redis.
Crie uma instância do Compute Engine executando o comando a seguir:
gcloud compute instances create NAME --machine-type=f1-micro --zone=ZONE
Em que:
- NAME é o nome que você designa para a VM do Compute Engine.
- ZONE é a zona em que você quer provisionar a VM.
Esse comando cria uma VM do Compute Engine com o tipo de máquina
f1-micro
para economia. É possível escolher outros tipos de máquina, se quiser.Abra um novo terminal na máquina local.
Para criar um túnel SSH que encaminha o tráfego usando da VM do Compute Engine, execute o seguinte comando:
gcloud compute ssh COMPUTE_VM_NAME --zone=ZONE -- -N -L 6379:REDIS_INSTANCE_IP_ADDRESS:6379
Em que:
- COMPUTE_VM_NAME é o nome da VM do Compute Engine.
- ZONE é a mesma zona em que a VM do Compute Engine está localizada.
- REDIS_INSTANCE_IP_ADDRESS é o endereço IP da instância do Redis.
Para testar a conexão, abra uma nova janela de terminal e execute o seguinte comando:
redis-cli ping
Se estiver funcionando corretamente, o resultado retornará:
PONG
Agora você está conectado à instância do Redis e pode enviar comandos para a instância usando esse túnel SSH aberto. Se você ainda não instalou o
redis-cli
, instale-o para executar este comando.O túnel SSH permanece aberto enquanto você mantém a janela do terminal com a conexão do túnel SSH em funcionamento.
Como se conectar a uma instância do Redis a partir de um cluster do Google Kubernetes Engine
É possível se conectar à sua instância do Redis a partir de clusters do Google Kubernetes Engine que usam a mesma rede autorizada que a instância do Redis.
Como se conectar a partir de um pod, executando um shell bash
- Acesse a página do GKE no Console do Google Cloud.
GKE - Clique no cluster do GKE em que você gostaria de se conectar. Se você ainda não tiver um cluster, crie um com aliases de IP ativados. Para instruções sobre como criar um cluster com aliases de IP ativados, consulte Como criar um cluster nativo de VPC.
- Clique no botão Conectar, à direita do nome do cluster e, em seguida, clique no botão Executar no Cloud Shell, na janela que aparece.
- Configure o acesso à linha de comando
kubectl
executando o comando a seguir:gcloud container clusters get-credentials CLUSTER_NAME --zone=CLUSTER_ZONE --project=PROJECT_ID
CLUSTER_NAME
é o nome do cluster;CLUSTER_ZONE
é a zona em que o cluster está. É preciso que seja também a zona em que está a instância do Redis.PROJECT_ID
é o projeto em que estão o cluster e as instâncias do Redis.
kubeconfig generated for CLUSTER_NAME
- Se a versão do seu cluster for 1.8 ou superior e tiver aliases de IP ativados, pule esta etapa. Se a versão do seu cluster for 1.7 ou inferior, ou se o cluster da versão 1.8 ou superior não tiver aliases de IP ativados, siga estas etapas de solução alternativa, antes de tentar se conectar à sua instância: Como criar um cluster nativo de VPC. Para mais informações sobre aliases de IP, incluindo como criar um cluster com essa configuração ativada, consulte
- Use o seguinte comando para se conectar a um shell bash:
kubectl run -i --tty busybox --image=busybox -- sh
- Use o Telnet para a instância do Redis usando o endereço do host e o número da porta:
telnet HOST-IP PORT
- Digite um comando básico do Redis para verificar a conexão:
PING +PONG
- Para fechar a conexão telnet, pressione Control+C (ou Command+C no Mac). Para sair do shell bash no seu pod, insira "return". Se você tiver terminado e não precisar mais se conectar ao Redis, execute o seguinte comando no diretório
/k8s-custom-iptables/
:./uninstall.sh
Como se conectar a uma instância do Redis a partir de um pod do Google Kubernetes Engine
Antes de começar, é preciso ter um cluster do GKE. Se você ainda não tem um cluster, crie um com aliases de IP ativados. Para instruções sobre como criar um cluster com aliases de IP ativados, consulte Como criar um cluster nativo de VPC.
- No canto superior direito do console, clique no botão Ativar o Google Cloud Shell .
- Configure o acesso à linha de comando
kubectl
executando o comando a seguir:gcloud container clusters get-credentials CLUSTER_NAME --zone CLUSTER_ZONE --project PROJECT_ID
CLUSTER_NAME
é o nome do cluster;CLUSTER_ZONE
é a zona em que o cluster está. É preciso que seja também a zona em que está a instância do Redis.PROJECT_ID
é o projeto em que estão o cluster e as instâncias do Redis.
kubeconfig generated for CLUSTER_NAME
- Se a versão do seu cluster for 1.8 ou superior e tiver aliases de IP ativados, pule esta etapa. Se a versão do seu cluster for 1.7 ou inferior, ou se o cluster da versão 1.8 ou superior não tiver aliases de IP ativados, siga estas etapas de solução alternativa, antes de tentar se conectar à sua instância: Como criar um cluster nativo de VPC. Para mais informações sobre aliases de IP, incluindo como criar um cluster com essa configuração ativada, consulte
- Use o seguinte comando para iniciar um pod do Redis executando
redis-cli
:kubectl run -i --tty redisbox --image=gcr.io/google_containers/redis:v1 -- sh
- Execute um comando
redis-cli
, substituindoHOST-IP
pelo endereço IP do host da instância do Redis:redis-cli -h HOST-IP info
- Outra opção é executar um comando Redis benchmark, substituindo
HOST-IP
novamente pelo endereço IP do host da instância do Redis:redis-benchmark -c 100 -n 100000 -d 1024 -r 100000 -t PING,SET,GET,INCR,LPUSH,RPUSH,LPOP,RPOP,SADD,SPOP,MSET -h HOST-IP -q
- Para sair do pod do Redis, digite
return
. Se você tiver terminado e não precisar mais se conectar ao Redis, execute o seguinte comando no diretório/k8s-custom-iptables/
:./uninstall.sh
A seguir
Conecte-se à sua instância do Redis usando um aplicativo de amostra, que é executado em:
- Compute Engine
- GKE
- Cloud Run
- Ambiente padrão do App Engine
- Ambiente flexível do App Engine
- Cloud Functions