Developer Tools7분 분량

AWS 테스트, 어디까지 노트북에서 돌릴 수 있을까?

AWS Emulator는 지원하는 클라우드 API 호출을 로컬에서 실행합니다. DynamoDB에 주문을 쓰고 읽는 예제로 빠른 피드백과 실제 AWS 검증의 역할을 살펴봅니다.

K
Ken Jo

코드를 한 줄 바꿨다고 해보죠. 앱이 주문을 DynamoDB에 저장하고 방금 저장한 주문을 그대로 읽어야 합니다. 가짜 클라이언트에 전달된 인자는 몇 초 만에 확인할 수 있고, 개발 계정에 배포하면 전체 흐름을 볼 수 있습니다. 두 방식 사이에 쓸 만한 테스트가 하나 더 생겼습니다. AWS가 그 테스트에 연결할 엔드포인트를 제공합니다.

Amazon Web Services는 2026년 11월 11일 AWS Emulator를 일반에 공개했습니다. 오픈 소스 도구로, AWS CLI나 SDK에서 지원하는 서비스 요청을 내 컴퓨터의 에뮬레이터로 보낼 수 있습니다. 에뮬레이터 자체에 별도 서비스 요금은 없습니다. API마다 지원 범위가 다르며, AWS는 프로덕션에 올리기 전에 실제 AWS에서 보안 검사와 애플리케이션 전체 테스트를 하라고 권합니다. AWS 출시 발표

DynamoDB 예제는 두 환경에 맡길 일을 잘 보여줍니다. 코드가 바뀔 때마다 앱이 데이터를 제대로 쓰고 읽는지 확인합니다. 배포된 역할, 리소스, 서비스 동작이 예상과 일치하는지 확인하는 데는 별도의 클라우드 테스트 예산을 씁니다. 출시 절차에는 두 검사를 모두 남겨둡니다.

주문 한 건이면 통합 테스트를 시작할 수 있다

구체적인 업무 규칙부터 정합니다. 테스트 앱에 ID가 order-123이고 상태가 pending인 주문이 들어옵니다. 앱이 DynamoDB 클라이언트로 저장한 뒤, 저장소 계층에서 새로 읽었을 때 같은 ID와 상태를 반환해야 합니다. 이 테스트로 한 테이블에 쓰고 다른 테이블에서 읽거나, 속성을 다른 이름으로 저장하거나, 키 구조를 잘못 가정하는 실수를 잡을 수 있습니다. 모의 객체도 그런 상황을 재현할 수 있지만, 어떤 실수가 날지 미리 예상해 설정해야 합니다.

AWS 발표 글에도 비슷한 예제가 나옵니다. 문자열 파티션 키가 있는 테이블을 만들고, 테스트 항목을 넣은 뒤 다시 읽습니다. CLI로 실행하는 버전과 같은 프로세스 안에서 실행하는 Rust SDK 예제가 있습니다. 평소에 쓰는 클라이언트를 그대로 쓰면 실제 통합 코드와 가까운 조건으로 검사할 수 있습니다. SDK 메서드가 호출됐는지보다, 돌아온 값이 맞는지가 더 중요합니다. AWS 출시 글의 예제

DynamoDB 통합 테스트가 SDK를 거쳐 로컬 엔드포인트에 쓰기와 읽기 요청을 보낸다

같은 클라이언트 경로를 거쳐 쓰기와 읽기를 검사합니다. Telli.sh 자체 제작 도식.

Linux에는 AWS가 RPM과 Debian 패키지를 제공합니다. Windows와 macOS의 공식 문서는 Docker 이미지를 빌드해 실행하는 방법을 설명합니다. 독립 실행형 에뮬레이터는 기본적으로 127.0.0.1:9297에서 HTTPS를 열고, 로컬 설정과 인증서, 별도 자격 증명을 생성합니다. 리소스를 만들기 전에 상태 검사와 호출자 신원 조회로 테스트 셸이 에뮬레이터에 연결됐는지 확인할 수 있습니다. Rust SDK에서는 프로세스 안에 테스트 전용 인스턴스를 띄우는 내장 모드도 지원합니다. AWS Emulator 사용 설명서

