Validez le code Account Factory pour Terraform (AFT) localement

Copiez l'exemple de script bash qui se trouve dans la section Code de ce modèle et collez-le dans un éditeur de code.

Nommez le fichier ct_terraform.sh. Enregistrez ensuite le fichier localement dans un dossier dédié, tel que ~/scripts ou~/bin.

Accédez à la région AWS de votre déploiement AFT en exécutant la commande suivante :

export AWS_REGION=<aft_region>

Vérifiez que vous êtes dans le bon compte en procédant comme suit :

aws code-commit list-repositories

Dans votre terminal local, exécutez la commande suivante :

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

Remarque : Pour des raisons de simplicité, cette procédure et AFT utilisent uniquement une branche de code principale. Pour utiliser le branchement de code, vous pouvez également saisir des commandes de branchement de code ici. Cependant, toute modification appliquée depuis la branche non principale sera annulée lorsque l'automatisation AFT appliquera le code de la branche principale.

Naviguez ensuite dans le répertoire cloné en exécutant la commande suivante :

cd aft-global-customizations/terraform

À l'aide des informations d'identification de votre compte de gestion AWS Control Tower, connectez-vous à l'AWS Management Console. Ouvrez ensuite la CodePipeline console AWS. Assurez-vous que vous vous trouvez dans la même région AWS où vous avez déployé AFT.

Dans le volet de navigation de gauche, choisissez Pipelines.

Choisissez ##########-customizations-pipeline. (Le ########### est l'ID de compte AWS que vous utilisez pour exécuter le code Terraform localement).

Assurez-vous que l'exécution la plus récente marquée indique une valeur réussie. Si la valeur est différente, vous devez réinvoquer vos personnalisations dans le pipeline AFT. Pour plus d'informations, consultez la section Personnalisations de Re-invoke dans la documentation d'AWS Control Tower.

Choisissez le moteur d'exécution le plus récent pour en afficher les détails.

Dans la section Apply-AFT-Global-Customizations, recherchez le stage Apply-Terraform.

Sélectionnez la section Détails du stage Apply-Terraform.

Trouvez le journal d'exécution du stage Apply-Terraform.

Dans le journal d'exécution, recherchez la section qui commence et se termine par les lignes suivantes : «\n\naft-providers.tf... «\n\nbackend.tf » 

Copiez la sortie entre ces deux étiquettes et enregistrez-la sous forme de fichier local nommé aft-providers.tf dans le dossier Terraform local (le répertoire de travail actuel de votre session de terminal).

Exemple de déclaration providers.tf générée automatiquement

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

Dans le journal d'exécution, recherchez la section qui commence et se termine par les lignes suivantes : «\n\ntf... «\n\nbackup.tf » 

Copiez la sortie entre ces deux étiquettes et enregistrez-la sous forme de fichier local nommé tf dans le dossier Terraform local (le répertoire de travail actuel de votre session de terminal).

Accédez au aft-global-customizationsréférentiel cloné en exécutant la commande suivante :

cd aft-global-customizations/terraform

Remarque : Les fichiers backend.tf et les fichiers aft-providers.tf se trouvent dans ce répertoire. Le répertoire contient également les fichiers Terraform du aft-global-customizations référentiel.

Incorporez les modifications de code Terraform que vous souhaitez tester localement dans les fichiers de configuration.

Accédez au dossier local qui contient le script sh.

Pour valider votre code Terraform modifié, exécutez le ct_terraform.sh script en exécutant la commande suivante :

~/scripts/ct_terraform.sh apply

Remarque : vous pouvez exécuter n'importe quelle commande Terraform au cours de cette étape. Pour voir la liste complète des commandes Terraform, exécutez la commande suivante :

terraform --help

Passez en revue le résultat de la commande. Déboguez ensuite les modifications de code localement avant de les valider et de les renvoyer dans le référentiel AFT.

Pour ajouter de nouveaux fichiers de configuration Terraform au référentiel, exécutez la commande suivante :

git add <filename>

Pour valider vos modifications et les transférer vers le référentiel AFT distant d'AWS CodeCommit, exécutez les commandes suivantes :

git commit -a
git push