AWS Emulator 사용법, 내 컴퓨터에서 AWS를 무료로 시험하기

AWS Emulator란 무엇이고, AWS 계정 없이 무엇을 시험하나

AWS Emulator는 AWS API를 내 컴퓨터 · 개발 서버 · CI(지속적 통합) 안에서 흉내 내는 로컬 에뮬레이터다. ‘aws 에뮬레이터’로도 검색되는 이 도구에 요청을 보내면 AWS가 아니라 에뮬레이터가 답하고, 리소스도 진짜가 아닌 흉내 낸 리소스가 만들어진다. 흔히 ‘AWS 로컬 스택’이라고 부르는 로컬 시험 환경을 AWS가 직접 내놓은 셈이다.

AWS 사용 설명서에 따르면 AWS Emulator는 추가 이용료가 없고, 실제 AWS에 배포할 때만 그 리소스 요금을 낸다. 그래픽 화면은 없다. AWS API 엔드포인트(요청을 받는 주소) 하나를 여는 명령줄 프로그램이고, AWS CLI나 SDK를 그 주소로 돌려 쓰는 방식이다.

설명서가 꼽는 쓰임새는 세 가지다.

지원 범위는 숫자 하나로 정해져 있지 않다. 설명서는 “AWS API 모델 저장소에 모델이 있는 서비스의 API”를 지원한다고만 적었고, 베르너 보겔스 아마존 최고기술책임자(CTO) 블로그에 실린 스와미 시바수브라마니안의 기고는 400개가 넘는 API 모델, 200개가 넘는 AWS 서비스로 만들었다고 밝혔다. 실제로 얼마나 AWS와 똑같이 움직이는지는 서비스마다 다르다(4번 참고).

AWS Emulator 설치, 내 운영체제는 어떤 방법을 쓰나

AWS Emulator 설치 방법은 운영체제에 따라 갈린다. 리눅스는 RPM이나 데비안 패키지를 깔아 aws-emulator 명령으로 바로 돌리고, macOS와 윈도우는 AWS가 준 짧은 Dockerfile로 이미지를 만들어 컨테이너로 돌린다. 어느 쪽이든 AWS 계정은 필요 없다.

아래 탭에 공식 사용 설명서의 명령을 옮겼다. 명령은 릴리스에 따라 바뀔 수 있으니 실행 전에 설명서를 한 번 더 확인한다. 설치 파일에는 서명(.sig)이 함께 있어 GnuPG로 진짜 AWS 파일인지 검사할 수도 있다.

# RPM (Amazon Linux 2023 등)
sudo dnf install -y https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm

# 데비안 · 우분투(amd64)
curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb

aws-emulator -v   # 버전 · 배포일 · 커밋 확인
aws-emulator      # 127.0.0.1:9297에서 HTTPS로 대기

FROM public.ecr.aws/amazonlinux/amazonlinux:2023-minimal
ADD https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm /tmp/aws-emulator.rpm
RUN rpm -i /tmp/aws-emulator.rpm && rm /tmp/aws-emulator.rpm \
    && mkdir -p /home/emulator && chown 1000 /home/emulator
USER 1000
ENV HOME=/home/emulator
EXPOSE 9297
ENTRYPOINT ["aws-emulator", "-b", "0.0.0.0"]

docker build -t aws-emulator .

mkdir -p ~/.aws/emulator
PORT=9297
docker run --rm --memory=2g --memory-swap=2g -p 127.0.0.1:$PORT:$PORT \
  -e HOME="$HOME" -v "$HOME/.aws/emulator:$HOME/.aws/emulator" \
  aws-emulator -p $PORT

aws --version
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1

[dev-dependencies]
aws-emulator-embedded = { git = "https://github.com/aws/aws-emulator", rev = "<커밋>" }

AWS CLI와 SDK를 에뮬레이터에 연결하는 환경 변수 8개

AWS CLI와 SDK를 AWS Emulator에 연결하려면 코드를 고치지 않고 환경 변수만 바꾸면 된다. 에뮬레이터는 켤 때마다 새 접근 키와 인증서를 만들어 ~/.aws/emulator/9297/ 폴더에 두고, 요청이 그 키로 서명(SigV4)됐는지 AWS처럼 검사한다. 그래서 주소만이 아니라 키 파일 · 설정 파일 · 인증서 경로도 함께 가리켜야 한다.

