Share via

Visão geral da exportação do Azure para Terraform

  • Artigo

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 que você:

  • 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 da HCL Terraform com um único comando. O Azure Export for 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, o Azure Export for Terraform oferece suporte a uma exportação somente leitura com a opção de expor todas as propriedades de recurso 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 não-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 (MSIs do Windows, Homebrew e instalações do Linux) e o código-fonte.

Uso

Em seu aspecto mais abstrato, 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ção. Há três comandos que devem ser usados com base no que você está tentando exportar:

Tarefa Descrição Exemplo
Exportar um único recurso. Para exportar um único recurso, especifique o ID de recurso do Azure associado ao recurso. ID do recurso AztfExport [Option] <>
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 Gráfico de Recursos do Azure. aztfexport query [option] <ARG onde predicado>

Divulgação da coleta 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 para 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 índice de sucesso, e a priorizar o trabalho. O Azure Export for Terraform não coleta 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óximas etapas

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:

Artigos de instruções:

Os artigos de instruções explicam cenários mais complexos, juntamente com explicações e opções: