Valide o código do Account Factory for Terraform (AFT) localmente

Copie o exemplo de script bash que está na seção Código desse padrão e cole-o em um editor de código.

Nomeie o arquivo ct_terraform.sh. Em seguida, salve o arquivo localmente dentro de uma pasta dedicada, como ~/scripts ou ~/bin.

Navegue até a região da AWS da sua implantação do AFT executando o seguinte comando:

export AWS_REGION=<aft_region>

Verifique se a conta está correta fazendo o seguinte:

aws code-commit list-repositories

Em seu terminal local, execute o seguinte comando:

git clone codecommit::$AWS_REGION://aft-global-customizations 

Observação: para simplificar, esse procedimento e o AFT usam somente uma ramificação de código principal. Para usar a ramificação de código, você também pode inserir comandos de ramificação de código aqui. No entanto, todas as alterações aplicadas da ramificação não principal serão revertidas quando a automação do AFT aplicar o código da ramificação principal.

Em seguida, navegue até o diretório clonado executando o seguinte comando:

cd aft-global-customizations/terraform

Usando as suas credenciais da conta de gerenciamento da AWS Control Tower, faça login no Console de Gerenciamento da AWS. Em seguida, abra o CodePipeline console da AWS. Certifique-se de que você está na mesma região da AWS em que implantou o AFT.

No painel de navegação à esquerda, selecione Pipelines.

Escolha ###########-customizations-pipeline. (O ############ é o ID da conta da AWS que você está usando para executar o código do Terraform localmente).

Certifique-se de que a opção Execução mais recente marcada mostre um valor Bem-sucedido. Se o valor for diferente, você deverá invocar novamente suas personalizações no pipeline do AFT. Para obter mais informações, consulte Reinvocar personalizações na documentação do AWS Control Tower.

Escolha o runtime mais recente para exibir seus detalhes.

Na seção Apply-AFT-Global-Customizations, encontre o estágio Apply-Terraform.

Selecione a seção Detalhes do estágio Apply-Terraform.

Encontre o log de runtime para o estágio Apply-Terraform.

No log de runtime, procure a seção que começa e termina com as seguintes linhas:  “\n\n aft-providers.tf … “\n \n backend.tf”  

Copie a saída entre esses dois rótulos e salve-os como um arquivo local nomeado aft-providers.tf na pasta local do Terraform (o diretório de trabalho atual da sua sessão de terminal).

Exemplo de declaração providers.tf gerada automaticamente

## Autogenerated providers.tf ##
## Updated on: 2022-05-31 16:27:45 ##
provider "aws" {
  region = "us-east-2"
  assume_role {
    role_arn    = "arn:aws:iam::############:role/AWSAFTExecution"
  }
  default_tags {
    tags = {
      managed_by                  = "AFT"
    }
  }
}

No log de runtime, procure a seção que começa e termina com as seguintes linhas: “\n\n tf … “\n \n backup.tf”  

Copie a saída entre esses dois rótulos e salve-os como um arquivo local nomeado tf na pasta local do Terraform (o diretório de trabalho atual da sua sessão de terminal).

Navegue até o aft-global-customizationsrepositório clonado executando o seguinte comando:

cd aft-global-customizations/terraform

Observação: os arquivos backend.tf e aft-providers.tf estão nesse diretório. O diretório também contém arquivos Terraform do aft-global-customizations repositório.

Incorpore as alterações de código do Terraform que você deseja testar localmente nos arquivos de configuração.

Navegue até a pasta local que contém o script sh.

Para validar seu código modificado do Terraform, execute o script ct_terraform.sh executando o seguinte comando:

~/scripts/ct_terraform.sh apply

Observação: você pode executar qualquer comando do Terraform durante esta etapa. Para ver uma lista completa dos comandos do Terraform, execute o seguinte comando:

terraform --help

Revise a saída do comando. Em seguida, depure as alterações no código localmente antes de confirmá-las e enviá-las de volta para o repositório do AFT.

Para adicionar novos arquivos de configuração do Terraform ao repositório, execute o seguinte comando:

git add <filename>

Para confirmar suas alterações e enviá-las para o repositório AFT remoto na AWS CodeCommit, execute os seguintes comandos:

git commit -a
git push