Instalar a extensão do Microsoft Terraform Visual Studio Code

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 Microsoft Terraform Visual Studio Code

1. Inicie o Visual Studio Code.

2. Selecione Extensões e pesquise o Microsoft Terraform."

   

3. Na lista de extensões, localize a Microsoft 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.

   • Quando você seleciona Instalar para a extensão do Microsoft Terraform, o Visual Studio Code instala automaticamente a extensão da Conta do Azure primeiro, para que você possa autenticar e usar extensões de código relacionadas ao Azure.
   • Agora, com a descontinuação da extensão de Conta do Azure, a autenticação será gerenciada pelo Provedor de Autenticação embutido da Microsoft no Visual Studio Code e pela extensão de Recursos do Azure.
   • No menu à esquerda, selecione Extensões e digite Azure Resources na caixa de texto de pesquisa.
   • Na lista de extensões, localize a Azure Resources extensão. (Deve ser a primeira extensão listada.)

5. Para confirmar a instalação das extensões, digite @installed na caixa de texto de pesquisa. Tanto a extensão do Microsoft Terraform quanto a extensão de Recursos do Azure devem aparecer na lista de extensões instaladas.

   

   

Agora você pode executar todos os comandos com suporte do Terraform 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 da paleta de comandos, comece a digitar Microsoft Terraform: Push e selecione-o quando ele for exibido.

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

   Seus arquivos de workspace que atendem ao filtro definido na configuração azureTerraform.files 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 da Command Palette, comece a digitar Microsoft Terraform: Init e selecione-o quando ele for exibido.

   • 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 da Paleta de Comandos, comece a inserir Microsoft Terraform: Plan e selecione-o quando ele for exibido.

   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 da Paleta de Comandos, comece a digitar Microsoft Terraform: Apply e selecione-a quando 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 inserir Microsoft Terraform: Destroy e selecione-o quando for exibido.

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