Visão geral da Exportação do Azure para Terraform
A Exportação do Azure para Terraform é uma ferramenta desenvolvida para ajudar a reduzir o atrito na tradução entre os conceitos do Azure e do Terraform.
Benefícios
A Exportação do Azure para Terraform permite que você:
- Simplifique a migração para o Terraform no Azure. A Exportação do Azure para 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 estado HCL do Terraform com um único comando. A Exportação do Azure para Terraform permite que você especifique um escopo predeterminado para exportar. 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, a Exportação do Azure para Terraform oferece 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 que não é do Terraform ao Terraform. Exporte código HCL, inspecione recursos que não são do Terraform e integre-os facilmente à infraestrutura de produção e back-ends remotos.
Instalação
A página da Exportação do Azure para Terraform no GitHub lista versões da ferramenta com links para instalação em várias plataformas (MSIs do Windows, instalações do Homebrew e Linux) e o código-fonte.
Uso
Em sua forma mais abstrata, a Exportação do Azure é chamada da seguinte maneira:
aztfexport [command] [option] <scope>
O escopo muda dependendo do comando que está sendo executado, assim como o conjunto disponível de sinalizadores de opções. 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 [option] <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 a ID. | aztfexport resource-group [opção] <nome do grupo de recursos> |
| Exportar usando uma consulta. | A ferramenta oferece suporte à exportação com uma consulta do Azure Resource Graph. | aztfexport query [opção] <ARG onde predicado> |
Provedores
Embora o Azure Export seja padronizado para o provedor azurerm, você também pode exportar o provedor AzAPI :
aztfexport [command] --provider-name=azapi [further options] <scope>
Divulgação da coleta de dados
Por padrão, a Exportação do Azure para Terraform coleta dados de telemetria. No entanto, você pode desativar facilmente esse processo.
A Microsoft agrega dados coletados não só para identificar padrões de uso e problemas comuns, mas também para aprimorar a experiência da Exportação do Azure para Terraform. Por exemplo, os dados de uso ajudam a identificar problemas, como comandos com baixo índice de sucesso, e a priorizar o trabalho. A Exportação do Azure para Terraform não coleta dados privados ou pessoais.
Se você quiser desabilitar a coleta de dados, execute o seguinte comando após instalar a ferramenta:
aztfexport config set telemetry_enabled false
Próximas etapas
Conceitos:
Conceitos da Exportação do Azure para Terraform: conheça os fluxos de trabalho da Exportação do Azure para Terraform e suas práticas recomendadas e limitações de design atuais.
Artigos de início rápido:
- Exportar seus primeiros recursos usando a Exportação do Azure para Terraform
- Exportar recursos do Azure para o código HCL usando a Exportação do Azure para Terraform
Artigos de instruções:
Artigos de instruções explicam cenários mais complexos, juntamente com explicações e opções: