AWS Emulator
lastmod 2026-11-12created 2026-11-121 edits
AWS가 직접 만든 로컬 AWS API 에뮬레이터
About
- 실제 AWS를 호출하지 않고 로컬 머신·개발 서버·CI에서 AWS API를 쓰는 소프트웨어를 테스트하는 도구. AWS 계정이 필요 없고 별도 요금도 없음
- AWS API 엔드포인트를 띄우고 에뮬레이션된 리소스로 응답하는 로컬 프로그램. GUI는 없고 CLI나 SDK가 에뮬레이터를 가리키게 한 뒤 기존 코드를 그대로 실행함
- 서버 모드는 AWS CLI와 모든 SDK에서 사용 가능. 환경 변수로 엔드포인트를 지정하며, 자체 서명 인증서를 쓰는 HTTPS 엔드포인트
127.0.0.1:9297을 제공 - Rust 임베디드 모드는 dev-dependency로 추가해 테스트마다 격리된 인스턴스를 프로세스 안에서 실행. 에뮬레이터의 HTTP 클라이언트를 SDK 클라이언트에 바로 넘기므로 엔드포인트·인증서·환경 변수 설정이 필요 없음
- AI 코딩 에이전트에
aws-emulator스킬을 설치하면 설정을 알아서 해줌 (AWS CLI 2.35.0 이상) - 개발·테스트 전용이며 프로덕션 워크로드나 보안 테스트에는 쓰면 안 됨. 실제 AWS와의 호환성은 릴리스마다 확인해야 함
- 릴리스마다 서비스별 동작 일치 점수를 공개함. 알려진 차이는
issues/things-that-do-not-work/에 정리하고 고쳐지면issues/things-that-now-work/로 옮김. 버그는 GitHub Issues로만 받고 PR은 받지 않음 - 서비스별 Rust 크레이트 구조로, 각 서비스의 Smithy 모델에서 build.rs가 서비스 선언을 생성함.
core/router/가 모든 서비스를 한 엔드포인트로 묶음 - 전체 디버그 빌드는 모든 서비스 크레이트를 컴파일해 target/에 100GB 이상 필요. 임베디드 모드도 첫
cargo test비용이 같아서 CARGO_TARGET_DIR 공유, sccache, 릴리스 커밋 고정을 권장함 - 텔레메트리가 기본으로 켜져 있음. 요청·응답 내용, 코드, 자격 증명, 개인정보는 기록하지 않으며
--telemetry off,EMULATOR_TELEMETRY=off, config.toml로 끌 수 있음 - 리눅스는 RPM·Debian 패키지로 설치하고, 맥·윈도우는 제공되는 Dockerfile로 이미지를 빌드해 실행. CC0 1.0 Universal 라이선스 (vendor/ 코드는 Apache-2.0)
See also
- AWS
- Rust
- LocalStack
- Floci - 무료 오픈소스 로컬 AWS 에뮬레이터
- MiniStack - 무료 오픈소스 로컬 AWS 에뮬레이터
- Kumo - Go로 작성된 경량 AWS 서비스 에뮬레이터
- moto - Mock AWS Services