Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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, funções do Cloud Run, o ambiente flexível do App Engine e o ambiente padrão do App Engine.
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:
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:
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
Use o Telnet para a instância do Memcached usando um dos endereços IP do nó e
o número da 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
O Memorystore para Memcached é compatível com bibliotecas padrão do Memcached de código aberto.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[],[],null,["# Connect to a Memcached instance\n\nThis page explains how to connect to a Memorystore for Memcached instance.\nYou can connect to Memcached instances from Compute Engine VM instances,\nGoogle Kubernetes Engine clusters, Cloud Run functions, the App Engine\nflexible environment, and the App Engine standard environment.\n\nBefore you can access Memorystore with Cloud Run functions, you\nneed follow the setup instructions at [Connecting to internal resources in a VPC network](/functions/docs/connecting-vpc#connecting_to_your_vpc_network).\n\nAlso, before you can access Memorystore with the App Engine\nstandard environment, you need to follow the setup instructions at [Connecting\nto internal resources in a VPC network](/appengine/docs/standard/python/connecting-vpc#creating_a_connector).\n| **Note:** You can use any open source Memcached client library to connect to Memorystore for Memcached.\n\nConnecting to a Memcached instance from a Compute Engine VM\n-----------------------------------------------------------\n\nIn order to connect to a Memcached instance, a Compute Engine VM instance must\nbe located within the same project and region, and must also be connected to the\nsame network or VPC network as the Memcached instance.\n\n1. Connect to a Linux VM. For steps to connect to a Linux VM, see [Quickstart Using a Linux VM](/compute/docs/create-linux-vm-instance).\n If you used a Debian based image to create your VM instance as described in the\n quickstart, install `telnet` using `apt-get`:\n\n ```\n sudo apt-get install telnet\n ```\n2. From the terminal, telnet to the IP address of one of the Memcached nodes,\n replacing \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values.\n\n ```\n telnet node-ip-address 11211\n ```\n\n If it works correctly, you should see the following output with the\n `[bracketed-variables]` replaced by your project's variables: \n\n ```\n Trying [node-ip-address]\n Connected to [node-ip-address]\n ```\n3. In the telnet session, enter some Memcached commands:\n\n Enter: \n\n ```\n get greeting\n ```\n\n Result: \n\n ```\n END\n ```\n\n Enter: \n\n ```\n set greeting 1 0 11\n hello world\n ```\n\n Result: \n\n ```\n STORED\n ```\n\n Enter: \n\n ```\n get greeting\n ```\n\n Result: \n\n ```\n VALUE greeting 1 11\n hello world\n END\n ```\n\nMemorystore for Memcached supports standard open source Memcached libraries.\n\nConnecting to a Memcached instance from a Google Kubernetes Engine cluster\n--------------------------------------------------------------------------\n\n| **Note:** You cannot connect to a Memorystore for Memcached instance from a Google Kubernetes Engine cluster without VPC-native/IP aliasing enabled. To verify if your instance has VPC-native/IP aliasing enabled, check your cluster's details page in the Google Cloud console. Alternatively, run [`gcloud container clusters describe`](/sdk/gcloud/reference/container/clusters/describe) and verify if `useIpAliases: true` is present. \n|\n| It is easiest to enable VPC-native/IP aliasing during cluster creation. When creating your cluster, select **VPC Native** under advanced options. For more details, see [Creating VPC-native clusters using Alias IPs](/kubernetes-engine/docs/how-to/alias-ips).\n\nYou can connect to your Memcached instances using GKE\nclusters that are in the same region and connected to the same network as your\ninstance.\n\n1. Go to the Google Kubernetes Engine page in the Google Cloud console.\n\n [Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list?)\n\n2. Click on the GKE cluster you'd like to connect from. If\n you don't already have a cluster, create one in the same zone and region as\n your Memcached instance with IP aliases enabled. For instructions on how to\n create a cluster with IP aliases enabled, see the [Creating a VPC-native cluster](/kubernetes-engine/docs/how-to/alias-ips#creating_a_new_cluster_with_ip_aliases).\n\n3. Click the **Connect** button to the right of your cluster's name, then click\n the **Run in Cloud Shell** button in the window that appears.\n\n4. Configure `kubectl` command line access by running the following command:\n\n ```\n gcloud container clusters get-credentials cluster-name --zone=cluster-zone --project=project-id\n ```\n - \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ecluster-name\u003c/code\u003e\u003c/var\u003e is the name of your cluster.\n\n - \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003ecluster-zone\u003c/code\u003e\u003c/var\u003e is the zone your cluster is in. This must also be\n the zone your Memcached instance is in.\n\n - \u003cvar translate=\"no\"\u003e\u003ccode translate=\"no\" dir=\"ltr\"\u003eproject-id\u003c/code\u003e\u003c/var\u003e is the project in which your cluster and your\n Memcached instance are located.\n\n If the command is successful, you should receive the following message: \n\n ```\n kubeconfig generated for cluster-name\n ```\n\n If you do not receive this message, make sure you entered the correct cluster\n information into the command.\n5. If your cluster is version 1.8 or higher **and** has IP aliases enabled, skip\n this step. If your cluster is version 1.7 or lower, or your version 1.8 or\n higher cluster doesn't have IP aliases enabled, follow these workaround steps\n before trying to connect to your instance:\n\n #### Workaround\n\n Run these three commands, replacing \u003cvar translate=\"no\"\u003ereserved-ip-range\u003c/var\u003e with the\n reserved IP range of your instance: \n\n ```\n git clone https://github.com/bowei/k8s-custom-iptables.git\n ``` \n\n ```\n cd k8s-custom-iptables/\n ``` \n\n ```\n TARGETS=\"reserved-ip-range\" ./install.sh\n ```\n Note: If you don't know the reserved IP range of your instance, you can find out by running the following command: \n\n ```\n gcloud memcache instances describe instance-id --region=region\n ```\n\n For more information about IP aliases, including how to create a cluster with this setting enabled, see [Creating a VPC-native cluster](/kubernetes-engine/docs/how-to/alias-ips#creating_a_new_cluster_with_ip_aliases).\n6. Use the following command to connect to a bash shell:\n\n ```\n kubectl run -i --tty busybox --image=busybox -- sh\n ```\n7. Telnet to your Memcached instance using one of your node's IP addresses and\n your instance's port number:\n\n ```\n telnet node-ip-address 11211\n ```\n8. In the telnet session, enter some Memcached commands:\n\n Enter: \n\n ```\n get greeting\n ```\n\n Result: \n\n ```\n END\n ```\n\n Enter: \n\n ```\n set greeting 1 0 11\n hello world\n ```\n\n Result: \n\n ```\n STORED\n ```\n\n Enter: \n\n ```\n get greeting\n ```\n\n Result: \n\n ```\n VALUE greeting 1 11\n hello world\n END\n ```\n\nMemorystore for Memcached supports standard open source Memcached libraries.\n\nWhat's next\n-----------\n\n- [Use the Auto Discovery service](/memorystore/docs/memcached/using-auto-discovery).\n- [Monitor your Memcached instances](/memorystore/docs/memcached/monitoring-instances)."]]