클라이언트 설정은 테스트 구성에 넣어두세요. 테스트 셸에는 에뮬레이터의 주소, 인증서 설정, 전용 자격 증명만 두고, 실제 AWS 자격 증명은 그 셸에서 빼둡니다. 배포 환경에서도 애플리케이션 코드는 그대로 씁니다. 이렇게 하면 환경 경계를 검토하기 쉽습니다. 에뮬레이터가 꺼져 있다면 로컬 작업은 연결이나 설정 오류를 명확히 표시하며 실패해야 합니다. 테스트가 조용히 다른 환경으로 연결되면 결과를 믿을 수 없고, 계정 담당자가 예상하지 못한 동작이 발생할 수도 있습니다.

AWS에 따르면 에뮬레이터의 요청, 응답, 저장 데이터는 로컬 컴퓨터에 남습니다. 독립 실행형 에뮬레이터가 기본으로 전송하는 익명의 사용 정보와 오류 데이터는 별개입니다. 이 텔레메트리는 에뮬레이터 설정에서 끌 수 있습니다. AWS 출시 문서

각 테스트가 무엇을 증명하는지 나눠보자

세 층으로 나누면 편합니다. 첫째, 필수 정보가 없는 주문을 서비스 호출 전에 거절하는 것처럼 앱이 직접 책임지는 동작은 단위 테스트로 검사합니다. 둘째, 클라이언트 설정과 데이터 인코딩, 지원하는 서비스 호출이 함께 동작하는지는 로컬 통합 테스트로 확인합니다. 셋째, 실제 배포 리소스와 역할, 서비스 동작은 AWS 환경에서 확인합니다. 각 층에서 어떤 오류가 나는지 알게 되면 테스트 배치를 조정할 수 있습니다.

테스트 층확인 예시얻는 근거
단위 테스트주문 ID가 비어 있으면 클라이언트 호출 전에 거절한다앱이 자체 규칙을 지킨다
로컬 에뮬레이터유효한 주문을 SDK로 쓰고 다시 읽을 수 있다클라이언트와 지원 대상 API 호출이 에뮬레이터에서 함께 동작한다
AWS 통합배포 역할이 허용된 테이블은 수정하고 금지된 리소스에서는 거절당한다실제 설정이 권한 경계를 지킨다

먼저 로컬에서 정상 사례 하나를 통과시킨 다음 팀에 중요한 실패 사례를 추가합니다. 중복 요청이 저장된 주문을 바꾸면 안 된다면 같은 요청을 한 번 더 보내고 업무 규칙에 맞는 결과가 남았는지 확인합니다. 조건부 쓰기나 트랜잭션에 기대는 동작이라면, 에뮬레이터에서 그 호출이 테스트의 전제대로 동작하는지 확인해야 합니다. 우리 제품에 필요한 호출과 동작을 실제로 검사하는지가 중요합니다. 항목이 하나 저장됐다는 결과만으로는 재현하지 않은 경합 상황에 대해 알 수 없습니다.

큐를 쓰는 예에서도 차이가 드러납니다. 워커가 작업을 읽어 결과를 저장한 뒤 처리 완료를 알린다고 해보죠. 필요한 호출이 지원된다면 워커가 이 순서를 지키는지 로컬에서 테스트할 수 있습니다. 결과 저장에 실패하게 만든 뒤, 앱이 정의한 규칙대로 재시도할 작업을 남겨두는지 봅니다. 서비스가 자체적으로 전달하는 이벤트, 배포 역할의 권한, 부하를 받을 때 중요한 타이밍은 클라우드 환경에서 확인합니다. 로컬 테스트가 뒷받침하는 범위는 실제로 실행한 경로까지입니다.

서비스 이름보다 지원하는 API 목록을 먼저 보자

AWS는 서비스별로 전체 테스트 중 통과한 개수를 공개합니다. 출시 글의 50개 중 40개는 점수 읽는 법을 설명하기 위한 예시입니다. 팀은 그중 자신이 쓰는 호출의 평가 사례를 직접 봐야 합니다. 더 까다로운 테스트를 추가한 버전에서는 기존 기능의 지원이 좋아져도 전체 점수가 낮아질 수 있습니다. AWS에 따르면 미구현 작업에는 에뮬레이터가 HTTP 501을 반환합니다. AWS 평가 테스트 모음