export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_CA_BUNDLE=~/.aws/emulator/9297/ca.pem
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1

# 진짜 AWS 자격 증명이 끼어들지 않게 지운다
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE

마지막 줄이 중요하다. 환경 변수의 자격 증명이 파일보다 앞서기 때문에, 진짜 키가 남아 있으면 SDK가 그 키로 서명하고 에뮬레이터는 요청을 거절한다. EC2 메타데이터를 끄는 줄은 EC2 서버에서 시험할 때 진짜 자격 증명을 끌어오지 않게 막는다. 윈도우 파워셸용 명령은 설명서에 따로 있다.

연결됐는지는 설명서의 예시로 확인한다. S3 버킷을 만들고 목록을 다시 불러오면, 에뮬레이터가 방금 만든 버킷을 돌려준다.

$ aws s3api create-bucket --bucket amzn-s3-demo-bucket
{ "Location": "/amzn-s3-demo-bucket" }

$ aws s3api list-buckets --query 'Buckets[].Name'
[ "amzn-s3-demo-bucket" ]

오류도 AWS와 같게 돌려주는 것이 목표다. DynamoDB 테이블 이름은 3자 이상이어야 하는데, 이름을 ab로 주면 에뮬레이터도 AWS와 똑같은 ValidationException 문구로 거절한다. 아직 만들지 않은 기능을 부르면 HTTP 501(NotImplemented)을 돌려줘 시험이 바로 실패한다. 준비 상태는 https://127.0.0.1:9297/__admin/health가 ok를 돌려주는지로 본다.

AWS 로컬 테스트에 AWS Emulator를 어디까지 믿고 쓸 수 있나

AWS Emulator는 만들고 시험하는 용도이고 운영 환경과 보안 시험에는 쓰지 말라고 AWS 사용 설명서가 못 박았다. 에뮬레이터를 통과한 시험이 “권한 설정이 맞다”는 뜻은 아니라는 것이다. 설명서는 AWS가 거절할 요청이 에뮬레이터에선 성공하고, 그 반대도 생길 수 있다고 적었다.

충실도는 에뮬레이터가 실제 AWS와 얼마나 같게 움직이는지를 뜻한다. AWS는 실제 AWS에서 확인한 시험(충실도 테스트) 가운데 몇 개를 통과했는지를 서비스별 점수(예: 50개 중 40개)로 매겨 릴리스마다 공개하겠다고 밝혔다. 다만 11월 12일 확인한 GitHub 릴리스 페이지의 최근 릴리스 노트에는 점수 표가 보이지 않았고, 일부 릴리스에는 “이 릴리스는 점수가 없다”는 문구만 있었다.

아직 안 되는 동작은 저장소의 issues/things-that-do-not-work/ 폴더에, 고쳐진 것은 issues/things-that-now-work/로 옮겨 쌓인다. 내 프로젝트가 쓰는 서비스와 작업 이름으로 이 폴더를 찾아보는 것이 가장 빠른 확인법이다. 에이전트 스킬을 깔았다면 “이 저장소의 앱이 AWS Emulator에서 돌아갈까?”라고 물으면 같은 대조를 대신 해 준다.

AWS Emulator 코드는 정말 AI 에이전트가 전부 썼나

AWS는 AWS Emulator의 코드를 자율 에이전트가 전부 썼고 팀은 코드를 한 줄도 쓰거나 검토하지 않았다고 밝혔다. AWS 개발자 도구 팀의 매슈 골드버그 시니어 프린시펄 엔지니어가 2026년 11월 11일 아마존 공식 사이트 About Amazon에 올린 글이다. 수천 개의 에이전트가 사람의 검토 없이 시험을 쓰고 문제를 찾고 코드를 고친다고 적었다.

시작은 주말 실험이었다. 골드버그는 앤트로픽 연구진이 에이전트로 C 컴파일러를 만든 사례를 보고, AWS에는 명세(API 모델)와 정답지(실제 AWS)가 다 있다고 생각했다. AI 코딩 도구 Kiro에 “AWS CLI로 시험을 쓰고, 실제 AWS에서 통과시키고, 같은 시험을 통과하는 메모리 구현을 만들라”고 시키자 15분 만에 SQS(메시지 큐 서비스)의 쓸 만한 첫 버전이 나왔다고 한다.

