AWS 에뮬레이터 릴리스 – 공식 로컬 AWS API 에뮬레이터

TL;DR

AWS가 AWS API의 공식 오픈소스 에뮬레이터를 출시했습니다. 이 에뮬레이터는 로컬에서 실행되며 AWS CLI/SDK와 통합되고 Rust 테스트에 포함될 수 있습니다. 실제 AWS 자격 증명이나 네트워크 호출 없이도 개발 및 CI 테스트를 간소화하는 것을 목표로 하지만, 프로덕션 또는 보안에 중요한 테스트용으로는 설계되지 않았습니다.


AWS 에뮬레이터란 무엇인가

AWS 에뮬레이터는 공개 AWS API 표면을 구현하는 로컬 프로그램입니다. 기본적으로 127.0.0.1:9297에서 AWS 서비스를 모방하는 HTTPS 엔드포인트를 시작하며, 환경 변수나 프로세스 내 HTTP 클라이언트를 통해 모든 AWS CLI 명령 또는 SDK 호출을 에뮬레이터로 리디렉션할 수 있습니다.

  • AWS 계정이 필요하지 않습니다.
  • 추가 서비스 요금이 부과되지 않습니다. 나중에 배포할 때 실제 AWS 리소스에 대해서만 비용을 지불합니다.
  • 에뮬레이터는 프로덕션급 서비스가 아니며 보안 테스트(IAM 정책, KMS 키, 교차 계정 또는 교차 리전 호출이 완전히 적용되지 않음)에 사용해서는 안 됩니다.

실행 방법 – 세 가지 모드

1. 서버 모드(CLI 및 모든 SDK)

  • Linux – RPM 또는 Debian 패키지를 설치하고 aws-emulator를 실행합니다.
  • Windows/macOS – 리포지토리에 제공된 짧은 Dockerfile로 빌드된 Docker 이미지를 실행합니다.
  • 일반적인 AWS 엔드포인트 환경 변수(예: AWS_ENDPOINT_URL)를 설정하여 SDK/CLI를 에뮬레이터로 지정합니다.

2. 포함 모드(Rust 테스트)

  • aws-emulator-embedded를 dev-dependency로 추가합니다.
  • AwsEmulatorEmbedded 인스턴스를 생성하고 해당 HTTP 클라이언트를 SDK에 직접 전달합니다.
  • 각 테스트는 격리된 에뮬레이터 인스턴스를 얻습니다. 외부 엔드포인트나 인증서가 필요하지 않습니다.

3. AI 에이전트 지원 설정

  • AI 코딩 에이전트용 aws-emulator 스킬을 설치합니다(aws agent-toolkit add-skill --skill-name aws-emulator).
  • 에이전트가 에뮬레이터를 자동으로 시작하고 구성할 수 있으며, AWS CLI v2.35.0+가 필요합니다.

충실도 및 알려진 격차

  • 각 릴리스는 각 서비스가 실제 AWS 동작과 얼마나 일치하는지 정량화하는 충실도 점수를 게시합니다.
  • 공개 이슈는 issues/things-that-do-not-work/(누락된 기능) 및 issues/things-that-now-work/(수정된 격차) 아래에 정리되어 있습니다.
  • 커뮤니티 의견에 따르면 에뮬레이터에는 현재 다음이 부족합니다:
    • 빠른 상태 재설정(프로세스를 다시 시작해야 함).
    • IAM 정책 평가, KMS 키 정책, 교차 계정/리전 의미 체계에 대한 완전한 지원.
    • 특정 서비스별 기능(예: Step Functions Assign 필드, 전체 Lambda 런타임 지원).
  • 프로젝트의 README는 테스트에 빠른 상태 재설정이 필요한 경우 Moto와 같은 도구의 대체품이 아님을 경고합니다.