DynamoDB 호출을 세 개 쓰는 팀이라면 호출 이름과 중요한 조건을 짧게 기록해 보세요. 쓰기 한 번, 강한 일관성을 요구하는 읽기 한 번, 한 사용자의 동작이 다른 사용자의 변경을 덮어쓰지 않도록 하는 조건부 갱신이 예입니다. 각 동작을 AWS의 공개 평가에서 검증하는지, 팀 자체 테스트나 클라우드 검사에서 확인하는지 적어둡니다. 에뮬레이터를 올릴 때는 필요한 동작을 다시 확인합니다. 이렇게 하면 호환성을 버전별로 판단할 수 있습니다.

지원하는 요청의 동작은 에뮬레이터에서, 배포 권한은 실제 AWS 환경에서 확인하는 테스트 계획

같은 애플리케이션을 두 환경에서 시험해 서로 다른 질문에 답합니다. Telli.sh 자체 제작 도식.

테스트에서 HTTP 501이 나오면 앱 동작을 바꾸기 전에 어떤 API 호출에서 발생했는지 확인합니다. 그 사례만 클라우드 검사로 옮기면 요구사항을 유지할 수 있습니다. 호출은 지원하지만 로컬과 AWS 응답이 다르면, 합성 데이터로 차이를 재현하는 가장 작은 입력을 찾고 필요하다면 프로젝트에 제보합니다. 원인이 클라이언트 코드의 가정에 있을 수도 있습니다. 어느 쪽 문제인지 알 때까지 실패를 드러낸 상태로 두세요.

출시 발표에 따르면 AWS는 AI 에이전트로 에뮬레이터 동작을 실제 서비스 응답과 공개 API 모델에 대조하고, 변경 사항은 검토와 출시 파이프라인 검사를 거칩니다. AWS가 프로젝트를 관리하는 방식 중 하나입니다. 덕분에 팀이 검토할 공개 평가가 생기지만, 우리 앱이 아직 실행하지 않은 호출까지 통과했다는 근거는 아닙니다. AWS 출시와 개발 과정

권한과 배포는 실제 AWS 계정에서 확인한다

로컬 도구도 요청 서명과 에뮬레이터 전용 자격 증명을 사용합니다. 하지만 이것으로 실제 AWS와 같은 정책 평가를 하는 것은 아닙니다. AWS에 따르면 에뮬레이터는 IAM과 리소스 기반 정책을 실제 AWS와 같은 방식으로 평가하지 않습니다. 출시 시점에는 단일 계정만 모델링하며 계정 간, 리전 간 동작은 제공하지 않습니다. 에뮬레이터의 성공 응답은 기능 테스트의 근거입니다. 실제 배포 역할을 쓰는 클라우드 테스트가 권한 판단의 근거가 됩니다. AWS 출시 시점의 제약

주문 예제에서 한 단계 더 나아가 봅시다. 프로덕션 워커는 특정 테이블만 수정할 수 있어야 합니다. AWS 개발 계정에서 실제 배포와 같은 역할로 워커를 호출해 허용된 테이블에 쓸 수 있는지 확인합니다. 다음으로 같은 호출이 쓰기를 금지한 테스트 리소스에서 거절되는지 검사합니다. 허용된 호출만 검사하면 역할의 권한이 너무 넓어도 테스트가 통과할 수 있습니다. 합성 데이터로 리소스를 만들고, 테스트가 끝나면 팀의 개발 환경 정책에 따라 정리합니다.

또 다른 예로 앱이 다른 계정의 스토리지 버킷에 업로드된 파일을 읽는다고 해보죠. 배포 동작은 앱 역할, 버킷 정책, 계정 간 리소스 관계에 따라 달라질 수 있습니다. 해당 계정과 리전 설정에서 그 관계만 좁게 검사하세요. 입력값 검증, 객체 이름 지정, 지원되는 단일 인스턴스 호출은 에뮬레이터에 맡길 수 있습니다. 개발 흐름을 빠르게 유지하면서 실제 연결에 적용되는 조건도 확인하는 방식입니다.

