Share via


Übersicht über Azure Export für Terraform

Azure Export for Terraform ist ein Tool, das dazu dient, die Reibung bei der Übersetzung zwischen Azure- und Terraform-Konzepten zu reduzieren.

Vorteile

Azure Export für Terraform ermöglicht Folgendes:

  • Vereinfachen Sie die Migration zu Terraform auf Azure. Mit Azure Export für Terraform können Sie Azure-Ressourcen mithilfe eines einzigen Befehls nach Terraform migrieren.
  • Exportieren Sie vom Benutzer angegebene Ressourcensätze in Terraform HCL-Code und -Zustand mit einem einzigen Befehl. Mit Azure Export für Terraform können Sie einen vordefinierten Zu exportierenden Bereich angeben. Der Bereich kann so präzise wie eine einzelne Ressource sein. Sie können auch eine Ressourcengruppe und die zugehörigen geschachtelten Ressourcen exportieren. Schließlich können Sie ein gesamtes Abonnement exportieren.
  • Überprüfen Sie die bereits vorhandene Infrastruktur mit allen verfügbar gemachten Eigenschaften. Unabhängig davon, ob Sie eine neu veröffentlichte Ressource erlernen oder ein Problem in der Produktion untersuchen, unterstützt Azure Export für Terraform einen schreibgeschützten Export mit der Option, alle konfigurierbaren Ressourceneigenschaften verfügbar zu machen.
  • Befolgen Sie den Plan/wenden Sie den Workflow an, um die Nicht-Terraform-Infrastruktur in Terraform zu integrieren. Exportieren Sie HCL-Code, prüfen Sie Nicht-Terraform-Ressourcen und integrieren Sie sie einfach in Ihre Produktionsinfrastruktur und Remote-Back-Ends.

Installation

Auf der Seite "Azure Export für Terraform GitHub " werden Versionen des Tools mit Links zur Installation für verschiedene Plattformen (Windows MSIs, Homebrew und Linux-Installationen) und der Quellcode aufgeführt.

Verwendung

Am abstrahiertsten wird Azure Export wie folgt aufgerufen:

aztfexport [command] [option] <scope>

Der Bereich ändert sich je nach ausgeführter Befehlsmenge, ebenso wie die verfügbaren Optionskennzeichnungen. Es gibt drei Befehle, die basierend auf dem, was Sie exportieren möchten, verwendet werden sollten:

Aufgabe Beschreibung Beispiel
Exportieren sie eine einzelne Ressource. Um eine einzelne Ressource zu exportieren, geben Sie die Azure resourceID an, die der Ressource zugeordnet ist. aztfexport resource [option] <resource id>
Exportieren einer Ressourcengruppe. Geben Sie den Namen der Ressourcengruppe an, um eine Ressourcengruppe (und die zugehörigen geschachtelten Ressourcen) zu exportieren. nicht die ID. aztfexport resource-group [option] <ressourcengruppenname>
Exportieren mithilfe einer Abfrage. Das Tool unterstützt den Export mit einer Azure Resource Graph-Abfrage. aztfexport query [option] <ARG where predicate>

Offenlegung von Datensammlungen

Standardmäßig sammelt Azure Export für Terraform Telemetriedaten. Sie können diesen Vorgang jedoch ganz einfach deaktivieren.

Microsoft aggregiert gesammelte Daten, um Nutzungsmuster zu identifizieren, um häufige Probleme zu identifizieren und die Erfahrung von Azure Export für Terraform zu verbessern. Die Nutzungsdaten tragen beispielsweise dazu bei, Probleme zu identifizieren (z. B. Befehle mit mäßigem Erfolg) und unsere Arbeit zu priorisieren. Azure Export für Terraform sammelt keine privaten oder persönlichen Daten.

Wenn Sie die Datensammlung deaktivieren möchten, führen Sie nach der Installation des Tools den folgenden Befehl aus:

aztfexport config set telemetry_enabled false

Nächste Schritte

Konzepte:

Azure Export for Terraform-Konzepte: Lernen Sie die Workflows von Azure Export für Terraform und ihre bewährten Methoden und aktuellen Designeinschränkungen kennen.

Schnellstartartikel:

Artikel zur Vorgehensweise:

Artikel mit Anleitungen erläutern komplexere Szenarien sowie Erläuterungen und Optionen: