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, você aplica o plano de execução para implantar a infraestrutura.

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

Neste artigo, você aprenderá a:

1. Configurar 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 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 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 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 do Azure Terraform, 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 do Azure Terraform. Esse arquivo é usado para autenticar 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 do Azure Terraform e a extensão da Conta do Azure aparecem na lista de extensões instaladas.

   

Agora você pode executar todos os comandos do Terraform com suporte em seu ambiente do Cloud Shell no Visual Studio Code.

3. Implementar o código 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 = "~>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. Enviar 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:

   • Seus arquivos de workspace que atendem ao filtro definido na configuração em sua configuração são copiados para o azureTerraform.files 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 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 na 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 quaisquer dependências, como a versão mais recente com suporte do nodejs.

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

   Pontos principais:

   • Esse comando executa terraform plan para criar um plano de execução a partir 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 a inseri-la Azure Terraform: Apply e selecione-a quando ela for exibida.

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

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

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

4. Para confirmar se 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óximas etapas