빠른 테스트는 브랜치에서 돌리고 전체 시간을 재자

에뮬레이터로 피드백을 앞당길 수 있는지는 지금 어느 단계에서 시간을 쓰는지에 달렸습니다. API 호출 하나를 확인하려고 3분을 들여 배포하는 팀과, 이미 비용이 낮은 공유 환경에서 긴 테스트를 돌리는 팀은 기회가 다릅니다. 지금의 준비, 실행, 정리 시간을 각각 재보세요. 대표 변경 사항에 로컬 통합 작업을 적용한 뒤 어떤 클라우드 사례를 언제 실행할지도 기록합니다.

코드 변경부터 다음 행동을 결정할 첫 결과가 나오기까지의 시간을 보세요. 테스트 실행 자체는 빨라도 개발자가 누락된 인증서나 공유 상태 오류를 찾는 데 10분을 쓰면 전체 작업은 느려집니다. CI에서는 에뮬레이터 버전을 고정하고, 데이터를 격리하고, 준비가 끝난 다음 테스트를 실행합니다. 로그에서도 시작 실패와 검증 실패를 구분합니다. AWS는 Rust 테스트에 격리된 내장 인스턴스를 쓰는 방법을 설명합니다. 독립 실행형 서비스를 쓰는 팀이라면 워커를 분리하거나 고유한 리소스 이름을 써서 다른 테스트의 데이터를 읽는 일을 막을 수 있습니다.

  1. AWS 서비스 하나를 호출하고 합성 데이터를 쓰는 재현 가능한 테스트를 고릅니다.
  2. 에뮬레이터 버전을 고정하고 일회용 인스턴스나 격리된 로컬 환경을 준비합니다.
  3. 테스트 전용 자격 증명과 엔드포인트를 설정합니다. 쓰기 전에 신원과 준비 상태를 확인합니다.
  4. 기대하는 동작과 실패 사례 한 건을 실행합니다. 실패한 검사의 입력과 관측 결과를 남깁니다.
  5. 실제 AWS에 배포된 연동과 IAM 정책은 간단한 실환경 테스트로 확인하고, 왜 그 테스트를 남겼는지 기록합니다.

코딩 에이전트도 이 반복 작업에 쓸 수 있습니다. 빠른 실험을 위해 클라우드 리소스를 폭넓게 만들게 하는 대신, 테스트 주소와 좁은 검증 조건을 주세요. 결함이 있을 때는 실패하고 고친 뒤에는 통과하는 테스트를 요구합니다. 테스트 범위와 권한 검토는 사람이 기존 방식대로 맡습니다. 에이전트가 테스트를 빨리 실행하면 그만큼 구체적인 결과를 빨리 얻을 수 있습니다.

비용이 도입 이유라면 실제 클라우드 리소스 사용량을 기록하세요. AWS는 에뮬레이터 서비스 요금을 별도로 받지 않지만, 로컬 CI도 컴퓨팅 자원을 씁니다. AWS에 배포한 검사에는 사용한 리소스 요금이 들 수 있습니다. 비교할 것은 출시 주기 동안 신뢰할 만한 테스트 범위를 유지하는 데 쓰는 총비용입니다. 초기에 연동 오류를 잡는 로컬 작업과 꼭 필요한 클라우드 검사를 함께 쓰면 출시 확인을 약화하지 않고 반복 배포를 줄일 수 있습니다.

좋은 분리는 오류가 나면 어디를 볼지 알려준다

주문을 로컬에서 쓰고 읽는 테스트에 실패했다면 요청과 저장소 계층의 코드부터 보면 됩니다. 클라우드에서 권한 테스트가 실패했다면 배포 설정과 정책부터 확인할 수 있습니다. 테스트에 두 주소가 있으면 다음에 고칠 곳을 더 빨리 찾을 수 있습니다. 피드백의 가치는 도착 속도와 다음 행동을 알려주는 정확성에서 나옵니다.

출처


통합 방식에 대한 결정과 테스트 메모를 검색 가능한 기록으로 남기고 싶다면 Telli.sh 계정을 만들어보세요.


← 블로그로 돌아가기