Panoramica dell'esportazione di Azure per Terraform
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> |
Provider
Anche se l'esportazione di Azure è predefinita per il azurerm provider, è anche possibile esportare il AzAPI provider:
aztfexport [command] --provider-name=azapi [further options] <scope>
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:
- Esportare le prime risorse usando Esportazione di Azure per Terraform
- Esportare le risorse di Azure nel codice HCL usando Esportazione di Azure per Terraform
Procedure:
Gli articoli sulle procedure illustrano scenari più complessi insieme a spiegazioni e opzioni: