Vue d’ensemble d’Azure Export pour Terraform

Azure Export pour Terraform est un outil conçu pour réduire les frictions entre les concepts Azure et Terraform.

Avantages

Azure Export pour Terraform vous permet de :

  • Simplifiez la migration vers Terraform sur Azure. Azure Export pour Terraform vous permet de migrer des ressources Azure vers Terraform à l’aide d’une seule commande.
  • Exportez des ensembles de ressources spécifiés par l’utilisateur vers le code et l’état Terraform HCL avec une seule commande. Azure Export pour Terraform vous permet de spécifier une étendue prédéterminée à exporter. L’étendue peut être aussi granulaire qu’une seule ressource. Vous pouvez également exporter un groupe de ressources et ses ressources imbriquées. Enfin, vous pouvez exporter un abonnement entier.
  • Inspectez l’infrastructure préexistante avec toutes les propriétés exposées. Qu’il s’agisse d’apprendre une ressource nouvellement publiée ou d’examiner un problème en production, Azure Export pour Terraform prend en charge une exportation en lecture seule avec l’option permettant d’exposer toutes les propriétés de ressources configurables.
  • Suivez le plan/appliquez le flux de travail pour intégrer une infrastructure non Terraform à Terraform. Exportez du code HCL, inspectez les ressources non Terraform et intégrez-les facilement à votre infrastructure de production et aux back-ends distants.

Installation

La page Azure Export pour Terraform GitHub répertorie les versions de l’outil avec des liens vers l’installation pour différentes plateformes (MSIs Windows, Homebrew et installations Linux) et le code source.

Utilisation

À son plus abstrait, Azure Export est appelé comme suit :

aztfexport [command] [option] <scope>

L’étendue change en fonction de la commande en cours d’exécution, comme le font l’ensemble disponible d’indicateurs d’option. Il existe trois commandes qui doivent être utilisées en fonction de ce que vous essayez d’exporter :

Tâche Description Exemple
Exportez une ressource unique. Pour exporter une seule ressource, spécifiez l’ID de ressource Azure associé à la ressource. aztfexport resource [option] <resource ID>
Exporter un groupe de ressources. Pour exporter un groupe de ressources (et ses ressources imbriquées), spécifiez le nom du groupe de ressources ; et non l’ID. aztfexport resource-group [option] <nom du groupe de ressources>
Exporter à l’aide d’une requête. L’outil prend en charge l’exportation avec une requête Azure Resource Graph. aztfexport query [option] <ARG where predicate>

Divulgation de collecte de données

Par défaut, Azure Export pour Terraform collecte les données de télémétrie. Toutefois, vous pouvez facilement désactiver ce processus.

Microsoft agrège les données collectées pour identifier les modèles d’utilisation afin d’identifier les problèmes courants et d’améliorer l’expérience d’Azure Export pour Terraform. Par exemple, les données d’utilisation permettent d’identifier des problèmes, tels que des commandes dont le niveau de réussite est faible, et nous aident à définir les priorités dans notre travail. Azure Export pour Terraform ne collecte aucune donnée privée ou personnelle.

Si vous souhaitez désactiver la collecte de données, exécutez la commande suivante après avoir installé l’outil :

aztfexport config set telemetry_enabled false

Étapes suivantes

Concepts :

Concepts d’Azure Export pour Terraform : découvrez les flux de travail d’Azure Export pour Terraform et ses meilleures pratiques et ses limitations de conception actuelles.

Articles de démarrage rapide :

Articles pratiques :

Les articles pratiques expliquent des scénarios plus complexes, ainsi que des explications et des options :