Localstack을 활용한 AWS 인프라 통합 테스트

AWS의 SES나 S3 같은 서비스를 사용하는 로직을 검증할 때, 실제 AWS 리소스를 사용하면 비용 발생, Secret 관리의 어려움, 테스트 간 독립성 저해라는 문제가 발생할 수 있다.

이를 해결하기 위해 AWS API를 시뮬레이션하는 Localstack을 도입했다. Localstack은 Docker 컨테이너 형태로 실행되며, 로컬 및 CI 환경에서 독립적인 테스트 환경을 구축할 수 있게 해준다.

테스트 실행 방식으로는 Testcontainers와 Docker Compose를 비교 검토했다.

• Testcontainers: 테스트마다 컨테이너 생명주기를 관리하여 독립성을 보장하지만, 단건 테스트 속도가 느리고 대량의 컨테이너 실행 시 부하가 발생할 수 있다.
• Docker Compose: 단일 Localstack을 미리 실행해두는 방식으로, 테스트 실행 속도가 빠르고 관리가 용이하여 최종적으로 이 방식을 채택했다.

효율적인 테스트를 위해 초기화 스크립트(/docker-entrypoint-initaws.d)를 활용하여 S3 버킷 생성이나 SES 이메일 인증과 같은 사전 작업을 자동화하여 구성했다.