Panoramica dell'esportazione di Azure per Terraform

  • Articolo

Esportazione di Azure per Terraform è uno strumento progettato per ridurre l'attrito tra i concetti di Azure e Terraform.

Vantaggi

Esportazione di Azure per Terraform consente di:

  • Semplificare la migrazione a Terraform in Azure. Esportazione di Azure per Terraform consente di eseguire la migrazione delle risorse di Azure a Terraform usando un singolo comando.
  • Esportare set di risorse specificati dall'utente in codice HCL terraform e stato con un singolo comando. Esportazione di Azure per Terraform consente di specificare un ambito predeterminato da esportare. L'ambito può essere granulare come una singola risorsa. È anche possibile esportare un gruppo di risorse e le relative risorse annidate. Infine, è possibile esportare un'intera sottoscrizione.
  • Esaminare l'infrastruttura preesistente con tutte le proprietà esposte. Se si apprende una risorsa appena rilasciata o si analizza un problema nell'ambiente di produzione, Esportazione di Azure per Terraform supporta un'esportazione di sola lettura con l'opzione per esporre tutte le proprietà configurabili delle risorse.
  • Seguire il flusso di lavoro piano/applicazione per integrare l'infrastruttura non Terraform in Terraform. Esportare il codice HCL, esaminare le risorse non Terraform e integrarle facilmente nell'infrastruttura di produzione e nei back-end remoti.

Installazione

La pagina Esportazione di Azure per Terraform GitHub elenca le versioni dello strumento con collegamenti all'installazione per varie piattaforme (msi Windows, installazioni Homebrew e Linux) e il codice sorgente.

Utilizzo

Al massimo astratto, l'esportazione di Azure viene chiamata come segue:

aztfexport [command] [option] <scope>

L'ambito cambia a seconda del comando in esecuzione, come nel set disponibile di flag di opzione. Esistono tre comandi che devono essere usati in base a ciò che si sta tentando di esportare:

Attività Descrizione Esempio
Esportare una singola risorsa. Per esportare una singola risorsa, specificare l'ID risorsa di Azure associato alla risorsa. aztfexport resource [option] <resource id>
Esportare un gruppo di risorse. Per esportare un gruppo di risorse e le relative risorse annidate, specificare il nome del gruppo di risorse; non l'ID. aztfexport resource-group [opzione] <nome gruppo di risorse>
Esportare usando una query. Lo strumento supporta l'esportazione con una query di Azure Resource Graph. aztfexport query [option] <ARG where predicate>

Divulgazione di raccolta dati

Per impostazione predefinita, Esportazione di Azure per Terraform raccoglie i dati di telemetria. Tuttavia, è possibile disabilitare facilmente questo processo.

Microsoft aggrega i dati raccolti per identificare i modelli di utilizzo per identificare i problemi comuni e migliorare l'esperienza di Esportazione di Azure per Terraform. Ad esempio, i dati di utilizzo consentono di identificare problemi come i comandi con esito negativo e aiutano a classificare in ordine di priorità il lavoro. Esportazione di Azure per Terraform non raccoglie dati privati o personali.

Se si vuole disabilitare la raccolta dati, eseguire il comando seguente dopo l'installazione dello strumento:

aztfexport config set telemetry_enabled false

Passaggi successivi

Concetti:

Concetti relativi all'esportazione di Azure per Terraform: informazioni sui flussi di lavoro di Esportazione di Azure per Terraform e sulle procedure consigliate e sulle limitazioni di progettazione correnti.

Articoli di avvio rapido:

Procedure:

Gli articoli sulle procedure illustrano scenari più complessi insieme a spiegazioni e opzioni: