Instalar a extensão do Visual Studio Code do Azure Terraform

O Terraform permite a definição, a visualização e a implantação da infraestrutura de nuvem. Usando o Terraform, você cria arquivos de configuração usando sintaxe de HCL. A sintaxe da HCL permite que você especifique o provedor de nuvem, como o Azure, e os elementos que compõem sua infraestrutura de nuvem. Depois de criar os arquivos de configuração, você cria um plano de execução que permite visualizar as alterações de infraestrutura antes de serem implantadas. Depois de verificar as alterações, aplique o plano de execução para implantar a infraestrutura.

A extensão do Terraform do Visual Studio Code permite trabalhar com o Terraform por meio do editor. Com essa extensão, você pode criar, testar e executar configurações do Terraform.

Neste artigo, você aprenderá como:

• Instalar a extensão do Visual Studio Code do Azure Terraform
• Usar a extensão para criar um grupo de recursos do Azure
• Verificar se o grupo de recursos foi criado
• Excluir o grupo de recursos após a conclusão do teste usando a extensão

1. Configurar seu ambiente

• Assinatura do Azure: caso você não tenha uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Configurar o Terraform: se ainda não tiver feito isso, configure o Terraform usando uma das seguintes opções:

  • Configurar o Terraform no Azure Cloud Shell com o Bash
  • Configurar o Terraform no Azure Cloud Shell com o PowerShell
  • Configurar o Terraform no Windows com o Bash
  • Configurar o Terraform no Windows com o PowerShell

• Instale o Node.js.

2. Instalar a extensão do Visual Studio Code do Azure Terraform

1. Inicie o Visual Studio Code.

2. No menu à esquerda, selecione Extensões e digite Azure Terraform na caixa de texto de pesquisa.

   

3. Na lista de extensões, localize a extensão Azure Terraform. (ela será a primeira extensão listada.)

4. Caso a extensão ainda não tenha sido instalada, clique na opção Instalar da extensão.

   Pontos principais:

   • Quando você seleciona Instalar para a extensão Terraform do Azure, o Visual Studio Code instala a extensão de Conta do Azure automaticamente.
   • A Conta do Azure é um arquivo de dependência da extensão Terraform do Azure. Esse arquivo é usado para a autenticação no Azure e nas extensões de código relacionadas ao Azure.

5. Para confirmar a instalação das extensões, digite @installed na caixa de texto de pesquisa. A extensão Terraform do Azure e a extensão da Conta do Azure aparecem na lista de extensões instaladas.

   

Agora é possível executar todos os comandos com suporte do Terraform em seu ambiente do Cloud Shell de dentro do Visual Studio Code.

3. Implementar o código do Terraform

1. Crie um diretório em que você vai testar o código de exemplo do Terraform, depois transforme-o no diretório atual.

2. Crie um arquivo chamado providers.tf e insira o seguinte código:

   terraform {
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~>3.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   

3. Crie um arquivo chamado main.tf e insira o seguinte código:

   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   resource "azurerm_resource_group" "rg" {
     location = var.resource_group_location
     name     = random_pet.rg_name.id
   }
   

4. Crie um arquivo chamado variables.tf para incluir as variáveis do projeto, depois insira o seguinte código:

   variable "resource_group_location" {
     type        = string
     default     = "eastus"
     description = "Location of the resource group."
   }
   
   variable "resource_group_name_prefix" {
     type        = string
     default     = "rg"
     description = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
   }
   

5. Crie um arquivo chamado outputs.tf para incluir as variáveis do projeto, depois insira o seguinte código:

   output "resource_group_name" {
     value = azurerm_resource_group.rg.name
   }
   

4. Enviar por push o código para o Cloud Shell

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure Terraform: Push, depois selecione-o quando ele for exibido.

3. Clique em OK para confirmar a inicialização do Cloud Shell.

   

   Pontos principais:

   • Os arquivos do workspace que atendem ao filtro indicado na definição azureTerraform.files da configuração são copiados para o Cloud Shell.

5. Inicializar o Terraform no Visual Studio Code

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure Terraform: Init, depois selecione-o quando ele for exibido.

   Pontos principais:

   • Selecionar essa opção é o mesmo que executar o terraform init a partir da linha de comando e inicializa sua implantação do Terraform.
   • Esse comando baixa os módulos do Azure necessários para criar um grupo de recursos do Azure.

3. Siga os prompts para instalar todas as dependências, como a versão mais recente com suporte do Node.js.

4. Se você estiver usando o Cloud Shell pela primeira vez com sua assinatura padrão do Azure, siga os prompts para configurar o ambiente.

6. Criar um plano de execução do Terraform no Visual Studio Code

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure Terraform: Plan, depois selecione-o quando ele for exibido.

   Pontos principais:

   • Esse comando executa terraform plan para criar um plano de execução dos arquivos de configuração do Terraform no diretório atual.

7. Aplicar um plano de execução do Terraform no Visual Studio Code

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure Terraform: Apply, depois selecione-o quando ele for exibido.

3. Quando você receber uma solicitação para confirmar, clique em yes e pressione <Enter>.

8. Verificar os resultados

CLI do Azure

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure: Open Bash in Cloud Shell, depois selecione-o quando ele for exibido.

3. Execute az group show para exibir o grupo de recursos. Substitua o espaço reservado <resource_group_name> pelo nome gerado de modo aleatório do grupo de recursos exibido após a implantação do plano de execução do Terraform.

az group show --name <resource_group_name>

PowerShell do Azure

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure: Open PowerShell in Cloud Shell, depois selecione-o quando ele for exibido.

3. Execute Get-AzResourceGroup para exibir o grupo de recursos.

Get-AzResourceGroup -Name <resource_group_name>

9. Limpar os recursos

1. No menu Exibir, selecione Paleta de Comandos....

2. Na caixa de texto Paleta de Comandos, comece inserindo Azure Terraform: Destroy, depois selecione-o quando ele for exibido.

3. Quando você receber uma solicitação para confirmar, clique em yes e pressione <Enter>.

4. Para confirmar se o Terraform destruiu o novo grupo de recursos com êxito, execute as etapas da seção Verificar os resultados.

Solucionar problemas do Terraform no Azure

Solucionar problemas comuns ao usar o Terraform no Azure

Próximas etapas

Ler mais sobre a extensão do Visual Studio Code do Azure Terraform