Azion Terraform Provider v1.x (API v3)
Documentação legado para Azion Terraform Provider v1.x, compatível com Azion API v3. Para novos projetos, use Terraform Provider v2.0 com API v4.
Versão 1.x está obsoleta. Esta documentação é para Terraform Provider v1.x (API v3), que não recebe mais atualizações. Para novos projetos ou para acessar os recursos mais recentes, use Terraform Provider v2.0 com API v4.
Consulte o Guia de Migração para atualizar da v1.x para v2.0.
O Terraform é uma ferramenta de infraestrutura como código que possibilita gerenciar sua infraestrutura de forma eficiente por meio de código. Os arquivos criados para gerenciar sua infraestrutura podem ser reutilizados, versionados e compartilhados, ajudando você a ter um fluxo de trabalho consistente para provisionar e gerenciar toda a sua infraestrutura ao longo de seu ciclo de vida.
Como funciona o Azion Terraform Provider?
O Terraform funciona baseado em provedores. Um provedor é responsável por gerenciar o ciclo de vida de um tipo de recurso específico. Os provedores são implementados como plugins, que podem ser carregados no Terraform durante a sua execução.
Azion Terraform Provider é um projeto de código aberto, registrado em Terraform Registry. Através do Azion SDK (Go), o provedor se comunica com as APIs da Azion para que você possa gerenciar sua infraestrutura hospedada na plataforma da Azion, localmente, como código.
Processo
Terraform Core - O Terraform Core se comunica com o Azion Terraform Provider.
Nota: você deve ter o Terraform instalado em seu ambiente de desenvolvimento. Veja como instalá-lo aqui.
Azion Terraform Provider - Construído em Go, ele se comunica com o Azion SDK, também em Go.
Azion SDK (Go) - Comunica-se com as APIs Azion.
Primeiros passos
Em seu arquivo .tf, você deve definir o Provedor Azion Terraform como o provedor e definir sua versão também, como neste exemplo:
Agora, com o provedor configurado, é recomendado configurar seu [Personal token] (/pt-br/documentacao/produtos/gestao-de-contas/personal-tokens/):
Nota: se o personal token não for fornecido como mostrado acima, um prompt solicitará que você o informe ao tentar executar qualquer comando do Terraform.
Após essas etapas, você estará pronto para começar a gerenciar sua infraestrutura usando o Azion Terraform Provider.
Seu arquivo .tf deverá estar como apresentado abaixo:
Implementação
Migração para v2.0
Para migrar suas configurações Terraform para v2.0 (API v4), consulte o Guia de Migração do Terraform Provider.