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

Terraform permite a definição, visualização e implantação de infraestrutura em nuvem. Usando Terraform, você cria arquivos de configuração usando a sintaxe HCL. A sintaxe HCL permite especificar 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 na infraestrutura antes que elas sejam implantadas. Depois de verificar as alterações, você aplica o plano de execução para implantar a infraestrutura.

A extensão Visual Studio Code Terraform permite que você trabalhe com Terraform a partir do editor. Com essa extensão, você pode criar, testar e executar configurações do Terraform.

Neste artigo, vai aprender a:

• Instalar a extensão do Azure Terraform no Visual Studio Code
• 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 quando terminar o teste usando a extensão

1. Configure seu ambiente

• Subscrição do Azure: se não tem uma subscrição do Azure, crie uma conta gratuita antes de começar.

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

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

• Instale o Node.js.

2. Instale a extensão Azure Terraform Visual Studio Code

1. Abra 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 Azure Terraform extensão. (Deve ser a primeira extensão listada.)

4. Se a extensão ainda não estiver instalada, selecione a opção Instalar da extensão.

   Pontos principais:

   • Quando você seleciona Instalar para a extensão Terraform do Azure, o Visual Studio Code instala automaticamente a extensão da Conta do Azure.
   • A Conta do Azure é um arquivo de dependência para a extensão Azure Terraform. Esse arquivo é usado para autenticar no Azure e 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 Azure Terraform e a extensão da Conta do Azure aparecem na lista de extensões instaladas.

   

Pode agora executar todos os comandos suportados do Terraform no seu ambiente do Cloud Shell a partir do Visual Studio Code.

3. Implementar o código Terraform

1. Crie um diretório no qual testar o código Terraform de exemplo e torná-lo o 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 nomeado variables.tf para conter as variáveis de projeto e 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 nomeado outputs.tf para conter as variáveis de projeto e insira o seguinte código:

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

4. Envie seu código para o Cloud Shell

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

2. Na caixa de texto Paleta de comandos, comece a inseri-la Azure Terraform: Push e selecione-a quando ela for exibida.

3. Selecione OK para confirmar a abertura do Cloud Shell.

   

   Pontos principais:

   • Os arquivos do espaço de trabalho que atendem ao filtro definido na configuração em sua configuração são copiados para o azureTerraform.files Cloud Shell.

5. Inicialize o Terraform dentro do Visual Studio Code

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

2. Na caixa de texto Paleta de comandos, comece a inseri-la Azure Terraform: Init e selecione-a quando ela for exibida.

   Pontos principais:

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

3. Siga as instruções para instalar quaisquer dependências - como a versão suportada mais recente do nodejs.

4. Se você estiver usando o Cloud Shell pela primeira vez com sua assinatura padrão do Azure, siga as instruções para configurar o ambiente.

6. Crie um plano de execução Terraform dentro do Visual Studio Code

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

2. Na caixa de texto Paleta de comandos, comece a inseri-la Azure Terraform: Plan e selecione-a quando ela for exibida.

   Pontos principais:

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

7. Aplique um plano de execução Terraform dentro do Visual Studio Code

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

2. Na caixa de texto Paleta de comandos, comece a inseri-la Azure Terraform: Apply e selecione-a quando ela for exibida.

3. Quando for solicitada a confirmação, digite 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 a inseri-la Azure: Open Bash in Cloud Shell e selecione-a quando ela for exibida.

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

az group show --name <resource_group_name>

Azure PowerShell

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

2. Na caixa de texto Paleta de comandos, comece a inseri-la Azure: Open PowerShell in Cloud Shell e selecione-a quando ela for exibida.

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 a inseri-la Azure Terraform: Destroy e selecione-a quando ela for exibida.

3. Quando for solicitada a confirmação, digite yes e pressione <Enter>.

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

Solucionar problemas do Terraform no Azure

Solucionar problemas comuns ao usar o Terraform no Azure

Próximos passos

Leia mais sobre a extensão Azure Terraform Visual Studio Code