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.

Neste guia de início rápido, usamos o provedor do 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.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Instale o SDK do Google Cloud, se ainda não tiver feito isso.

    Quando solicitado, escolha o projeto que você selecionou ou criou acima.

  5. Se você já tiver o SDK do Google Cloud instalado, atualize-o.

    gcloud components update
  6. Ativar a API do Memorystore para Redis
    Memorystore para Redis
  7. 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.

  1. 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"
    }
    
  2. 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ário 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}"
    }
    
  3. Execute terraform init.

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

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

  1. Se você ainda não tem uma VM do Compute Engine que usa a mesma rede autorizada que sua instância do Redis, crie uma e conecte-se a ela seguindo o Guia de início rápido sobre como usar uma VM do Linux.

  2. Instale telnet usando apt-get:

    sudo apt-get install telnet
    
  3. 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
    
  4. 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:

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

A seguir