Migre do provider v1.x para o v2.0

Você pode mover uma configuração Terraform e o state dela do Azion Terraform Provider v1.x, que chama a Azion API v3, para o v2.0, que chama a Azion API v4. Para manter uma configuração na v1.x, consulte Azion Terraform Provider v1.x (API v3).

O provider v2.0 é uma versão major. Ele adiciona recursos e remove os descontinuados para corresponder à Azion API v4, então uma configuração v1.x não roda na v2.0 sem mudanças.

Pré-requisitos

Terraform 1.0 ou posterior.
Uma conta Azion com acesso à Azion API v4.
Um personal token com as permissões de que a sua configuração precisa.
Uma lista dos recursos que a sua configuração gerencia, com os que a v2.0 remove ou renomeia marcados. As tabelas em Mudanças de recursos na v2.0, nesta página, indicam esses recursos.

Faça backup da configuração e do state

A migração remove recursos do state do Terraform e os importa novamente com outros tipos. Guarde uma cópia dos arquivos de configuração e do state para poder voltar à configuração da v1.x.

Para fazer backup do projeto e do state:

Shell

01# Create a backup directory

02mkdir -p ~/terraform-backup

04# Copy your configuration files

05cp -r ./your-terraform-project ~/terraform-backup/

07# Back up the state file (if using local state)

08cp terraform.tfstate ~/terraform-backup/

09cp terraform.tfstate.backup ~/terraform-backup/ 2>/dev/null || true

11# If using remote state, download a local copy

12terraform state pull > ~/terraform-backup/terraform.tfstate

O diretório ~/terraform-backup contém os arquivos de configuração e uma cópia do state.

Fixe o provider na v1.x

Cada linha de versões do provider chama uma versão da Azion API:

Versão do provider	Versão da API	Status
1.41.0 e anteriores	API v3	Descontinuado
2.0.0 e posteriores	API v4	Atual

A versão 1.41.0 é a última versão v1.x. Para continuar usando a v1.x enquanto prepara a migração, fixe o provider nessa versão:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "1.41.0"

06 }

07 }

08}

O próximo terraform init mantém o provider na versão 1.41.0.

Atenção — O provider 1.41.0 e as versões anteriores não recebem atualizações nem correções de bugs. Planeje a migração para a v2.0.

Mudanças de recursos na v2.0

O provider v2.0 remove, renomeia e adiciona recursos. As quatro tabelas abaixo listam cada recurso e data source da v1.x com a contraparte dele na v2.0. Para todos os argumentos de um recurso da v2.0, consulte Terraform Registry.

Recursos removidos

O provider v2.0 não tem recurso nem data source com estes nomes da v1.x:

Nome na v1.x (API v3)	Substituto na v2.0
`azion_domain`	`azion_workload` e `azion_workload_deployment`
`azion_domains` (data source)	`azion_workloads` (data source)
`azion_edge_application_origin`	`azion_connector`
`azion_edge_applications_origins` (data source)	`azion_connectors` (data source)

Recursos renomeados

Estes recursos da v1.x mantêm a mesma função na v2.0 com outro nome. Os nomes da v2.0 seguem os nomes atuais dos produtos:

Nome na v1.x (API v3)	Nome na v2.0
`azion_edge_function`	`azion_function`
`azion_edge_functions` (data source)	`azion_functions` (data source)
`azion_edge_application_main_setting`	`azion_application_main_setting`
`azion_edge_application_cache_setting`	`azion_application_cache_setting`
`azion_edge_application_rule_engine`	`azion_application_rule_engine`
`azion_edge_application_edge_functions_instance`	`azion_application_functions_instance`
`azion_edge_firewall_main_setting`	`azion_firewall_main_setting`
`azion_edge_firewall_edge_functions_instance`	`azion_firewall_functions_instance`

Recursos adicionados na v2.0

O provider v2.0 adiciona quatro recursos:

Recurso	O que gerencia
`azion_workload`	Workloads. Substitui `azion_domain` em conjunto com `azion_workload_deployment`.
`azion_workload_deployment`	Deployments de workloads.
`azion_connector`	Connectors. Substitui `azion_edge_application_origin`.
`azion_custom_page`	Custom pages. O provider v1.x não tem recurso para elas.

Recursos inalterados

Estes recursos mantêm os nomes da v1.x na v2.0:

