← 목록으로

AWS가 마침내 자체 AWS 에뮬레이터를 만들었다

요약
  • AWS는 실제 AWS를 호출하지 않고 로컬 환경이나 CI에서 AWS API를 테스트할 수 있는 'AWS Emulator'를 출시했습니다.
  • 이 도구는 서버 모드와 Rust 임베디드 모드를 지원하며, 개발 및 테스트 용도로만 사용 가능합니다.
  • 사용자는 별도의 AWS 계정이나 추가 비용 없이 편리하게 테스트 환경을 구축할 수 있습니다.
  • AWS Emulator는 실제 AWS를 호출하지 않고 로컬 머신, 개발 서버, CI에서 AWS API를 사용하는 소프트웨어를 테스트하는 도구로, AWS 계정 없이 사용 가능함
  • 서버 모드에서는 AWS CLI나 SDK가 에뮬레이터 엔드포인트를 향하도록 설정하며, Rust 임베디드 모드에서는 테스트마다 격리된 인스턴스를 프로세스 내부에서 실행함
  • 개발과 테스트 전용으로, 프로덕션 워크로드나 보안 테스트에는 사용하면 안 되며 실제 AWS와의 동작 일치도는 릴리스별로 확인해야 함
  • Linux는 RPM이나 Debian 패키지로 설치할 수 있고, macOS와 Windows는 AWS가 제공하는 Dockerfile로 이미지를 빌드해 실행함. 전체 디버그 빌드를 할 때는 target/에 최소 100GB의 여유 공간이 필요
  • 텔레메트리는 기본 활성화되어 있지만 비활성화할 수 있으며, 수집 기록에는 요청/응답 내용, 코드, 자격 증명, 개인정보가 포함되지 않음
실제 AWS 호출 없는 개발과 테스트
  • AWS Emulator는 AWS API 엔드포인트를 제공하는 로컬 프로그램으로, 요청을 실제 AWS 대신 받아 에뮬레이션된 리소스로 처리함
    • 개인 머신, 개발 서버, CI에서 사용할 수 있으며 AWS 계정이 필요 없음
    • 추가 서비스 요금은 없고, AWS에 배포할 때 사용하는 AWS 리소스에 대해서만 비용을 지불함
  • 그래픽 인터페이스는 없음. 실행 후 AWS CLI나 SDK가 에뮬레이터를 향하도록 설정하고 기존 코드를 실행하는 방식임
  • 프로덕션 워크로드와 보안 테스트에는 사용하면 안 됨

    • 사용 범위는 Security in AWS Emulator, 전체 안내는 AWS Emulator User Guide에서 확인 가능함
서버 모드와 Rust 임베디드 모드
  • 서버 모드는 CLI와 모든 SDK에서 사용할 수 있으며, 환경 변수로 실행 중인 에뮬레이터의 엔드포인트를 지정함
    • 연결 방법은 SDK 연결 안내를 참고할 수 있음
    • 에뮬레이터는 자체 서명 인증서를 사용하는 HTTPS 엔드포인트 127.0.0.1:9297을 제공함
  • 임베디드 모드는 Rust 프로젝트의 개발 의존성으로 추가해 테스트마다 격리된 인스턴스를 프로세스 내부에서 실행함
    • 에뮬레이터의 HTTP 클라이언트를 SDK 클라이언트에 직접 전달하므로 엔드포인트 URL, 인증서, 환경 변수 설정이 필요 없음
    • 사용 방법은 임베디드 모드 시작 안내에서 확인 가능함
  • AI 코딩 에이전트에 aws-emulator 스킬을 설치해 설정을 맡길 수도 있음
    • AWS CLI 2.35.0 이상이 필요하며, AI 코딩 에이전트 시작 안내를 제공함
실제 AWS와의 호환성 확인
  • 서비스별 동작 일치도 점수를 각 릴리스와 함께 릴리스 페이지에 공개함
  • 개별 프로젝트의 예상 작동 여부는 프로젝트 호환성 확인 안내를 통해 점검할 수 있음
  • 알려진 API와 동작 차이는 issues/ 디렉터리에서 관리함
    • 아직 작동하지 않는 항목은 issues/things-that-do-not-work/에 있음
    • 수정된 항목은 issues/things-that-now-work/로 이동함
