Installare l'estensione Azure Terraform di Visual Studio Code

Terraform consente di definire, visualizzare in anteprima e distribuire l'infrastruttura cloud. Con Terraform è possibile creare file di configurazione usando la sintassi HCL. La sintassi HCL consente di specificare il provider di servizi cloud, ad esempio Azure, e gli elementi che costituiscono l'infrastruttura cloud. Dopo aver creato i file di configurazione, è necessario creare un piano di esecuzione che consenta di visualizzare in anteprima le modifiche apportate all'infrastruttura prima che vengano distribuite. Dopo aver verificato le modifiche, è possibile applicare il piano di esecuzione per distribuire l'infrastruttura.

L'estensione Terraform di Visual Studio Code consente di usare Terraform dall'editor. Con tale estensione, è possibile creare, testare ed eseguire configurazioni Terraform.

In questo articolo vengono illustrate le operazioni seguenti:

• Installare l'estensione Azure Terraform di Visual Studio Code
• Usare l'estensione per creare un gruppo di risorse di Azure
• Verificare che il gruppo di risorse sia stato creato
• Eliminare il gruppo di risorse al termine del test usando l'estensione

1. Configurare l'ambiente

• Sottoscrizione di Azure: se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Configurare Terraform: se non è già stato fatto, configurare Terraform usando una delle opzioni seguenti:

  • Configurare Terraform in Azure Cloud Shell con Bash
  • Configurare Terraform in Azure Cloud Shell con PowerShell
  • Configurare Terraform in Windows con Bash
  • Configurare Terraform in Windows con PowerShell

• Installare Node.js.

2. Installare l'estensione Azure Terraform di Visual Studio Code

1. Avviare Visual Studio Code.

2. Nel menu a sinistra selezionare Estensioni e immettere Azure Terraform nella casella di testo di ricerca.

   

3. Nell'elenco delle estensioni individuare l'estensione Azure Terraform . Deve essere la prima estensione elencata.

4. Se l'estensione non è ancora installata, selezionare l'opzione Installa dell'estensione.

   Punti principali:

   • Quando si seleziona Installa per l'estensione Azure Terraform, Visual Studio Code installa automaticamente l'estensione Account Azure.
   • L'account Azure è un file di dipendenza per l'estensione Azure Terraform. Questo file viene usato per eseguire l'autenticazione in Azure e nelle estensioni di codice correlate ad Azure.

5. Per confermare l'installazione delle estensioni, immettere @installed nella casella di testo di ricerca. Sia l'estensione Azure Terraform che l'estensione Account Azure vengono visualizzate nell'elenco delle estensioni installate.

   

È ora possibile eseguire tutti i comandi di Terraform supportati nell'ambiente di Cloud Shell direttamente da Visual Studio Code.

3. Implementare il codice Terraform

1. Creare una directory in cui testare il codice Terraform di esempio e impostarla come directory corrente.

2. Creare un file denominato providers.tf e inserire il codice seguente:

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

3. Creare un file denominato main.tf e inserire il codice seguente:

   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. Creare un file denominato variables.tf per contenere le variabili di progetto e inserire il codice seguente:

   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. Creare un file denominato outputs.tf per contenere le variabili di progetto e inserire il codice seguente:

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

4. Eseguire il push del codice in Cloud Shell

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure Terraform: Push e selezionarla quando viene visualizzata.

3. Selezionare OK per confermare l'apertura di Cloud Shell.

   

   Punti principali:

   • I file dell'area di lavoro che soddisfano il filtro definito nell'impostazione azureTerraform.files nella configurazione vengono copiati in Cloud Shell.

5. Inizializzare Terraform in Visual Studio Code

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure Terraform: Init e selezionarla quando viene visualizzata.

   Punti principali:

   • La selezione di questa opzione equivale all'esecuzione di terraform init dalla riga di comando e inizializza la distribuzione di Terraform.
   • Questo comando scarica i moduli di Azure necessari per creare un gruppo di risorse di Azure.

3. Seguire le istruzioni per installare eventuali dipendenze, ad esempio la versione supportata più recente di nodejs.

4. Se si usa Cloud Shell per la prima volta con la sottoscrizione di Azure predefinita, seguire le istruzioni per configurare l'ambiente.

6. Creare un piano di esecuzione terraform in Visual Studio Code

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure Terraform: Plan e selezionarla quando viene visualizzata.

   Punti principali:

   • Questo comando esegue il piano terraform per creare un piano di esecuzione dai file di configurazione terraform nella directory corrente.

7. Applicare un piano di esecuzione terraform in Visual Studio Code

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure Terraform: Apply e selezionarla quando viene visualizzata.

3. Quando viene richiesto di confermare, immettere yes e premere <Enter>.

8. Verificare i risultati

Interfaccia della riga di comando di Azure

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure: Open Bash in Cloud Shell e selezionarla quando viene visualizzata.

3. Eseguire az group show per visualizzare il gruppo di risorse. Sostituire il <resource_group_name> segnaposto con il nome generato in modo casuale del gruppo di risorse visualizzato dopo aver applicato il piano di esecuzione terraform.

az group show --name <resource_group_name>

Azure PowerShell

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure: Open PowerShell in Cloud Shell e selezionarla quando viene visualizzata.

3. Eseguire Get-AzResourceGroup per visualizzare il gruppo di risorse.

Get-AzResourceGroup -Name <resource_group_name>

9. Pulire le risorse

1. Scegliere Riquadro comandi dal menu Visualizza.

2. Nella casella di testo Riquadro comandi iniziare a immettere Azure Terraform: Destroy e selezionarla quando viene visualizzata.

3. Quando viene richiesto di confermare, immettere yes e premere <Enter>.

4. Per verificare che Terraform abbia eliminato correttamente il nuovo gruppo di risorse, eseguire i passaggi nella sezione Verificare i risultati.

Risolvere i problemi di Terraform in Azure

Risolvere i problemi comuni relativi all'uso di Terraform in Azure

Passaggi successivi

Altre informazioni sull'estensione Azure Terraform di Visual Studio Code