Como se conectar a uma instância do Memcached

Nesta página, explicamos como se conectar a uma instância do Memorystore para Memcached. É possível se conectar a instâncias do Memcached por instâncias de VM do Compute Engine, clusters do Google Kubernetes Engine, Cloud Functions, o ambiente flexível do App Engine e o ambiente padrão do App Engine.

Antes de acessar o Memorystore com o Cloud Functions, siga as instruções de configuração em Como se conectar a recursos internos em uma rede VPC.

Além disso, antes de acessar o Memorystore com o ambiente padrão do App Engine, siga as instruções de configuração em Como se conectar a recursos internos em uma rede VPC.

Como se conectar a uma instância do Memcached usando uma VM do Compute Engine

Para se conectar a uma instância do Memcached, uma instância de VM do Compute Engine precisa estar localizada no mesmo projeto e região, além de estar conectada à mesma rede ou rede VPC que a instância do Memcached.

Conecte-se a uma VM do Linux. Para conhecer as etapas de conexão com uma VM do Linux, consulte o Guia de início rápido sobre como usar uma VM do Linux. Se você usou uma imagem baseada em Debian para criar sua instância de VM, conforme descrito no guia de início rápido, instale telnet usando apt-get:
```
sudo apt-get install telnet
```
No terminal, use o telnet para o endereço IP de um dos nós do Memcached, substituindo variables pelos valores apropriados.
```
telnet node-ip-address 11211
```
Se isso funcionar corretamente, você verá a seguinte saída com o [bracketed-variables] substituído pelas variáveis do seu projeto:
```
Trying [node-ip-address]
Connected to [node-ip-address]
```
Na sessão de telnet, digite alguns comandos do Memcached:

Insira:
```
get greeting
```
Resultado:
```
END
```
Insira o seguinte:
```
set greeting 1 0 11
hello world
```
Resultado:
```
STORED
```
Insira o seguinte:
```
get greeting
```
Resultado:
```
VALUE greeting 1 11
hello world
END
```

O Memorystore para Memcached é compatível com bibliotecas padrão do Memcached de código aberto.

Como se conectar a uma instância do Memcached usando um cluster do Google Kubernetes Engine

É possível se conectar às instâncias do Memcached usando clusters do GKE que estão na mesma região e conectados à mesma rede da instância.

Acesse a página do Google Kubernetes Engine no console do Google Cloud:
Google Kubernetes Engine
Clique no cluster do GKE em que você gostaria de se conectar. Se você ainda não tiver um cluster, crie um na mesma zona e região que a instância do Memcached 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á. Essa também precisa ser a zona em que a instância do Memcached está localizada.
- project-id é o projeto em que o cluster e a instância do Memcached estão localizados;
Se o comando for bem-sucedido, será exibida a mensagem a seguir:
```
kubeconfig generated for cluster-name
```
Se não for exibida essa mensagem, verifique se você inseriu as informações corretas do cluster no comando.
Se a versão do seu cluster for 1.8 ou posterior 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:
Alternativa

Execute estes três comandos, substituindo reserved-ip-range pelo intervalo de IPs reservados da instância:
```
git clone https://github.com/bowei/k8s-custom-iptables.git
```
```
cd k8s-custom-iptables/
```
```
TARGETS="reserved-ip-range" ./install.sh
```
Observação: se você não souber o intervalo de IPs reservados da instância, execute o seguinte comando para descobrir:
```
gcloud memcache instances describe instance-id --region=region
```
Para mais informações sobre aliases de IP, incluindo como criar um cluster com essa configuração ativada, consulte Como criar um cluster nativo de VPC.
Use o seguinte comando para se conectar a um shell bash:
```
kubectl run -i --tty busybox --image=busybox -- sh
```
Telnet para a instância do Memcached usando um dos endereços IP do nó e o número de porta da instância:
```
telnet node-ip-address 11211
```
Na sessão de telnet, digite alguns comandos do Memcached:

Insira:
```
get greeting
```
Resultado:
```
END
```
Insira o seguinte:
```
set greeting 1 0 11
hello world
```
Resultado:
```
STORED
```
Insira o seguinte:
```
get greeting
```
Resultado:
```
VALUE greeting 1 11
hello world
END
```