Présentation de l’AWS Emulator

L’AWS Emulator est distribué comme binaire autonome ou image Docker. L’exemple montre la construction d’une image aws-emulator:latest d’une taille de 1.24 GB. Au démarrage, le serveur écoute sur le port 9297 et expose deux URL : https://127.0.0.1:9297 pour les API et https://127.0.0.1:9297/__admin/health pour le contrôle de santé. Les logs indiquent que l’émulateur accepte toutes les requêtes (-a off) et écoute sur 0.0.0.0, ce qui expose le service aux machines du réseau si aucune liaison explicite n’est définie. La télémétrie est activée par défaut mais peut être désactivée via EMULATOR_TELEMETRY=off ou le fichier config.toml.

Intégration avec Terraform

Le provider aws est configuré pour rediriger chaque service vers l’émulateur : ec2, lambda, iam, sts, cloudwatch, logs, events et sns pointent tous vers https://127.0.0.1:9297. Plusieurs options désactivent les vérifications classiques (skip_credentials_validation, skip_metadata_api_check, skip_requesting_account_id, skip_region_validation) afin d’éviter les appels vers les services réels. La connexion HTTPS utilise un certificat auto‑signé, d’où le paramètre insecure = true. Pour le service S3, s3_use_path_style = true force le format https://127.0.0.1:9297/bucket-name, compatible avec un seul point d’accès IP.

provider "aws" {
  access_key = var.access_key
  secret_key = var.secret_key
  region     = var.region
  insecure = true
  s3_use_path_style = true
  skip_credentials_validation = true
  skip_metadata_api_check     = true
  skip_requesting_account_id  = true
  skip_region_validation      = true
  endpoints {
    ec2        = var.emulator_endpoint
    lambda     = var.emulator_endpoint
    iam        = var.emulator_endpoint
    sts        = var.emulator_endpoint
    cloudwatch = var.emulator_endpoint
    logs       = var.emulator_endpoint
    events     = var.emulator_endpoint
    sns        = var.emulator_endpoint
  }
}

Après terraform init, la commande terraform plan indique 15 ressources à créer et aucune modification ni destruction, ce qui montre que le plan passe correctement contre l’émulateur.

Exécution d’un plan et limites observées

Le workflow proposé remplace la séquence classique Plan → Apply par Plan → Apply contre l’émulateur → Apply réel. Cette étape supplémentaire allonge légèrement les pipelines CI, mais elle capture les erreurs d’incohérence entre le plan et l’état réel, comme les conflits de noms de bucket ou les mises à jour de version RDS non explicitement autorisées. L’émulateur ne reproduit pas l’intégralité du comportement AWS : certaines API avancées, les limites de quota ou les comportements de latence ne sont pas modélisés. Par conséquent, un plan qui réussit contre l’émulateur peut encore échouer sur le cloud si le service cible possède des contraintes non émulées. Le développeur doit donc garder à l’esprit que l’émulateur fournit une validation fonctionnelle, mais ne remplace pas les tests d’intégration sur l’infrastructure réelle.