Service
GitHub - aws/aws-emulator: AWS Emulator is a local emulator of the AWS APIs.
aws
2026.11.16
·GitHub·by Homin.Lee#Agent#AI#DL#Docker#ML
핵심 포인트
- 1AWS Emulator는 AWS API를 로컬 환경에서 모방하여 클라우드 비용 발생 없이 소프트웨어를 테스트할 수 있게 해주는 개발 및 테스트용 도구입니다.
- 2사용자는 독립 실행형 프로세스 방식이나 애플리케이션 내부에 포함하는 embedded mode를 통해 AWS CLI 및 SDK를 로컬 엔드포인트로 연결하여 손쉽게 사용할 수 있습니다.
- 3이 프로젝트는 원활한 서비스 유지를 위해 기본적으로 익명화된 원격 측정(telemetry) 데이터를 수집하며, 사용자는 설정 파일이나 환경 변수를 통해 이를 쉽게 비활성화할 수 있습니다.
AWS Emulator는 로컬 환경에서 AWS API를 모사하여 실제 AWS 계정이나 비용 없이 소프트웨어를 테스트할 수 있도록 설계된 도구입니다. 이 도구는 개발 서버나 CI(Continuous Integration) 환경에서 독립적인 테스트를 수행하는 데 최적화되어 있습니다.
핵심 방법론 및 기술적 구조
- 운용 모드:
- Local Process: 에뮬레이터를 별도의 로컬 프로세스로 실행하고, AWS CLI나 SDK의 엔드포인트를 에뮬레이터 주소로 변경하여 통신합니다.
- Embedded Mode: 에뮬레이터를 테스트 바이너리에 의존성으로 포함시켜 인-프로세스(in-process)로 실행합니다. 이 방식은 에뮬레이터의 HTTP 클라이언트를 SDK 클라이언트에 직접 주입하여 사용하며, 테스트마다 격리된 인스턴스를 제공합니다.
- 시스템 구조:
- Rust 기반 아키텍처: 워크스페이스 구조를 채택하여 각 AWS 서비스를 개별 Rust Crate()로 관리합니다.
- Smithy Model: 각 서비스는 Smithy 모델(
smithy-model/<name>.json)을 기반으로 와이어 프로토콜(wire protocol)과 요청 라우팅을 정의합니다. - 코드 생성:
build.rs를 통해 모델로부터 서비스 선언을 자동으로 생성하며,service.rs(요청 라우팅 및 거부 정책),state.rs(메모리 내 상태 관리),ops/(각 연산별 로직)로 구성됩니다. - 라우터(Router):
aws-emulator-router가 모든 서비스 크레이트를 하나의 엔드포인트로 통합하여 관리합니다.
- 개발 및 빌드:
- 빌드 시 대규모 디스크 공간(최소 100GB 이상)을 요구하며, 멀티코어 환경에서 효율적인 컴파일이 가능합니다.
- 임베디드 모드 사용 시
CARGO_TARGET_DIR공유 및 캐싱을 통해 빌드 성능을 최적화할 수 있습니다.
- 텔레메트리(Telemetry):
- AWS는 사용 현황 파악을 위해 익명화된 텔레메트리 데이터를 수집합니다.
- 사용자 식별 정보, 코드, 자격 증명, 요청/응답 콘텐츠는 포함되지 않으며, 사용자 설정(커맨드 라인 옵션, 환경 변수
EMULATOR_TELEMETRY, 설정 파일config.toml, 임베디드 API)을 통해 손쉽게 비활성화할 수 있습니다.
- 제약 사항 및 정책:
- 보안: 프로덕션 워크로드나 보안 테스트용으로는 부적합합니다.
- 기여: AI 에이전트를 통한 자동 업데이트 체계를 따르고 있어, 외부의 Pull Request는 허용되지 않습니다.
- 라이선스: 전체적으로
CC0-1.0라이선스를 따르며,vendor/디렉터리 내의 코드는Apache License 2.0이 적용됩니다.
이 도구는 AWS 서비스의 모사 정밀도(Fidelity)를 이슈 트래킹 시스템을 통해 지속적으로 관리하며, 개발자가 실제 AWS 인프라 환경과 유사한 테스트 환경을 로컬에서 신속하게 구성할 수 있도록 지원합니다.