Primeiros passos com o Azion Terraform Provider

Este guia orienta você na sua primeira infraestrutura como código com o Azion Terraform Provider.

• Crie um projeto Terraform que exige o provider.
• Forneça o seu personal token ao provider.
• Declare quatro recursos e crie-os com terraform apply.
• Verifique os recursos no state do Terraform.

A configuração declara quatro recursos independentes, e nenhum recurso faz referência a outro:

1. azion_workload cria um workload.
2. azion_connector cria um connector.
3. azion_application_main_setting cria uma aplicação.
4. azion_intelligent_dns_zone cria uma zona ativa no Edge DNS.

Para mais informações sobre o provider, consulte Azion Terraform Provider.

Pré-requisitos

• Terraform 1.0 ou posterior.
• Uma conta Azion. Para criar uma, consulte Criar uma conta.
• Um personal token com as permissões que os seus recursos exigem. Para mais informações, consulte Tokens pessoais.

Instale o Terraform

O Azion Terraform Provider precisa do Terraform Core na sua máquina. Se o Terraform não estiver instalado, instale-o pela página Terraform downloads.

Verifique a versão instalada:

O comando exibe a versão do Terraform Core. O provider precisa da versão 1.0 ou posterior.

Crie o projeto e declare o provider

Crie um diretório para o projeto e acesse-o:

No diretório azion-terraform, crie um arquivo main.tf com o conteúdo a seguir. O bloco required_providers define a origem do provider como aziontech/azion e fixa a versão 2.0.0:

O projeto declara o Azion Terraform Provider em uma versão fixa.

Informe o seu personal token

O provider lê o seu personal token da variável de ambiente AZION_API_TOKEN, que é o método recomendado. No terminal que executa o Terraform, defina a variável. Substitua [TOKEN VALUE] pelo seu personal token:

O bloco provider "azion" em main.tf permanece vazio, e nenhum arquivo do projeto guarda o token.

Para manter o token em uma variável do Terraform, o provider o recebe no argumento api_token. Crie um arquivo variables.tf que declara api_token como uma variável sensível:

Crie um arquivo terraform.tfvars que define a variável. Esse arquivo guarda o token, então adicione terraform.tfvars ao seu arquivo .gitignore:

Em main.tf, substitua o bloco provider "azion" por um bloco que passa a variável ao provider:

O provider recebe o seu personal token, do ambiente ou da variável api_token.

Declare os recursos

No diretório azion-terraform, crie um arquivo resources.tf. Ele declara um workload, um connector, uma aplicação e uma zona DNS:

Substitua example.com pelo domínio da sua zona. O projeto declara quatro recursos que ainda não existem na sua conta.

Crie os recursos

No diretório azion-terraform, inicialize o projeto Terraform:

Revise o plano das mudanças antes de aplicá-las:

Aplique a configuração:

Na pergunta de confirmação, digite yes. O Terraform cria os quatro recursos na sua conta Azion.

Se um comando retornar um erro, consulte Solucionar problemas do Terraform Provider.

Verifique os recursos

Liste os recursos no state do Terraform e, em seguida, exiba os detalhes do workload:

O state guarda os quatro recursos, e terraform state show exibe os atributos que o Terraform armazena para o workload.

Exemplo completo

A configuração a seguir, para a versão 2.0.0 do provider, reúne o provider e três recursos em um único arquivo. Ela declara o próprio provider, então use-a em um diretório vazio, e não ao lado de outro arquivo que declara o provider. Ela lê o token da variável api_token, então precisa de um arquivo variables.tf que declara api_token e de um arquivo terraform.tfvars que define o valor dela. Cada bloco de recurso marca onde ficam os seus outros argumentos:

Próximos passos