Freigeben über


Installieren der Azure Terraform-Erweiterung für Visual Studio Code

Mit Terraform können Sie eine Cloudinfrastruktur definieren, eine Vorschau der Cloudinfrastruktur anzeigen und die Cloudinfrastruktur bereitstellen. Terraform ermöglicht das Erstellen von Konfigurationsdateien mit HCL-Syntax. Mit der HCL-Syntax können Sie den Cloudanbieter (beispielsweise Azure) und die Elemente angeben, aus denen sich Ihre Cloudinfrastruktur zusammensetzt. Nach der Erstellung Ihrer Konfigurationsdateien erstellen Sie einen Ausführungsplan, mit dem Sie eine Vorschau Ihrer Infrastrukturänderungen anzeigen können, bevor diese bereitgestellt werden. Nach der Überprüfung der Änderungen wenden Sie den Ausführungsplan an, um die Infrastruktur bereitzustellen.

Mit der Visual Studio Code Terraform-Erweiterung können Sie mit Terraform aus dem Editor arbeiten. Mit dieser Erweiterung können Sie Terraform-Konfigurationen erstellen, testen und ausführen.

In diesem Artikel erfahren Sie, wie Sie:

  • Installieren der Azure Terraform-Erweiterung für Visual Studio Code
  • Verwenden der Erweiterung zum Erstellen einer Azure-Ressourcengruppe
  • Überprüfen Sie, ob die Ressourcengruppe erstellt worden ist
  • Löschen der Ressourcengruppe nach Abschluss des Tests mithilfe der Erweiterung

1. Konfigurieren Ihrer Umgebung

  • Azure-Abonnement: Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

2. Installieren der Azure Terraform Visual Studio Code-Erweiterung

  1. Starten Sie Visual Studio Code.

  2. Wählen Sie im linken Menü Erweiterungen aus, und geben Sie Azure Terraform in das Suchtextfeld ein.

    Suchen Sie Visual Studio Code-Erweiterungen in Marketplace.

  3. Suchen Sie in der Liste der Erweiterungen die Azure Terraform Erweiterung. (Es sollte die erste aufgeführte Erweiterung sein.)

  4. Wenn die Erweiterung noch nicht installiert ist, wählen Sie die Installationsoption der Erweiterung aus.

    Die wichtigsten Punkte:

    • Wenn Sie "Installieren " für die Azure Terraform-Erweiterung auswählen, installiert Visual Studio Code automatisch die Azure-Kontoerweiterung.
    • Azure Account ist eine Abhängigkeitsdatei für die Azure Terraform-Erweiterung. Diese Datei wird verwendet, um sich bei Azure- und Azure-bezogenen Codeerweiterungen zu authentifizieren.
  5. Um die Installation der Erweiterungen zu bestätigen, geben Sie @installed im Suchtextfeld ein. Sowohl die Azure Terraform-Erweiterung als auch die Azure-Kontoerweiterung werden in der Liste der installierten Erweiterungen angezeigt.

    Sehen Sie installierte Terraform-Erweiterungen an.

Sie können jetzt alle unterstützten Terraform-Befehle in Ihrer Cloud Shell-Umgebung in Visual Studio Code ausführen.

3. Implementieren des Terraform-Codes

  1. Erstellen Sie ein Verzeichnis, in dem der Terraform-Beispielcode getestet werden soll, und legen Sie es als aktuelles Verzeichnis fest.

  2. Erstellen Sie eine Datei namens providers.tf, und fügen Sie den folgenden Code ein:

    terraform {
      required_providers {
        azurerm = {
          source  = "hashicorp/azurerm"
          version = "~>4.0"
        }
        random = {
          source  = "hashicorp/random"
          version = "~>3.0"
        }
      }
    }
    
    provider "azurerm" {
      features {}
    }
    
  3. Erstellen Sie eine Datei namens main.tf, und fügen Sie den folgenden Code ein:

    # 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. Erstellen Sie eine Datei namens variables.tf , die die Projektvariablen enthält, und fügen Sie den folgenden Code ein:

    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. Erstellen Sie eine Datei namens outputs.tf , die die Projektvariablen enthält, und fügen Sie den folgenden Code ein:

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

4. Pushen Sie Ihren Code an Cloud Shell

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure Terraform: Push , und wählen Sie es aus, wenn es angezeigt wird.

  3. Wählen Sie "OK" aus, um das Öffnen von Cloud Shell zu bestätigen.

    Bestätigen Sie das Öffnen von Cloud Shell.

    Die wichtigsten Punkte:

    • Ihre Arbeitsbereichsdateien, die dem in der azureTerraform.files Einstellung in Ihrer Konfiguration definierten Filter entsprechen, werden in Cloud Shell kopiert.

5. Initialisieren von Terraform in Visual Studio Code

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure Terraform: Init , und wählen Sie es aus, wenn es angezeigt wird.

    Die wichtigsten Punkte:

    • Die Auswahl dieser Option entspricht der Ausführung von Terraform init über die Befehlszeile und initialisiert Ihre Terraform-Bereitstellung.
    • Mit diesem Befehl werden die Azure-Module heruntergeladen, die zum Erstellen einer Azure-Ressourcengruppe erforderlich sind.
  3. Befolgen Sie die Anweisungen, um Abhängigkeiten zu installieren, z. B. die neueste unterstützte Version von nodejs.

  4. Wenn Sie Cloud Shell zum ersten Mal mit Ihrem Azure-Standardabonnement verwenden, folgen Sie den Anweisungen zum Konfigurieren der Umgebung.

6. Erstellen eines Terraform-Ausführungsplans in Visual Studio Code

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure Terraform: Plan , und wählen Sie es aus, wenn es angezeigt wird.

    Die wichtigsten Punkte:

    • Dieser Befehl führt terraform Plan aus, um einen Ausführungsplan aus den Terraform-Konfigurationsdateien im aktuellen Verzeichnis zu erstellen.

7. Anwenden eines Terraform-Ausführungsplans in Visual Studio Code

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure Terraform: Apply , und wählen Sie es aus, wenn es angezeigt wird.

  3. Wenn Sie zur Bestätigung aufgefordert werden, geben Sie yes ein, und drücken Sie .<Enter>

8. Überprüfen der Ergebnisse

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure: Open Bash in Cloud Shell , und wählen Sie es aus, wenn es angezeigt wird.

  3. Führen Sie az group show aus, um die Ressourcengruppe anzuzeigen. Ersetzen Sie den <resource_group_name> Platzhalter durch den zufällig generierten Namen der Ressourcengruppe, die nach dem Anwenden des Terraform-Ausführungsplans angezeigt wird.

az group show --name <resource_group_name>

9. Bereinigen von Ressourcen

  1. Wählen Sie im Menü "Ansicht " die Option "Befehlspalette..." aus.

  2. Beginnen Sie im Textfeld "Befehlspalette" mit der Eingabe Azure Terraform: Destroy , und wählen Sie es aus, wenn es angezeigt wird.

  3. Wenn Sie zur Bestätigung aufgefordert werden, geben Sie yes ein, und drücken Sie .<Enter>

  4. Um zu bestätigen, dass Terraform Ihre neue Ressourcengruppe erfolgreich zerstört hat, führen Sie die Schritte im Abschnitt aus, überprüfen Sie die Ergebnisse.

Problembehandlung für Terraform in Azure

Behandeln allgemeiner Probleme bei der Verwendung von Terraform in Azure

Nächste Schritte