서비스별 크레이트 구조와 빌드 비용
  • Rust 워크스페이스는 AWS 서비스별 크레이트와 공통 코어 크레이트로 구성됨
    • 각 서비스의 Smithy 모델이 통신 프로토콜을 정의하며, build.rs가 모델에서 서비스 선언을 생성함
    • 서비스별로 요청 라우팅과 거부 처리 재정의, 메모리 내 상태, 작업별 구현 파일과 테스트를 둠
    • core/router/는 모든 서비스를 하나의 엔드포인트에 연결하고, core/embedded/는 프로세스 내부 실행용 인터페이스를 제공함
    • vendor/의 프레임워크 크레이트는 업데이트 시 교체되므로 수정하지 않는 영역임
  • 소스 빌드는 에뮬레이터 수정, 체크아웃한 소스 실행, 임베디드 모드 사용 시 필요하며, 대부분의 다른 사용자는 사전 빌드 패키지를 설치함
    • 소스 빌드 지원 환경은 Linux x86_64와 aarch64이며, Windows와 macOS에서는 Docker 방식을 사용함
    • Cargo를 포함한 Rust 도구 모음과 C 컴파일러가 필요함
  • 전체 디버그 빌드는 서비스별 크레이트를 모두 컴파일하므로 target/용 여유 디스크가 최소 100GB 필요하며 서비스가 추가될수록 커짐
    • 첫 전체 빌드에는 시간이 걸리고 코어 수가 적을수록 오래 걸리므로 멀티코어 머신이 필요함
    • 이후 한 서비스만 변경한 경우에는 재빌드가 훨씬 빠름
  • 임베디드 모드도 에뮬레이터를 테스트 바이너리에 컴파일하므로 첫 cargo test에서 비슷한 빌드 시간과 디스크 공간이 필요함
    • 프로젝트 간 CARGO_TARGET_DIR 공유, CI에서 target/ 캐시 또는 sccache 사용을 권장함
    • 에뮬레이터를 릴리스 커밋에 고정해 변경 때마다 다시 빌드되지 않도록 권장함
텔레메트리 수집과 비활성화
  • 사용량 텔레메트리는 기본적으로 AWS에 전송되며, 에뮬레이터 사용 방식을 파악하는 데 활용됨
    • 사용자, 계정, 조직을 식별하거나 특정할 수 없도록 데이터를 최소화함
    • 요청/응답 내용, 코드, 자격 증명, 개인정보는 기록하지 않으며 제3자와 공유하지 않음
    • 수집 항목과 처리 방식은 Telemetry in AWS Emulator에서 확인 가능함
  • 비활성화는 실행 옵션 --telemetry off, 환경 변수 EMULATOR_TELEMETRY=off, config.toml 설정 또는 임베디드 설정 API로 가능함
    • 실행 옵션은 해당 프로세스에만, 환경 변수는 해당 셸에서 시작한 에뮬레이터에, 설정 파일은 머신에서 반복 실행할 때 적용됨
    • 임베디드 모드에서는 생성 옵션에 Telemetry::Off를 전달할 수 있음
  • 에뮬레이터를 포함한 테스트 프레임워크 등의 도구를 배포한다면 사용자에게 텔레메트리를 알리고 끌 수 있는 방법을 제공해야 함
    • 텔레메트리를 끈 상태로 도구를 배포하는 것도 가능함
버그 보고와 라이선스
  • 버그와 실제 AWS와의 동작 차이는 GitHub Issues에 보고할 수 있으나, PR은 받지 않음
    • 서비스, 작업, SDK와 버전, 전송한 요청, 실제 AWS 응답과의 차이를 포함한 보고가 가장 유용함
  • 기본 라이선스는 CC0 1.0 Universal이며, vendor/ 코드는 Apache License 2.0을 적용함
    • 세부 사항은 LICENSE와 vendor/README.md에서 확인 가능함
그냥 목록으로
원문 보기 ↗