Guia de início rápido: criar uma instância de VM usando o Terraform

Neste guia de início rápido, você vai aprender a usar o Terraform para criar uma instância de máquina virtual (VM) e conectar-se a ela.

Hashicorp Terraform é uma ferramenta de infraestrutura como código (IaC, na sigla em inglês) que permite provisionar e gerenciar infraestrutura em nuvem. O Provedor do Terraform para o Google Cloud (provedor do Google Cloud) permite provisionar e gerenciar a infraestrutura do Google Cloud.

Antes de começar

  1. Para usar um terminal on-line com a gcloud CLI e o Terraform já configurados, ative o Cloud Shell:

    Na parte de baixo desta página, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. A inicialização da sessão pode levar alguns segundos.

  2. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

  4. Enable the Compute Engine API:

    gcloud services enable compute.googleapis.com
  5. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/compute.instanceAdmin.v1

    gcloud projects add-iam-policy-binding PROJECT_ID --member="USER_IDENTIFIER" --role=ROLE

Prepare o ambiente

  1. Clone o repositório do GitHub que contém exemplos do Terraform:

    git clone https://github.com/terraform-google-modules/terraform-docs-samples.git --single-branch
    
  2. Acesse o diretório que contém o exemplo do guia de início rápido:

    cd terraform-docs-samples/compute/quickstart/create_vm
    

Revisar os arquivos do Terraform

Revise o arquivo main.tf. Esse arquivo define os recursos do Google Cloud que você quer criar.

cat main.tf

A saída será assim

resource "google_compute_instance" "default" {
  name         = "my-vm"
  machine_type = "n1-standard-1"
  zone         = "us-central1-a"

  boot_disk {
    initialize_params {
      image = "ubuntu-minimal-2210-kinetic-amd64-v20230126"
    }
  }

  network_interface {
    network = "default"
    access_config {}
  }
}

Esse arquivo descreve o recurso google_compute_instance, que é o recurso do Terraform para instâncias de VM do Compute Engine. google_compute_instance está configurado para ter as seguintes propriedades:

  • name, definida como my-vm.
  • machine_type, definida como n1-standard-1.
  • zone, definida como us-central1-a.
  • boot_disk define o disco de inicialização da instância.
  • network_interface está configurado para usar a rede padrão no seu projeto do Google Cloud.

Criar a instância de VM do Compute Engine

  1. No Cloud Shell, execute o seguinte comando para verificar se o Terraform está disponível:

    terraform
    

    A saída será semelhante a esta:

    
    Usage: terraform [global options] <subcommand> [args]
    
    The available commands for execution are listed below.
    The primary workflow commands are given first, followed by
    less common or more advanced commands.
    
    Main commands:
      init          Prepare your working directory for other commands
      validate      Check whether the configuration is valid
      plan          Show changes required by the current configuration
      apply         Create or update infrastructure
      destroy       Destroy previously-created infrastructure
    
    
  2. Inicialize o Terraform executando o seguinte comando. Esse comando prepara seu espaço de trabalho para que o Terraform aplique sua configuração.

    terraform init
    

    A saída será semelhante a esta:

    
    Initializing the backend...
    
    Initializing provider plugins...
    - Finding latest version of hashicorp/google...
    - Installing hashicorp/google v5.35.0...
    - Installed hashicorp/google v5.35.0 (signed by HashiCorp)
    
    Terraform has created a lock file .terraform.lock.hcl to record the provider
    selections it made above. Include this file in your version control repository
    so that Terraform can guarantee to make the same selections by default when
    you run "terraform init" in the future.
    
    Terraform has been successfully initialized!
    
    
  3. Valide a configuração do Terraform executando o comando a seguir. Esse comando realiza as seguintes ações:

    • verifica se a sintaxe de main.tf está correta;
    • mostra uma prévia dos recursos que serão criados.
    terraform plan
    

    A saída será semelhante a esta:

    Plan: 1 to add, 0 to change, 0 to destroy.
    
    Note: You didn't use the -out option to save this plan, so Terraform can't
    guarantee to take exactly these actions if you run "terraform apply" now.
    
  4. Aplique a configuração para provisionar os recursos descritos no arquivo main.tf:

    terraform apply
    

    Quando solicitado, digite yes.

    O Terraform chama as APIs do Google Cloud para criar a instância de VM definida no arquivo main.tf.

    A saída será semelhante a esta:

    Apply complete! Resources: 1 added, 0 changed, 0 destroyed
    

Conectar-se à instância de VM

Execute o comando a seguir para se conectar à instância de VM recém-criada:

gcloud compute ssh --zone=us-central1-a my-vm

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados nesta página, exclua o projeto do Google Cloud com esses recursos.

No Cloud Shell, execute o seguinte comando para excluir os recursos do Terraform:

terraform destroy

Quando solicitado, digite yes.

A saída será semelhante a esta:

Destroy complete! Resources: 1 destroyed.

A seguir