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, você aprenderá a:

1. Configure seu ambiente

• Assinatura do Azure: se você não tiver uma assinatura 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 Node.js.

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

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

   

Agora você pode executar todos os comandos Terraform suportados em seu ambiente Cloud Shell de dentro 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 = "~>4.0"
       }
       random = {
         source  = "hashicorp/random"
         version = "~>3.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   

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

   # Create a random name for the resource group using random_pet
   resource "random_pet" "rg_name" {
     prefix = var.resource_group_name_prefix
   }
   
   # Create a resource group using the generated random name
   resource "azurerm_resource_group" "example" {
     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.example.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 digitar Azure Terraform: Push e selecione quando for exibido.

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

   

   Pontos principais:

   • Os ficheiros do espaço de trabalho que correspondem ao filtro definido na 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 digitar Azure Terraform: Init e selecione quando for exibido.

   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 digitar Azure Terraform: Plan e selecione quando for exibido.

   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 digitar Azure Terraform: Apply e selecione quando for exibido.

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

8. Verificar os resultados

az group show --name <resource_group_name>

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 digitar Azure Terraform: Destroy e selecione quando for exibido.

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