Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Criar uma instância do Memorystore para Redis usando o Terraform
Nesta página, descrevemos como usar o Terraform para criar uma nova instância do Memorystore
para Redis. Ele também mostra como se conectar à instância usando o telnet.
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Tenha um arquivo do Terraform ao qual você possa adicionar o recurso Memorystore. Para
instruções sobre como configurar o Terraform com o Google Cloud, consulte Primeiros passos com o provedor do Google Cloud.
Como criar uma instância do Memorystore para Redis
O exemplo de recurso do Terraform a seguir cria uma instância do Redis de 2 GiB do nível básico
no us-central1 região no nível BASIC. Para mais informações
sobre esses níveis, consulte Níveis dos recursos do Redis.
Adicione o seguinte recurso ao seu arquivo de configuração do Terraform:
resource "google_redis_instance" "my_memorystore_redis_instance" {
name = "myinstance"
tier = "BASIC"
memory_size_gb = 2
region = "us-central1"
redis_version = "REDIS_6_X"
}
(Opcional): adicione o seguinte valor de saída
ao arquivo de configuração do Terraform para imprimir o endereço IP da instância do Redis, que será necessária posteriormente neste guia de início rápido:
output "host" {
description = "The IP address of the instance."
value = "${google_redis_instance.my_memorystore_redis_instance.host}"
}
Execute terraform init.
Execute terraform plan e revise o recurso a ser criado.
Execute terraform apply para iniciar a criação.
Como se conectar à instância do Redis a partir de uma VM do Compute Engine
Em seguida, conecte-se à instância do Redis recém-criada.
É 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.
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
Limpar
Para evitar cobranças na sua conta do Google Cloud pelos recursos usados
neste guia de início rápido, exclua a instância do Redis usando as etapas abaixo:
Remova o recurso google_redis_instance do arquivo de
configuração do Terraform.
Execute o Terraform init, plan e apply para destruir o recurso Redis.
Exclua as VMs do Compute Engine que você criou para este guia de início rápido.
[[["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-09-05 UTC."],[],[],null,["# Quickstart: Create a Memorystore for Redis instance by using Terraform\n\nCreate a Memorystore for Redis instance by using Terraform\n==========================================================\n\n| **Note:** If you are looking for the Memorystore for Redis Cluster documentation, see [Instance provisioning on a VPC network](/memorystore/docs/cluster/instance-provisioning-vpc).\n\nThis page describes how to use Terraform to create a new Memorystore for Redis\ninstance. It also shows you how to connect to the instance using telnet.\n\nThis quickstart uses the [Google Cloud Platform Provider](https://registry.terraform.io/providers/hashicorp/google/latest/docs)\nfor Terraform.\n\nBefore you begin\n----------------\n\n- Sign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n- In the Google Cloud console, on the project selector page,\n select or create a Google Cloud project.\n\n | **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n-\n [Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n1. If you haven't already, [install the Google Cloud SDK](/sdk/docs).\n\n When prompted, choose the project that you selected or created above.\n2. If you already have the Google Cloud SDK installed, update it.\n\n ```\n gcloud components update\n ```\n3. Enable the Memorystore for Redis API \n [Memorystore for Redis](https://console.cloud.google.com/apis/library/redis.googleapis.com)\n4. Have a Terraform file to which you can add the Memorystore resource. For instructions on setting up Terraform with Google Cloud, see [Getting Started with the Google Cloud Provider](https://registry.terraform.io/providers/hashicorp/google/latest/docs/guides/getting_started).\n\n\u003cbr /\u003e\n\nCreating a Memorystore for Redis instance\n-----------------------------------------\n\nThe following Terraform resource example creates a 2 GiB Basic Tier Redis\ninstance in the `us-central1` region in the BASIC tier. For more information\nabout tiers, see [Redis tier capabilities](/memorystore/docs/redis/redis-tiers).\n\n1. Add the following resource to your Terraform configuration file:\n\n ```\n resource \"google_redis_instance\" \"my_memorystore_redis_instance\" {\n name = \"myinstance\"\n tier = \"BASIC\"\n memory_size_gb = 2\n region = \"us-central1\"\n redis_version = \"REDIS_6_X\"\n }\n ```\n2. **(Optional)** Add the following [output value](https://www.terraform.io/docs/configuration/outputs.html)\n to your Terraform configuration file to print the IP address of the Redis\n instance, which is needed later in this quickstart:\n\n ```\n output \"host\" {\n description = \"The IP address of the instance.\"\n value = \"${google_redis_instance.my_memorystore_redis_instance.host}\"\n }\n ```\n3. Run `terraform init`.\n\n4. Run `terraform plan`, and review the resource to be created.\n\n5. Run `terraform apply` to create.\n\nConnecting to the Redis instance from a Compute Engine VM\n---------------------------------------------------------\n\nNext, connect to the newly created Redis instance.\n\nYou can connect to the Redis instance from any Compute Engine VM\nthat uses the Redis instance's authorized network with a [supported RFC 1918 IP address](/memorystore/docs/redis/networking#supported_and_unsupported_networks).\n\n1. If you don't already have a Compute Engine VM that uses that same\n authorized network as your Redis instance, create one and connect to it by\n following [Quickstart using a Linux VM](/compute/docs/create-linux-vm-instance).\n\n2. Install `telnet` using `apt-get`:\n\n sudo apt-get install telnet\n\n3. From the terminal, telnet to the IP address of the Redis instance, replacing\n \u003cvar translate=\"no\"\u003evariables\u003c/var\u003e with appropriate values.\n\n ```\n telnet instance-ip-address 6379\n ```\n\n If successful, the command will return this result: \n\n ```\n Trying instance-ip-address…\n Connected to instance-ip-address\n ```\n4. In the telnet session, enter some Redis commands:\n\n Enter: \n\n ```\n PING\n ```\n\n Result: \n\n ```\n PONG\n ```\n\n Enter \n\n ```\n SET HELLO WORLD\n ```\n\n Result: \n\n ```\n +OK\n ```\n\n Enter: \n\n ```\n GET HELLO\n ```\n\n Result: \n\n ```\n $5\n WORLD\n ```\n\nClean up\n--------\n\nTo avoid incurring charges to your Google Cloud account for the resources used\nin this quickstart, delete the Redis instance using the steps below:\n\n1. Remove the `google_redis_instance` resource from your Terraform configuration file.\n2. Run Terraform `init`, `plan`, and `apply` to destroy the Redis resource.\n3. [Delete](/compute/docs/create-linux-vm-instance#clean-up) any Compute Engine VMs you created for this quickstart.\n\nWhat's next\n-----------\n\n- Learn more about [creating and managing instances](/memorystore/docs/redis/create-manage-instances).\n- Learn about other ways to [connect to your Redis instance](/memorystore/docs/redis/connecting-redis-instance).\n- Learn about the characteristics of a [Redis instance](/memorystore/docs/redis/instances)."]]
