Übersicht über Azure Export for Terraform
Azure Export for Terraform ist ein Tool, das dazu dient, Probleme bei der Übersetzung zwischen Azure- und Terraform-Konzepten zu reduzieren.
Vorteile
Azure Export for Terraform ermöglicht Ihnen Folgendes:
- Vereinfachen Sie die Migration zu Terraform auf Azure. Mit Azure Export for Terraform können Sie Azure-Ressourcen mithilfe eines einzigen Befehls nach Terraform migrieren.
- Exportieren Sie benutzerdefinierte Ressourcensätze mit einem einzigen Befehl in Terraform HCL-Code und -Status. Mit Azure Export for Terraform können Sie einen vorgegebenen Umfang für den Export angeben. Der Umfang kann so detailliert sein wie eine einzelne Ressource. Sie können auch eine Ressourcengruppe und ihre verschachtelten 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 kennenlernen oder ein Problem in der Produktion untersuchen, unterstützt Azure Export for 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 eine 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 GitHub-Seite Azure Export for Terraform werden Versionen des Tools mit Links zur Installation für verschiedene Plattformen (Windows MSIs-, Homebrew- und Linux-Installationen) und der Quellcode aufgeführt.
Verbrauch
In seiner abstraktesten Form wird Azure Export wie folgt aufgerufen:
aztfexport [command] [option] <scope>
Der Umfang sowie die verfügbaren Optionsflags ändern sich je nach ausgeführtem Befehl. 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] <Ressourcen-ID> |
| Exportieren Sie eine Ressourcengruppe. | Um eine Ressourcengruppe (und ihre verschachtelten Ressourcen) zu exportieren, geben Sie den Namen der Ressourcengruppe an, nicht die ID. | aztfexport resource-group [option] <Ressourcengruppenname> |
| Exportieren Sie mithilfe einer Abfrage. | Das Tool unterstützt den Export mit einer Azure Resource Graph-Abfrage. | aztfexport query [option] <ARG where-Prädikat> |
Anbieter
Während Azure Export standardmäßig den Anbieter azurerm verwendet, können Sie den AzAPI Anbieter auch exportieren:
aztfexport [command] --provider-name=azapi [further options] <scope>
Offenlegung von Datensammlungen
Standardmäßig sammelt Azure Export for Terraform Telemetriedaten. Sie können diesen Vorgang jedoch ganz einfach deaktivieren.
Microsoft aggregiert gesammelte Daten, um Verwendungsmuster zu identifizieren, allgemeine Probleme zu ermitteln und die Benutzerfreundlichkeit von Azure Export for 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 for 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 for Terraform und ihre bewährten Methoden und aktuellen Designeinschränkungen kennen.
Schnellstartartikel:
- Exportieren Ihrer ersten Ressourcen mithilfe von Azure Export for Terraform
- Exportieren von Azure-Ressourcen in HCL-Code mithilfe von Azure Export for Terraform
Gewusst-wie-Artikel:
Artikel mit Anleitungen erläutern komplexere Szenarien sowie Erläuterungen und Optionen: