Usar o Terraform como uma ferramenta de infraestrutura como código para a CLI do Desenvolvedor do Azure

A CLI do Desenvolvedor do Azure (azd) dá suporte a vários provedores de IaC (infraestruturas como código), incluindo:

• Bicep
• Terraform

Por padrão, azd pressupõe o Bicep como o provedor de IaC. Consulte o artigo Comparando o Terraform e o Bicep para obter ajuda para decidir qual provedor de IaC é melhor para seu projeto.

Pré-requisitos

• Instalar e configurar o Terraform
• Instale e faça logon na CLI do Azure (v 2.38.0+)
• Examine o diagrama de arquitetura e os recursos do Azure que você implantará no modelo Terraform Node.js ou Python.

Configurar o Terraform como o provedor de IaC

1. Abra o azure.yaml arquivo encontrado na raiz do seu projeto e verifique se você tem as seguintes linhas para substituir o padrão, que é Bicep:

   infra:
     provider: terraform
   

2. Adicione todos os seus arquivo .tf ao infra diretório encontrado na raiz do seu projeto.

3. Execute azd up.

azd pipeline config para Terraform

O Terraform armazena o estado sobre sua infraestrutura e configuração gerenciadas. Devido a esse arquivo de estado, você precisa habilitar o estado remoto antes de executar azd pipeline config para configurar seu pipeline de implantação no GitHub.

Por padrão, azd pressupõe o uso do arquivo de estado local. Se você executou azd up antes de habilitar o estado remoto, precisará executar azd down e alternar para o arquivo de estado remoto.

Estado local vs. remoto

O Terraform usa dados persistentes de estado para acompanhar os recursos que gerencia.

Cenários para habilitar o estado remoto:

• Para permitir o acesso compartilhado aos dados de estado e permitir que várias pessoas trabalhem juntas nessa coleção de recursos de infraestrutura
• Para evitar a exposição de informações confidenciais incluídas no arquivo de estado
• Para diminuir a chance de exclusão inadvertida devido ao armazenamento do estado localmente

Habitar estado remoto

1. Certifique-se de configurar uma conta de armazenamento de estado remoto.

2. Adicione um novo arquivo chamado provider.conf.json na infra pasta.

   {
       "storage_account_name": "${RS_STORAGE_ACCOUNT}",
       "container_name": "${RS_CONTAINER_NAME}",
       "key": "azd/azdremotetest.tfstate",
       "resource_group_name": "${RS_RESOURCE_GROUP}"
   }
   

3. Atualização provider.tf encontrada na pasta infra para definir o back-end como remoto

   # Configure the Azure Provider
   terraform {
     required_version = ">= 1.1.7, < 2.0.0"
     backend "azurerm" {
     }
   

4. Execute azd env set <key> <value> para adicionar a configuração no .env arquivo. Por exemplo:

   azd env set RS_STORAGE_ACCOUNT your_storage_account_name
   azd env set RS_CONTAINER_NAME your_terraform_container_name
   azd env set RS_RESOURCE_GROUP your_storage_account_resource_group
   

5. Execute o próximo comando azd de acordo com seu fluxo de trabalho normal. Quando o estado remoto é detectado, azd inicializa o Terraform com a configuração de back-end configurada.

6. Para compartilhar o ambiente com colegas de equipe, certifique-se de que eles sejam executados azd env refresh -e <environmentName> para atualizar as configurações do ambiente no sistema local e execute a Etapa 4 para adicionar a configuração no arquivo .env.

Confira também

• Saiba mais sobre a dependência do Terraform na CLI do Azure.
• Para obter mais informações sobre o estado remoto, consulte armazenar o estado do Terraform no Armazenamento do Azure.
• Modelo: Aplicativo Web React com API Node.js e MongoDB (Terraform) no Azure

Próximas etapas