Visão geral do Azure Export for Terraform
O Azure Export for Terraform é uma ferramenta projetada para ajudar a reduzir o atrito na tradução entre os conceitos do Azure e do Terraform.
Benefícios
O Azure Export for Terraform permite:
- Simplifique a migração para o Terraform no Azure. O Azure Export for Terraform permite migrar recursos do Azure para o Terraform usando um único comando.
- Exporte conjuntos de recursos especificados pelo usuário para o código e o estado do Terraform HCL com um único comando. O Azure Export for Terraform permite especificar um escopo predeterminado para exportação. O escopo pode ser tão granular quanto um único recurso. Você também pode exportar um grupo de recursos e seus recursos aninhados. Finalmente, você pode exportar uma assinatura inteira.
- Inspecione a infraestrutura preexistente com todas as propriedades expostas. Seja aprendendo um recurso recém-lançado ou investigando um problema na produção, o Azure Export for Terraform dá suporte a uma exportação somente leitura com a opção de expor todas as propriedades de recursos configuráveis.
- Siga o fluxo de trabalho de planejamento/aplicação para integrar a infraestrutura não-Terraform ao Terraform. Exporte código HCL, inspecione recursos que não sejam Terraform e integre-os facilmente à sua infraestrutura de produção e back-ends remotos.
Instalação
A página Azure Export for Terraform GitHub lista versões da ferramenta com links para instalação para várias plataformas (instalações do Windows MSIs, Homebrew e Linux) e o código-fonte.
Utilização
Em sua forma mais abstrata, a Exportação do Azure é chamada da seguinte forma:
aztfexport [command] [option] <scope>
O escopo muda dependendo do comando que está sendo executado, assim como o conjunto disponível de sinalizadores de opção. Há três comandos que devem ser usados com base no que você está tentando exportar:
| Tarefa | Descrição | Exemplo |
|---|---|---|
| Exporte um único recurso. | Para exportar um único recurso, especifique o resourceID do Azure associado ao recurso. | aztfexport resource [opção] <id do recurso> |
| Exportar um grupo de recursos. | Para exportar um grupo de recursos (e seus recursos aninhados), especifique o nome do grupo de recursos; não o ID. | aztfexport resource-group [opção] <nome do grupo de recursos> |
| Exportar usando uma consulta. | A ferramenta dá suporte à exportação com uma consulta do Azure Resource Graph. | aztfexport query [option] <ARG onde predicado> |
Provedores
Embora a Exportação do Azure seja padrão para o azurerm provedor, você também pode exportar o AzAPI provedor:
aztfexport [command] --provider-name=azapi [further options] <scope>
Divulgação da recolha de dados
Por padrão, o Azure Export for Terraform coleta dados de telemetria. No entanto, você pode facilmente desativar esse processo.
A Microsoft agrega dados coletados para identificar padrões de uso, identificar problemas comuns e melhorar a experiência do Azure Export for Terraform. Por exemplo, os dados de uso ajudam a identificar problemas como comandos com baixo sucesso e ajudam a priorizar nosso trabalho. O Azure Export for Terraform não recolhe quaisquer dados privados ou pessoais.
Se você quiser desabilitar a coleta de dados, execute o seguinte comando depois de instalar a ferramenta:
aztfexport config set telemetry_enabled false
Próximos passos
Conceitos:
Conceitos do Azure Export for Terraform: conheça os fluxos de trabalho do Azure Export for Terraform e suas práticas recomendadas e limitações de design atuais.
Artigos de início rápido:
- Exporte seus primeiros recursos usando o Azure Export for Terraform
- Exportar recursos do Azure para código HCL usando o Azure Export for Terraform
Artigos de instruções:
Os artigos de instruções explicam cenários mais complexos, juntamente com explicações e opções: