Comenzar: Instalación de la extensión de Visual Studio Code para Azure Terraform

La extensión de Visual Studio Code para Terraform permite trabajar con Terraform desde el editor. Con esta extensión, puede crear, probar y ejecutar configuraciones de Terraform.

En este artículo aprenderá a:

  • Instalación de la extensión de Visual Studio Code para Azure Terraform
  • Usar la extensión para crear un grupo de recursos de Azure
  • Comprobar que se ha creado el grupo de recursos
  • Eliminar el grupo de recursos al finalizar las pruebas con la extensión

1. Configurar su entorno

  • Suscripción de Azure: Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

2. Instalación de la extensión de Visual Studio Code para Azure Terraform

  1. Inicie Visual Studio Code.

  2. En el menú de la izquierda, seleccione Extensionesy escriba en el cuadro de texto de búsqueda.

    Búsqueda de extensiones de Visual Studio Code en Marketplace.

  3. En la lista de extensiones, busque la extensión Azure Terraform. (Debe ser la primera extensión de la lista).

  4. Si la extensión aún no está instalada, seleccione la opción Instalar de la extensión.

    Puntos clave:

    • Al seleccionar Instalar para la extensión de Terraform de Azure, Visual Studio Code instalará automáticamente la extensión de la cuenta de Azure.
    • La cuenta de Azure es un archivo de dependencia para la extensión de Azure Terraform. Este archivo se usa para autenticarse en Azure y las extensiones de código relacionadas con Azure.
  5. Para confirmar la instalación de las extensiones, escriba @installed en el cuadro de texto de búsqueda. Tanto la extensión para Azure Terraform como la extensión para cuentas de Azure aparecerán en la lista de extensiones instaladas.

    Ver las extensiones de Terraform instaladas.

Ahora puede ejecutar todos los comandos admitidos de Terraform en su entorno de Cloud Shell desde dentro de Visual Studio Code.

3. Implementación del código de Terraform

  1. Cree un directorio en el que probar el código de Terraform de ejemplo y abra ese directorio en Visual Studio. Los archivos que cree en esta sección se deben crear en el nuevo directorio.

  2. Cree un archivo llamado main.tf e inserte el siguiente código:

    terraform {
    
      required_version = ">=0.12"
      
      required_providers {
        azurerm = {
          source = "hashicorp/azurerm"
          version = "~>2.0"
        }
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
    resource "random_pet" "rg-name" {
      prefix    = var.resource_group_name_prefix
    }
    
    resource "azurerm_resource_group" "rg" {
      name      = random_pet.rg-name.id
      location  = var.resource_group_location
    }
    
  3. Cree un archivo llamado variables.tf que contenga las variables del proyecto e inserte el código siguiente:

    variable "resource_group_name_prefix" {
      default       = "rg"
      description   = "Prefix of the resource group name that's combined with a random ID so name is unique in your Azure subscription."
    }
    
    variable "resource_group_location" {
      default = "eastus"
      description   = "Location of the resource group."
    }
    

    Puntos clave:

    • Los valores de resource_group_name y resource_group_location se muestran con valores de prueba. Puede establecer estos valores en lo que tenga sentido para su entorno.
  4. Cree un archivo llamado output.tf que contenga las variables del proyecto e inserte el código siguiente:

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

    Puntos clave:

    • El archivo output.tf muestra el nombre del grupo de recursos aleatorio.

4. Inserción del código en Cloud Shell

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure Terraform: Push y selecciónelo cuando se muestre.

  3. Seleccione Aceptar para confirmar la apertura de Cloud Shell.

    Confirmar la apertura de Cloud Shell.

    Puntos clave:

    • Los archivos del área de trabajo que cumplen el filtro definido en la opción azureTerraform.files de la configuración se copian en Cloud Shell.

5. Inicialización de Terraform en Visual Studio Code

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure Terraform: Init y selecciónelo cuando se muestre.

    Puntos clave:

    • Seleccionar esta opción es lo mismo que ejecutar terraform init desde la línea de comandos e inicializará la implementación de Terraform.
    • Este comando descarga los módulos de Azure necesarios para crear un grupo de recursos de Azure.
  3. Siga las indicaciones para instalar las dependencias, como la versión compatible más reciente de Node.js.

  4. Si es la primera vez que usa Cloud Shell con la suscripción de Azure predeterminada, siga las indicaciones para configurar el entorno.

6. Creación de un plan de ejecución de Terraform en Visual Studio Code

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure Terraform: Plan y selecciónelo cuando se muestre.

    Puntos clave:

    • Este comando ejecuta terraform plan para crear un plan de ejecución a partir de los archivos de configuración de Terraform en el directorio actual.

7. Aplicación de un plan de ejecución de Terraform en Visual Studio Code

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure Terraform: Apply y selecciónelo cuando se muestre.

  3. Cuando se le pida confirmación, escriba yes y presione <Enter>.

8. Comprobación de los resultados

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure: Open Bash in Cloud Shell y selecciónelo cuando se muestre.

  3. Ejecute az group show para mostrar el grupo de recursos. Reemplace el marcador de posición <resource_group_name> por el nombre generado aleatoriamente del grupo de recursos que se muestra después de aplicar el plan de ejecución de Terraform.

az group show --name <resource_group_name>

9. Limpieza de recursos

  1. En el menú Ver, seleccione Paleta de comandos... .

  2. En el cuadro de texto de la paleta de comandos, empiece a escribir Azure Terraform: Destroy y selecciónelo cuando se muestre.

  3. Cuando se le pida confirmación, escriba yes y presione <Enter>.

  4. Para confirmar que Terraform haya destruido correctamente el nuevo grupo de recursos, ejecute los pasos de la sección Comprobación de los resultados.

Solución de problemas de Terraform en Azure

Solución de problemas comunes al usar Terraform en Azure

Pasos siguientes