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

Esta página descreve como usar o Terraform para criar uma nova instância do Memorystore for Redis. Também mostra como estabelecer ligação à instância através do telnet.

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

Antes de começar

  1. 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.

  2. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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 (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

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

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

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

    gcloud components update
  8. Ative a API Memorystore for Redis
    Memorystore for Redis
  9. Ter um ficheiro 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.

    10. Crie uma instância do Memorystore for Redis

    O seguinte exemplo de recurso do Terraform cria uma instância do Redis de nível básico de 2 GiB na região us-central1 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. (Opcional) adicione o seguinte valor de saída ao ficheiro de configuração do Terraform para imprimir o endereço IP da instância do Redis, que é necessário mais tarde neste início rápido:

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

    3. Corrida terraform init.

    4. Execute terraform plan e reveja o recurso a ser criado.

    5. Execute terraform apply para criar.

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

    Em seguida, estabeleça ligação à instância do Redis recém-criada.

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

    1. Se ainda não tiver uma VM do Compute Engine que use a mesma rede autorizada que a sua instância do Redis, crie uma e ligue-se a ela seguindo o Início rápido com uma VM Linux.

    2. Instale o telnet com o apt-get:

      sudo apt-get install telnet

    3. No terminal, use o telnet para aceder ao endereço IP da instância do Redis, substituindo variables pelos valores adequados.

      telnet instance-ip-address 6379

      Se for bem-sucedido, 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 custos na sua Google Cloud conta pelos recursos usados neste início rápido, elimine a instância do Redis através dos passos abaixo:

    1. Remova o recurso google_redis_instance do ficheiro de configuração do Terraform.
    2. Execute o Terraform init, plan e apply para destruir o recurso Redis.
    3. Elimine todas as VMs do Compute Engine que criou para este início rápido.

O que se segue?