이 설명은 AWS 쪽 주장이고, 품질은 아직 외부에서 따로 검증된 것이 없다. 골드버그는 사람 대신 “가드레일”, 곧 실제 AWS로 확인한 시험과 보안 에이전트가 들어간 병합 관문이 품질을 지킨다고 설명했다. 초기 버전에서 에이전트가 Lambda 함수를 돌리려고 파이썬 인터프리터를 직접 만든 일도 있어, 지금은 기존 라이브러리를 다시 쓰라고 지침을 줬다고 적었다.

AWS Emulator와 LocalStack, 무료로 쓸 수 있는 범위는 어떻게 다른가

AWS Emulator와 LocalStack은 둘 다 AWS를 로컬에서 흉내 내지만, 무료로 쓸 수 있는 범위가 다르다. LocalStack 요금 페이지에 따르면 무료 Hobby 요금제는 취미 · 비상업 용도에 서비스 30개 이상이고 계정을 만들어야 한다. 유료 Base는 1인 월 39달러(연 결제), Ultimate는 89달러다. AWS Emulator는 계정도 이용료도 없다.

그렇다고 LocalStack 대안(localstack alternative)으로 바로 갈아탈 일은 아니다. LocalStack 유료판은 상태 저장과 IAM 정책 적용을 내세우는데, AWS Emulator는 둘 다 하지 않는다. LocalStack 공개 저장소 첫머리에는 “하나의 통합 이미지로 개발을 모으면서 이 저장소는 보관 · 읽기 전용이 됐다”는 안내가 붙어 있고, 이 저장소와 같은 기능을 담은 무료 Hobby 요금제(비상업용)를 안내한다.

해커뉴스 토론(11월 12일 09:56 기준 643점, 댓글 210개)에서는 “LocalStack은 이제 끝(RIP)”이라는 반응과 함께, 실제로 유지보수할 제품인지 시험 삼아 낸 것인지 모르겠다는 의심이 나왔다. “계속 유지보수할 실제 제품”이라는 답글이 달렸고, LocalStack도 대부분 무료로 써 왔다는 반론도 있었다. 모두 개인 의견이다. 가격과 기능의 세부 비교는 두 도구의 공식 문서를 기준으로 하고, 내 프로젝트가 쓰는 서비스로 양쪽을 직접 돌려 보는 것이 가장 확실하다.

CI에서 AWS Emulator로 통합 테스트를 돌리는 순서

CI에서 AWS Emulator를 쓰면 AWS 계정과 실제 리소스 없이 통합 테스트를 돌릴 수 있다. 설명서는 테스트마다 켜고 끄거나 --idle-timeout(초 단위, 1~31,536,000)으로 요청이 끊기면 저절로 꺼지게 하라고 권한다. 다시 켜면 깨끗한 상태에서 시작하니 시험끼리 섞이지 않는다.

aws-emulator --idle-timeout 600 &        # 10분간 요청이 없으면 스스로 종료
for i in $(seq 30); do                    # 준비될 때까지 최대 30초 기다림
  curl -sf --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health && break
  sleep 1
done
# 3번의 환경 변수를 넣은 뒤 테스트 실행

버전은 고정하는 편이 안전하다. 버전 번호는 주(MAJOR) · 부(MINOR) · 수정(PATCH) 세 자리이고, 충실도를 고치는 수정판이 하루에도 여러 번 나온다. AWS 쪽 공개 목록(versions.json)에는 11월 12일 기준 23개 버전이 올라 있고 최신은 1.0.322.1이다. 설명서는 보안 수정은 최신 릴리스에만 넣는다고 밝혔으니, 고정하더라도 주기적으로 올려야 한다. 에뮬레이터의 지금 동작이 아니라 AWS의 동작을 기대하는 시험을 쓰라는 것도 설명서의 권고다.

설치 전과 첫 실행 때 아래를 확인한다.

AWS Emulator, 자주 묻는 다섯 가지