Recurso	O que gerencia
`azion_intelligent_dns_zone`	Zonas DNS
`azion_intelligent_dns_record`	Registros DNS
`azion_intelligent_dns_dnssec`	Configurações de DNSSEC
`azion_network_list`	Network lists
`azion_waf_rule_set`	Conjuntos de regras do WAF
`azion_digital_certificate`	Certificados digitais
`azion_environment_variable`	Variáveis de ambiente

Atualize o provider para a v2.0

A atualização exige duas mudanças: a restrição de versão na configuração e o provider instalado no projeto.

Para mudar a restrição de versão, defina version como 2.0.0 no bloco required_providers:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "2.0.0"

06 }

07 }

08}

Para baixar o provider 2.0.0, execute:

terraform init -upgrade

O Terraform instala o provider 2.0.0 no projeto.

Remova os recursos da v1.x do state

Remova os recursos descontinuados da v1.x do state do Terraform antes de importá-los com os tipos da v2.0.

Para remover as entradas de domínio, origin e function do state do Terraform:

Shell

01# Remove domain resources

02terraform state rm azion_domain.example

04# Remove origin resources

05terraform state rm azion_edge_application_origin.example

07# Remove function resources (will be recreated as azion_function)

08terraform state rm azion_edge_function.example

Substitua example pelo nome que cada recurso tem na sua configuração. O state deixa de listar esses recursos, que continuam na sua conta Azion.

Atualize os arquivos de configuração

Reescreva cada recurso removido ou renomeado nos seus arquivos .tf com o tipo da v2.0. Os pares abaixo mostram um bloco da v1.x e o bloco da v2.0 que o substitui.

Substitua um domínio por um workload

Na v1.x, um recurso azion_domain gerenciava todo o ciclo de vida do domínio. Na v2.0, azion_workload contém a definição e azion_workload_deployment contém o deployment. Para todos os argumentos dos dois recursos, consulte Recursos de Workloads.

A configuração da v1.x:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "1.41.0"

06 }

07 }

08}

10provider "azion" {

11 api_token = var.api_token

12}

14# Domain resource (v1.x)

15resource "azion_domain" "example" {

16 name = "my-domain"

17 cname_access_only = false

18 digital_certificate = 1234

19 edge_application = 5678

20 is_active = true

22 # Domain name binding

23 domain_name = "example.com"

24}

A configuração da v2.0:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "2.0.0"

06 }

07 }

08}

10provider "azion" {

11 api_token = var.api_token

12}

14# Workload resource (v2.0)

15resource "azion_workload" "example" {

16 name = "my-workload"

18 # Workload configuration options

19 # Refer to the Terraform Registry documentation for the complete options

20}

22# Workload deployment (v2.0)

23resource "azion_workload_deployment" "example" {

24 workload_id = azion_workload.example.id

26 # Deployment configuration

27 # Refer to the Terraform Registry documentation for the complete options

28}

Substitua uma origin por um connector

Na v1.x, uma origin pertencia a uma aplicação e recebia o edge_application_id dela. Na v2.0, um connector é um recurso independente. Para todos os argumentos de azion_connector, consulte Recursos de Connectors.

A configuração da v1.x:

HCL

01# Origin (v1.x)

02resource "azion_edge_application_origin" "example" {

03 edge_application_id = azion_edge_application_main_setting.example.id

05 name = "my-origin"

06 origin_type = "single_origin"

07 origin_address = "origin.example.com"

08 origin_protocol = "https"

09 origin_path = "/api"

10 host_header = "origin.example.com"

12 # Connection settings

13 connection_timeout = 30

14 read_timeout = 60

15}

A configuração da v2.0:

HCL

01# Connector (v2.0)

02resource "azion_connector" "example" {

03 name = "my-connector"

05 # Connector configuration

06 # Refer to the Terraform Registry documentation for the complete options

08 # Example configuration

09 origin = {

10 address = "origin.example.com"

11 protocol = "https"

12 path = "/api"

13 }

15 # Connection settings

16 connection_timeout = 30

17 read_timeout = 60

18}

Renomeie um recurso de function

O recurso de function mantém os mesmos argumentos na v2.0: name, active, code e json_args. Só o tipo do recurso muda, de azion_edge_function para azion_function.

A configuração da v1.x:

HCL

01# Function (v1.x)

02resource "azion_edge_function" "example" {

03 name = "my-function"

04 active = true

05 code = file("${path.module}/function.js")

07 # Function arguments

08 json_args = jsonencode({

09 key = "value"

10 })

11}

A configuração da v2.0:

HCL

01# Function (v2.0)

