Información general sobre Azure Export for Terraform
Azure Export for Terraform es una herramienta diseñada para reducir la fricción en la traducción entre los conceptos de Azure y Terraform.
Ventajas
Azure Export for Terraform le permite:
- Facilitar la migración a Terraform en Azure. Azure Export for Terraform permite migrar recursos de Azure a Terraform mediante un solo comando.
- Exportar grupos de recursos especificados por el usuario al código de HCL y el estado de Terraform con un solo comando. Azure Export for Terraform permite indicar un ámbito predeterminado que se va a exportar. El ámbito puede ser tan granular como un único recurso. También puede exportar un grupo de recursos y sus recursos anidados. Por último, puede exportar una suscripción completa.
- Inspeccione la infraestructura preexistente con todas las propiedades expuestas. Tanto si recibe un recurso recién publicado como si examina un problema en producción, Azure Export for Terraform le permite exportar en modo de solo lectura con la opción de exponer todas las propiedades de recursos configurables.
- Siga la planificación o aplique el flujo de trabajo para integrar la infraestructura que no sea de Terraform en Terraform. Exporte el código de HCL, inspeccione los recursos que no son de Terraform e intégrelos fácilmente en la infraestructura de producción y los back-end remotos.
Instalación
En la página de GitHub sobre Azure Export for Terraform figuran las versiones de la herramienta con vínculos a la instalación en varias plataformas (archivos MSI de Windows, Homebrew e instalaciones de Linux) y el código fuente.
Uso
En resumen, Azure Export se llama de la siguiente manera:
aztfexport [command] [option] <scope>
El ámbito cambia en función del comando que se ejecuta, al igual que el conjunto disponible de flags de opciones. Hay tres comandos que se deben usar en función de lo que intente exportar:
| Tarea | Descripción | Ejemplo |
|---|---|---|
| Exportar un único recurso. | Para exportar un único recurso, indique el resourceID de Azure asociado al recurso. | aztfexport resource [opción] <ID de recurso> |
| Exportar un grupo de recursos. | Para exportar un grupo de recursos (y sus recursos anidados), indique el nombre del grupo de recursos, no el ID. | aztfexport resource-group [opción] <nombre de grupo de recursos> |
| Exportar mediante una consulta. | La herramienta admite la exportación con una consulta de Azure Resource Graph. | aztfexport query [opción] <predicado where de ARG> |
Proveedores
Aunque Azure Export tiene como valor predeterminado el proveedor azurerm, también puede exportar el proveedor AzAPI :
aztfexport [command] --provider-name=azapi [further options] <scope>
Información sobre recopilación de datos
De forma predeterminada, Azure Export for Terraform recopila datos de telemetría. Sin embargo, puede deshabilitar fácilmente este proceso.
Microsoft va acumulando los datos recopilados para identificar patrones de uso con el fin de identificar problemas comunes y mejorar la funcionalidad de Azure Export for Terraform. Por ejemplo, los datos de uso ayudan a identificar problemas tales como los comandos que se usan poco y ayudan a asignar prioridades al trabajo. Azure Export for Terraform no recopila datos personales ni privados.
Si desea deshabilitar la recopilación de datos, ejecute el siguiente comando después de instalar la herramienta:
aztfexport config set telemetry_enabled false
Pasos siguientes
Conceptos:
Conceptos sobre Azure Export for Terraform: Conozca los flujos de trabajo de Azure Export for Terraform y sus procedimientos recomendados y limitaciones de diseño actuales.
Artículos de inicio rápido:
- Exportación de los primeros recursos mediante Azure Export for Terraform
- Exportación de recursos de Azure al código de HCL mediante Azure Export for Terraform
Artículos de procedimientos:
En los artículos de procedimientos se explican los casos más complejos junto con explicaciones y opciones: