Validar Account Factory para el código Terraform (AFT) localmente

Copie el script bash de ejemplo que se encuentra en la sección Código de este patrón y péguelo en un editor de código.

Nombre el archivo ct_terraform.sh. Luego, guarde el archivo localmente dentro de una carpeta dedicada, como ~/scripts ov~/bin.

Navegue hasta la región de AWS de su implementación de AFT ejecutando el siguiente comando:

export AWS_REGION=<aft_region>

Asegúrese de estar en la cuenta correcta al realizar lo siguiente:

aws code-commit list-repositories

Ejecute el siguiente comando desde el terminal:

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

Nota: Para simplificar, este procedimiento y AFT utilizan únicamente una rama de código principal. Para utilizar la ramificación de código, también puede introducir comandos de ramificación de código aquí. Sin embargo, cualquier cambio aplicado desde la rama no principal se revertirá cuando la automatización de AFT aplique el código desde la rama principal.

A continuación, navegue hasta el directorio clonado ejecutando el siguiente comando:

cd aft-global-customizations/terraform

Con las credenciales de su cuenta de administración de AWS Control Tower, inicie sesión en la Consola de administración de AWS. A continuación, abra la CodePipeline consola de AWS. Asegúrese de que está en la misma Región de AWS donde ha implementado AFT.

En el panel de navegación izquierdo, seleccione Canalizaciones.

Seleccione ##########-customizations-pipeline. (El ########## es la ID de cuenta de AWS que utiliza para ejecutar el código de Terraform de forma local).

Asegúrese de que la ejecución más reciente marcada muestre un valor correcto. Si el valor es diferente, debe volver a invocar las personalizaciones en el proceso de AFT. Para obtener más información, consulte Volver a invocar las personalizaciones en la documentación de AWS Control Tower.

Seleccione el tiempo de ejecución más reciente para ver sus detalles.

En la sección Apply-AFT-Global-Customizations, busque la etapa Apply-Terraform.

Seleccione la sección Detalles de la etapa Apply-Terraform.

Busque el registro de tiempo de ejecución de la etapa Apply-Terraform.

En el registro de tiempo de ejecución, busca la sección que comienza y termina con las siguientes líneas:   “\n\n aft-providers.tf … “\n \n backend.tf”  

Copie el resultado entre estas dos etiquetas y guárdelo como un archivo local con un nombre aft-providers.tfdentro de la carpeta Terraform local (el directorio de trabajo actual de su sesión de terminal).

Ejemplo de sentencia providers.tf generada automáticamente

## 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"
    }
  }
}

En el registro de tiempo de ejecución, busque la sección que comienza y termina con las siguientes líneas: “\n\n tf … “\n \n backup.tf 

Copie el resultado entre estas dos etiquetas y guárdelo como un archivo local con un nombre tf dentro de la carpeta Terraform local (el directorio de trabajo actual de su sesión de terminal).

Navegue hasta el aft-global-customizationsrepositorio clonado ejecutando el siguiente comando:

cd aft-global-customizations/terraform

Nota: Los archivos backend.tf y aft-providers.tf  están en este directorio. El directorio también contiene los archivos de Terraform del aft-global-customizations repositorio.

Incorpore los cambios de código de Terraform que desee probar localmente en los archivos de configuración.

Navegue hasta la carpeta local que contiene el script sh.

Para validar el código de Terraform modificado, ejecute el script ct_terraform.sh ejecutando el siguiente comando:

~/scripts/ct_terraform.sh apply

Nota: Puede ejecutar cualquier comando de Terraform durante este paso. Para ver una lista completa de comandos de Terraform, ejecute el siguiente comando:

terraform --help

Revise el resultado de este comando. A continuación, depure los cambios de código localmente antes de confirmarlos y devolverlos al repositorio AFT.

Para añadir nuevos archivos de configuración de Terraform al repositorio, ejecute el siguiente comando:

git add <filename>

Para confirmar los cambios y enviarlos al repositorio AFT remoto de AWS CodeCommit, ejecute los siguientes comandos:

git commit -a
git push