02resource "azion_function" "example" {

03 name = "my-function"

04 active = true

05 code = file("${path.module}/function.js")

07 # Function arguments

08 json_args = jsonencode({

09 key = "value"

10 })

11}

Migre uma configuração completa

Uma configuração com uma aplicação, uma origin, um domínio e uma function muda em quatro pontos: o main setting da aplicação recebe o nome da v2.0, um connector substitui a origin, um workload e um deployment substituem o domínio e a function recebe o tipo da v2.0. Para os recursos de aplicação, consulte Recursos de Applications.

A configuração da v1.x:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "1.41.0"

06 }

07 }

08}

10provider "azion" {

11 api_token = var.api_token

12}

14# Application (v1.x)

15resource "azion_edge_application_main_setting" "app" {

16 name = "my-application"

17}

19# Origin

20resource "azion_edge_application_origin" "origin" {

21 edge_application_id = azion_edge_application_main_setting.app.id

22 name = "my-origin"

23 origin_type = "single_origin"

24 origin_address = "origin.example.com"

25}

27# Domain

28resource "azion_domain" "domain" {

29 name = "my-domain"

30 edge_application = azion_edge_application_main_setting.app.id

31 domain_name = "example.com"

32}

34# Function (v1.x)

35resource "azion_edge_function" "func" {

36 name = "my-function"

37 active = true

38 code = file("${path.module}/function.js")

39}

A configuração da v2.0:

HCL

01terraform {

02 required_providers {

03 azion = {

04 source = "aziontech/azion"

05 version = "2.0.0"

06 }

07 }

08}

10provider "azion" {

11 api_token = var.api_token

12}

14# Application

15resource "azion_application_main_setting" "app" {

16 name = "my-application"

17}

19# Connector (replaces origin)

20resource "azion_connector" "connector" {

21 name = "my-connector"

22 # Connector configuration

23}

25# Workload (replaces domain)

26resource "azion_workload" "workload" {

27 name = "my-workload"

28}

30# Workload deployment

31resource "azion_workload_deployment" "deployment" {

32 workload_id = azion_workload.workload.id

33 # Deployment configuration

34}

36# Function (renamed)

37resource "azion_function" "func" {

38 name = "my-function"

39 active = true

40 code = file("${path.module}/function.js")

41}

Importe os recursos com os tipos da v2.0

Os recursos que você removeu do state continuam na sua conta Azion. Importe cada um com o tipo de recurso da v2.0 usando terraform import <type>.<name> <id>.

Para importar o workload, o connector e a function:

Shell

01# Import workloads

02terraform import azion_workload.example <workload_id>

04# Import connectors

05terraform import azion_connector.example <connector_id>

07# Import functions

08terraform import azion_function.example <function_id>

Substitua cada ID pelo ID do recurso na Azion API v4. Um recurso da API v3 pode ter outro ID na API v4, então consulte os IDs no Azion Console. O state lista os recursos importados com os tipos da v2.0.

Revise e aplique o plano

Um plano mostra o que o Terraform muda antes que qualquer mudança aconteça na sua conta.

Para visualizar as mudanças, execute:

terraform plan

Na saída do plano, confirme três pontos:

Nenhum recurso que você espera manter é destruído.
Os recursos que você espera criar aparecem no plano.
Os atributos correspondem aos argumentos da v2.0 que você definiu na configuração.

Para aplicar as mudanças, execute o comando primeiro em um ambiente de teste:

terraform apply

O Terraform gerencia os recursos pelo provider 2.0.0 e pela Azion API v4. Para erros durante a migração, consulte Solucionar problemas do Terraform Provider.

Faça a limpeza após a migração

Depois do apply, conclua a migração no seu projeto:

Confirme que os recursos migrados funcionam na sua conta Azion.
Atualize os pipelines de CI/CD que executam o Terraform.
Remova o código da v1.x que a configuração não usa mais.
Atualize a documentação do projeto e informe a sua equipe sobre a mudança.
Arquive os backups quando a migração estiver confirmada.

O projeto roda no provider v2.0, sem nenhum recurso da v1.x na configuração ou no state.

Próximos passos

Solucionar problemas do Terraform ProviderCorrija erros de versão, de tipo de recurso, de state e de importação.Recursos de WorkloadsDefina todos os argumentos de um workload e dos deployments dele.Recursos de ConnectorsConfigure o connector que substitui uma origin.Recursos de ApplicationsGerencie os recursos de aplicação que a v2.0 renomeou.