소스에서 빌드 – 비용

  • 전제 조건: Rust 툴체인, C 컴파일러, target/ 디렉토리를 위한 ≥ 100GB 여유 디스크, 멀티 코어 머신.
  • 전체 디버그 빌드는 모든 AWS 서비스에 대해 별도의 크레이트를 컴파일하므로 큰 바이너리와 긴 초기 컴파일 시간이 발생합니다.
  • 증분 빌드는 빠릅니다. CI에서는 target/ 캐싱(또는 sccache 사용)을 권장합니다.
  • 리포지토리 레이아웃은 서비스별 크레이트, 라우터 바이너리, 포함 파사드가 있는 워크스페이스를 반영합니다.

텔레메트리 – 옵트아웃 옵션

텔레메트리는 최소한의 사용 데이터(요청/응답 페이로드, 자격 증명 또는 개인 데이터 없음)를 수집하기 위해 기본적으로 활성화되어 있습니다. 다음을 통해 비활성화할 수 있습니다:

  • 명령줄 플래그: aws-emulator --telemetry off
  • 환경 변수: EMULATOR_TELEMETRY=off
  • 구성 파일 ~/.aws/emulator/config.toml에 [telemetry] enabled = false
  • 포함 API: EmbeddedOptions::default().telemetry(Telemetry::Off)

커뮤니티 반응(Hacker News 하이라이트)

  • 긍정적 – 여러 댓글 작성자가 에이전트 개발과 LocalStack의 무료 대안으로서의 잠재적 가치를 칭찬했습니다.
  • 회의적 – 장기 유지 관리, 방대한 빌드 공간, 프로젝트가 진지한 제품인지 개념 증명인지에 대한 우려가 제기되었습니다.
  • 비교 – 사용자들은 Floci, MiniStack, Fakecloud, Moto와 비교하며 기능 중복과 격차(예: 상태 재설정, 전체 IAM 시뮬레이션)를 언급했습니다.
  • 기술적 관찰 – 빌드에는 > 100GB 디스크가 필요하고 메모리 집약적일 수 있습니다. 한 댓글은 32GB RAM 머신에서 jobs를 낮춰야 한다고 언급했습니다.

에뮬레이터를 사용해야 하는 경우

  • AWS 비용 없이 결정적인 API 응답이 필요한 단위 및 통합 테스트.
  • 격리된 러너에서 실행되고 외부 자격 증명에 의존할 수 없는 CI 파이프라인.
  • API 표면 검증만 필요한 CDK, Terraform 또는 CloudFormation 템플릿의 로컬 개발.

사용하지 말아야 하는 경우

  • 보안에 중요한 테스트(IAM 정책, KMS, 버킷 정책) – 에뮬레이터는 이러한 제어를 적용하지 않습니다.
  • 성능 또는 확장성 테스트 – 에뮬레이터는 로컬에서 실행되며 AWS의 대규모 인프라를 에뮬레이션할 수 없습니다.
  • 빠른 상태 재설정이 필요한 테스트 – 상태를 지우려면 에뮬레이터 프로세스를 다시 시작해야 합니다.

기여 방법

  • GitHub Issues를 통해 서비스 이름, 작업, SDK 버전, 요청 및 관찰된 편차를 제공하여 충실도 격차를 보고합니다.
  • 리포지토리는 풀 리퀘스트를 수락하지 않습니다. 기여는 이슈 보고로 제한됩니다.
  • 코드는 vendor/ 디렉토리(Apache-2.0)를 제외하고 CC0-1.0(퍼블릭 도메인)으로 릴리스됩니다.

결론

AWS의 오픈소스 에뮬레이터는 AWS 호환 코드를 오프라인으로 실행할 수 있는 강력하고 공식적으로 지원되는 방법을 제공하여 개발자의 비용과 마찰을 줄입니다. 보안 의미 체계와 상태 관리에 특히 눈에 띄는 격차가 여전히 있지만, AI 기반 도구와 클라우드 네이티브 개발 워크플로우의 더 긴밀한 통합을 향한 중요한 단계를 나타냅니다.

Sources

관련

  • 프로젝트
  • Dispatch
  • 프로젝트
  • Dispatch
  • 프로젝트