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

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