Crie uma instância do Memorystore for Redis com o Terraform

Crie uma instância do Memorystore for Redis com o Terraform

Saiba como criar uma instância do Memorystore for Redis, estabelecer ligação à mesma e, em seguida, eliminá-la.

Este início rápido usa o fornecedor da Google Cloud Platform para o Terraform.

Antes de começar

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.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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.

Go to project selector

Se estiver a usar um projeto existente para este guia, verifique se tem as autorizações necessárias para concluir este guia. Se criou um novo projeto, já tem as autorizações necessárias.

Verify that billing is enabled for your Google Cloud project.

Enable the Memorystore for Redis API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

1. Se ainda não o fez, instale o SDK Google Cloud.

   Quando lhe for pedido, escolha o projeto que selecionou ou criou.

2. Se já tiver o SDK do Google Cloud instalado, atualize-o.

   gcloud components update

3. Ative a API Memorystore for Redis.
   Memorystore for Redis
4. Ter um ficheiro do Terraform ao qual pode adicionar o recurso do Memorystore. Para ver instruções sobre como configurar o Terraform com o Google Cloud, consulte o artigo Começar a usar o fornecedor do Google Cloud.

Funções necessárias

Para receber as autorizações de que precisa para criar uma instância do Memorystore for Redis, peça ao seu administrador que lhe conceda as seguintes funções do IAM no projeto:

• Administrador do Cloud Memorystore Redis (roles/redis.admin)
• Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1)
• Utilizador da conta de serviço (roles/iam.serviceAccountUser)

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Crie uma instância do Memorystore for Redis

Nesta secção, cria uma instância do Memorystore for Redis de 2 GB localizada na região us-central1 e que está no nível Básico. Para mais informações acerca dos níveis, consulte o artigo Capacidades dos níveis do Redis.

1. Adicione o seguinte recurso ao seu ficheiro 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"
   }
   

2. Adicione o seguinte valor de saída ao seu ficheiro de configuração do Terraform para imprimir o endereço IP da instância. Precisa deste endereço para estabelecer ligação à sua instância.

   output "host" {
    description = "The IP address of the instance."
    value = "${google_redis_instance.my_memorystore_redis_instance.host}"
   }
   

3. Execute o comando terraform init.

4. Execute o comando terraform plan e, em seguida, reveja a instância a ser criada.

5. Para criar a instância, execute o comando terraform apply.

Ligue-se à instância do Memorystore for Redis a partir de uma VM do Compute Engine

Pode estabelecer ligação à instância do Memorystore for Redis a partir de qualquer VM do Compute Engine que use a rede autorizada da instância com um endereço IP RFC 1918 suportado.

1. Se não tiver uma VM do Compute Engine que use a mesma rede autorizada que a sua instância, crie uma e ligue-se à VM através do SSH. Para o fazer, siga os passos em Crie uma instância de VM Linux no Compute Engine.

2. Use o apt-get para instalar o telnet:

   sudo apt-get install telnet
   

3. A partir do terminal, use o telnet para aceder ao endereço IP da instância. Substitua VARIABLES pelos valores adequados.

   telnet INSTANCE_IP_ADDRESS 6379
   

   Se conseguir estabelecer ligação à instância, o comando devolve este resultado:

   Trying INSTANCE_IP_ADDRESS…
   Connected to INSTANCE_IP_ADDRESS
   

4. Na sessão do telnet, introduza alguns comandos do Redis:

   Introduza:

   PING
   

   Resultado:

   PONG
   

   Enter

   SET HELLO WORLD
   

   Resultado:

   +OK
   

   Introduza:

   GET HELLO
   

   Resultado:

   $5
   WORLD
   

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

1. Remova o recurso google_redis_instance do ficheiro de configuração do Terraform.
2. Para eliminar o recurso, execute os comandos terraform init, terraform plan e terraform apply.
3. Opcional. Se criou uma VM do Compute Engine para este início rápido, elimine-a.

O que se segue?

• Saiba mais acerca de como criar e gerir instâncias.
• Saiba mais sobre outras formas de estabelecer ligação à sua instância do Redis.
• Saiba mais sobre as caraterísticas de uma instância do Redis.