연동 키트설치형 오픈소스AWS Emulator
AWS Emulator를 로컬 및 CI 환경에 연동
- 누가 · 어디에
- AWS 기반 애플리케이션을 개발·테스트하는 개발자 및 AI 코딩 에이전트 실무자
- 업무 효과
- AWS 계정 없이 로컬에서 밀리초 단위로 API를 테스트하고 배포 비용과 대기 시간을 절감
우리 서버 · PC 에 설치해 직접 운영합니다. AI 가 공식 문서를 찾아 정리한 가이드로, mopick 이 직접 따라 해 보지는 않았습니다 · 공식 문서에서 제품을 확인했습니다
준비할 것
- Linux(x86_64/aarch64) 머신 또는 Docker 환경(macOS/Windows)
- AWS CLI (v2.35.0 이상 권장)
- 설치용 패키지 관리자 권한 (dnf/apt 등)
연동 단계
해 본 단계는 번호를 눌러 표시하세요. 표시는 이 브라우저에만 남습니다.
에뮬레이터 설치
Linux는 AWS 다운로드 경로에서 RPM 또는 Debian 패키지를 내려받아 설치하고, macOS/Windows 환경에서는 공식 Dockerfile을 이용해 이미지를 빌드합니다.
에뮬레이터 실행
터미널에서 'aws-emulator'를 실행합니다. 기본 9297 포트로 로컬 HTTPS 엔드포인트가 열리고 ~/.aws/emulator/9297/ 디렉터리에 자체 인증서와 키가 생성됩니다.
엔드포인트 환경 변수 연결
AWS_ENDPOINT_URL을 https://127.0.0.1:9297로 지정하고, AWS_CA_BUNDLE에 생성된 ca.pem 파일 경로를 설정하여 SDK와 CLI가 로컬을 바라보게 합니다.
로컬 API 호출 확인
AWS CLI로 sts get-caller-identity 또는 DynamoDB/S3 생성 명령을 내려 에뮬레이터 인메모리 상에서 정상 처리되는지 확인합니다.
붙여 넣는 설정 · 코드
YOUR_API_KEY 같은 자리에는 내 값을 넣으세요. 키는 코드 · 문서에 그대로 남기지 말고 환경 변수 · 비밀 저장소에 두세요.
# 1. 패키지 다운로드 및 설치 (Amazon Linux/RHEL 예시) PKG="https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest" sudo dnf install -y $PKG/aws-emulator-x86_64.rpm # 2. 에뮬레이터 백그라운드 구동 aws-emulator & # 3. 로컬 엔드포인트 및 인증서 환경 변수 지정 export AWS_ENDPOINT_URL="https://127.0.0.1:9297" export AWS_CA_BUNDLE="$HOME/.aws/emulator/9297/ca.pem" # 4. 가상 계정 연결 확인 aws sts get-caller-identity
- 잘 연결됐는지 확인
- aws sts get-caller-identity 실행 결과의 Account 필드가 '000000000000'으로 반환되는지 확인
- 비용
- 무료 (추가 서비스 요금 없음, 실제 AWS 환경에 배포할 때만 리소스 비용 발생)
- 주의
- · 개발 및 테스트 전용 도구이며 실제 프로덕션 워크로드 운영 또는 보안 검증용으로는 사용할 수 없습니다.
- · 모든 상태는 인메모리로 관리되므로 프로세스를 중지하면 생성된 리소스와 자격 증명이 완전히 소멸합니다.
- · 일부 미구현된 서비스 및 작업은 HTTP 501 Not Implemented를 반환하므로 충실도(Fidelity) 문서를 확인해야 합니다.
공식 문서
우리 회사 시스템에 붙여야 한다면 — 업무 앱 · 사내 자료 · 보안 조건에 맞춘 연동을 TPI INSIGHT AX센터가 함께합니다.