Amazon Web Services 한국 블로그
AWS Emulator 출시, 로컬 AWS를 대상으로 AI 애플리케이션 테스트 가능
오늘 AWS는 머신에서 실행할 수 있는 로컬 에뮬레이터인 AWS Emulator를 출시합니다. AWS Command Line Interface(AWS CLI), AWS SDK 및 코딩 에이전트는 클라우드에서 사용하는 것과 동일한 AWS API를 사용하여 사용자의 랩톱에서 로컬 HTTPS 엔드포인트를 통해 이 에뮬레이터와 통신합니다. AWS 에뮬레이터에는 추가 서비스 요금이 없습니다. AWS에 배포할 때는 AWS 리소스에 대해서만 비용을 지불하면 됩니다. 소스는 GitHub에 있습니다. Linux에서는 RPM 또는 Debian 패키지에서 설치하고, macOS와 Windows에서는 Docker에서 실행합니다.
작동 방식
에뮬레이터를 설치하고 실행한 다음 도구가 로컬 엔드포인트를 사용하도록 설정합니다. AWS 에뮬레이터가 시작되면 자체 자격 증명, 구성 파일 및 인증서를 생성하여 ~/.aws/emulator/9297/에 씁니다. AWS SDK가 AWS 대신 랩톱과 통신하고 애플리케이션 코드가 변경되지 않도록 환경 변수를 설정합니다.
이 경우에도 기존 테스트, CLI 스크립트 및 코딩 에이전트를 기존과 동일한 방식으로 계속 사용할 수 있습니다. Amazon DynamoDB 테이블을 생성하고 항목을 쓴 다음 다시 읽어 오는 단위 테스트는 기존과 동일하며, 배포 과정 없이 로컬 머신에서 실행됩니다. 코딩 에이전트는 리전에서 배포를 기다리지 않고 리소스를 생성하고, 결과를 확인하고, 다시 반복할 수 있습니다.
에뮬레이터는 Rust로 구현되어 있어 랩톱에서 CPU와 메모리 리소스를 적게 사용합니다. GitHub의 AWS API 모델 리포지토리에 API 모델이 있는 AWS 서비스의 API를 지원합니다. AWS SDK와 동일한 API 모델을 기반으로 구축되었기 때문에 요청과 반환되는 오류의 형식이 실제 AWS 환경과 동일합니다.
개발자, 특히 Kiro 또는 Claude Code와 같은 코딩 에이전트를 사용하는 개발자의 경우 이 루프를 사용하여 실제로 복잡한 AWS 상호 작용을 로컬에서 테스트할 수 있습니다.
직접 사용해 보기
시작하기 위해 Amazon Linux 2023에 패키지를 설치했습니다. 패키지를 설치하면 aws-emulator 명령이 /usr/bin/에 추가되어 경로에서 바로 실행할 수 있습니다.
PKG=https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest sudo dnf install -y $PKG/aws-emulator-x86_64.rpm aws-emulator -v
macOS 및 Windows에서는 설명서의 짧은 Dockerfile에서 Docker 이미지를 빌드하고 컨테이너에서 에뮬레이터를 실행합니다. AWS에서는 사전 생성된 이미지를 게시하지 않습니다.
aws-emulator로 에뮬레이터를 시작했습니다. 127.0.0.1:9297에서 HTTPS를 제공하므로 로컬 컴퓨터에서만 도달할 수 있으며 주소, 구성 파일 및 인증서 파일을 보여주는 JSON 라인 형식으로 로그를 기록합니다.
aws-emulator
다른 터미널에서 AWS CLI가 에뮬레이터를 가리키도록 환경 변수를 설정하고, 실제 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_EC2_METADATA_DISABLED=true export AWS_DISABLE_HOST_PREFIX_INJECTION=true export AWS_REGION=us-east-1 export AWS_DEFAULT_REGION=us-east-1 unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE
에뮬레이터는 시작할 때마다 새 키를 생성합니다. 액세스 키 ID는 실제 AWS 키로 착각하지 않도록 EMULATOR로 시작하며, 에뮬레이터는 다른 키로 서명된 요청을 거부합니다. 쉘이 에뮬레이터와 통신하고 있는지 확인하기 위해 상태 엔드포인트와 호출자 ID를 확인했습니다. 에뮬레이터는 000000000000이라는 단일 계정을 사용합니다.
curl --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health aws sts get-caller-identity
그런 다음 버킷을 생성하고 작은 객체를 복사하여 나열했습니다.
$ aws s3 mb s3://local-getting-started make_bucket: local-getting-started $ echo "hello from the emulator" > hello.txt $ aws s3 cp hello.txt s3://local-getting-started/ upload: ./hello.txt to s3://local-getting-started/hello.txt $ aws s3 ls s3://local-getting-started/
AWS CLI가 로컬 랩톱을 가리키도록 설정했기 때문에, 평소 사용하던 명령어를 그대로 사용했으며 로컬 엔드포인트가 이에 응답했습니다.
다음으로는 현재 제가 실제로 작업하는 방식 그대로 테스트해 보고 싶어, 에뮬레이터를 계속 실행한 상태에서 Kiro를 열고, 제 AWS 계정이 아닌 AWS 에뮬레이터를 대상으로 Amazon DynamoDB 테이블을 생성하고, 항목을 기록한 다음 다시 읽어 오도록 요청했습니다.
kiro> 로컬 AWS 에뮬레이터를 사용하여(DynamoDB 테이블 생성에 필요한
환경 변수가 이 셸에 이미 설정되어 있음) DynamoDB 테이블을 생성
"kiro-demo" with a string key "id", put an item
{id: "item-1", msg: "hello from kiro"}, then read it
back with get-item.
$ aws dynamodb create-table --table-name kiro-demo \
--attribute-definitions AttributeName=id,AttributeType=S \
--key-schema AttributeName=id,KeyType=HASH \
--billing-mode PAY_PER_REQUEST
$ aws dynamodb put-item --table-name kiro-demo \
--item '{"id": {"S": "item-1"}, "msg": {"S": "hello from kiro"}}'
$ aws dynamodb get-item --table-name kiro-demo --key '{"id": {"S": "item-1"}}'
기존 테스트 도구 모음에서 동일한 설정을 사용하려면 에뮬레이터를 시작하고 테스트를 실행하는 스크립트에서 동일한 환경 변수를 설정한 다음 평소와 같이 실행합니다.
프로세스 내에서 에뮬레이터 사용
에뮬레이터를 로컬 프로세스로 실행하면 환경 변수를 통해 AWS CLI 및 AWS SDK와 함께 작동하는 HTTPS 엔드포인트가 제공됩니다. 일부 SDK에서는 에뮬레이터 인증서를 신뢰하도록 하는 추가 설정이 필요합니다. 예를 들어 AWS SDK for Java에서는 신뢰 저장소를 설정해야 합니다. 테스트에는 두 번째 옵션이 있습니다. AWS 에뮬레이터는 네트워크를 통해 별도의 서버와 통신하는 대신, 테스트 프로세스 내에서 직접 인스턴스화하고 HTTP 클라이언트를 통해 SDK에 연결할 수 있는 임베디드 모드를 제공합니다. 각 임베디드 인스턴스는 자체 상태를 유지하므로 테스트 간에 버킷, 테이블 또는 대기열을 공유하지 않으며, 여러 인스턴스를 병렬로 실행할 수도 있습니다. 임베디드 모드는 AWS SDK for Rust에 사용할 수 있습니다. GitHub에서 aws-emulator-embedded 크레이트를 가져와 Cargo.toml 파일의 [dev-dependencies] 섹션에 추가합니다. 다음 예에서는 전적으로 프로세스 내에서 Amazon DynamoDB 테이블을 생성하고, 항목을 기록한 다음 다시 읽어 옵니다.
use aws_emulator_embedded::{AwsEmulatorEmbedded, EmbeddedOptions};
use aws_sdk_dynamodb::types::{
AttributeDefinition, AttributeValue, BillingMode, KeySchemaElement, KeyType,
ScalarAttributeType,
};
#[tokio::test]
async fn put_then_get_returns_the_item() {
let emulator = AwsEmulatorEmbedded::new(EmbeddedOptions::default());
let config = aws_config::defaults(aws_config::BehaviorVersion::latest())
.http_client(emulator.http_client())
.region(aws_config::Region::new("us-east-1"))
.credentials_provider(emulator.aws_credentials_provider())
.load()
.await;
let ddb = aws_sdk_dynamodb::Client::new(&config);
ddb.create_table()
.table_name("emulator-demo-table")
.attribute_definitions(
AttributeDefinition::builder()
.attribute_name("id").attribute_type(ScalarAttributeType::S)
.build().unwrap())
.key_schema(
KeySchemaElement::builder()
.attribute_name("id").key_type(KeyType::Hash)
.build().unwrap())
.billing_mode(BillingMode::PayPerRequest)
.send().await.unwrap();
ddb.put_item()
.table_name("emulator-demo-table")
.item("id", AttributeValue::S("item-1".into()))
.item("msg", AttributeValue::S("hi".into()))
.send().await.unwrap();
let got = ddb.get_item()
.table_name("emulator-demo-table")
.key("id", AttributeValue::S("item-1".into()))
.send().await.unwrap();
assert_eq!(got.item().unwrap().get("msg").unwrap().as_s().unwrap(), "hi");
}
에뮬레이터가 로컬 프로세스로 실행되는 경우, AWS와 동일한 방식으로 모든 요청에 Signature Version 4(SigV4) 서명을 적용해야 합니다. 또한 동일한 포트에서 /__admin/health 엔드포인트를 제공하므로 스크립트나 컨테이너가 테스트를 실행하기 전에 에뮬레이터의 준비가 완료될 때까지 대기할 수 있습니다. 또한 기본적으로 익명으로 사용 및 오류 데이터를 전송하며 이 기능을 끌 수 있습니다.
충실도 측정 방법
에뮬레이터는 에뮬레이터에서 통과한 테스트가 AWS 환경에서도 통과할 수 있어야만 유용하므로, 충실도 테스트를 통해 이를 직접 측정합니다. 충실도 테스트는 AWS SDK를 사용하여 객체를 저장한 다음 읽고 삭제하는 등의 워크플로를 실행하고 AWS가 어떻게 동작하는지 확인하는 간단한 프로그램입니다. 그런 다음 실제 AWS를 기준으로 각 충실도 테스트를 검증합니다. 충실도 테스트는 상태 코드, 응답 본문, 정확한 오류 코드 및 메시지를 비롯한 모든 호출에 대한 에뮬레이터의 응답과 워크플로에서 생성되는 리소스 및 데이터가 AWS와 일치하는 경우에만 통과합니다.
각 릴리스마다 각 서비스에 대해 통과한 충실도 테스트 수를 k/n으로 게시합니다. 예를 들어 40/50은 서비스의 50개 충실도 테스트 중 40개를 통과했음을 의미합니다. 충실도 테스트 세트는 아직 통과하지 못한 테스트를 포함하여 GitHub의 aws-emulator-evaluation-suite 리포지토리에 공개되어 있으므로, 여러분이 검증된 항목을 직접 확인하고 충실도 테스트를 직접 실행할 수 있습니다. 점수는 지속적으로 개선되고 있는 제품의 스냅샷으로 이해하세요. 충실도 테스트를 추가하면 에뮬레이터가 개선되더라도 점수가 떨어질 수 있습니다.
에뮬레이터가 아직 작업을 구현하지 않은 경우 HTTP 501(구현되지 않음)을 반환하므로 테스트가 즉시 실패합니다. 에뮬레이터가 AWS와 다르게 동작하는 경우 GitHub의 AWS Emulator 리포지토리에 이슈를 등록하여 알려주세요.
에뮬레이터 구축 방법
AWS 에뮬레이터는 에이전트가 Amazon Bedrock AgentCore 런타임 인스턴스, AWS CodePipeline 및 AWS CodeCommit을 사용하여 AWS API 모델을 바탕으로 구축하고 유지 관리하므로, 모델이 변경돼도 AWS에 맞춰 최신 상태로 유지됩니다.
한 에이전트 그룹은 실제 AWS와 에뮬레이터의 응답을 비교하고, 공개된 Smithy 모델과 에뮬레이터 코드를 정적으로 비교하여 누락된 부분을 찾습니다. 그런 다음 발견된 각 누락 항목에 대해 이슈를 등록합니다. 또 다른 그룹은 문제를 선택하고, 테스트를 작성하고, 동작을 구현하고, 변경 사항의 정확성, 성능 및 보안을 검토합니다. 변경 사항이 준비되면 소스 리포지토리에 푸시되며, 이 푸시를 트리거로 AWS CodePipeline이 실행되어 변경 사항을 공개 GitHub 리포지토리에 게시하기 전에 충실도 테스트를 실행합니다.
보안을 유지하는 방법
코드를 에이전트가 작성하기 때문에, 독립적인 보안 에이전트가 수정 작업이 진행되는 동안은 물론 릴리스 파이프라인에서도 최종 검토를 수행하여 실제 배포 전에 변경 사항을 적대적 관점에서 다시 한번 검증합니다.
사용자의 사용에 있어서의 보안은 공동 책임입니다. 에뮬레이터는 컴퓨터에서 안전하게 실행되도록 빌드되었습니다. 에뮬레이터는 기본적으로 사용자 컴퓨터에서만 수신 대기하고 자체 키로 서명되지 않은 요청은 거부합니다. 실행 위치, 저장할 데이터, 프로덕션 전에 테스트하는 방법은 사용자가 결정합니다. 에뮬레이터를 사용하여 애플리케이션의 보안을 테스트하지 마세요. AWS Identity and Access Management(IAM) 정책과 리소스 기반 정책을 AWS가 통상적으로 하듯이 평가하지 않으므로, AWS에서는 거부되는 요청이 에뮬레이터에서는 성공할 수 있습니다. 실제 자격 증명은 테스트 작업 환경에 보관하지 말고, 프로덕션으로 전환하기 전에 AWS에서 보안 설정과 전체 애플리케이션을 테스트하세요.
지금 이용 가능
AWS 에뮬레이터는 오늘부터 정식 버전으로 제공됩니다. 추가 서비스 요금은 없습니다. AWS에 배포할 때는 AWS 리소스에 대해서만 비용을 지불하면 됩니다. Linux의 RPM 또는 Debian 패키지에서 설치하거나, macOS 및 Windows의 Docker에서 실행하거나, 소스에서 빌드할 수 있습니다. 환경 변수를 설정하면 AWS SDK 및 AWS CLI에서 작동합니다. 출시 시점에는 몇 가지 제한이 있습니다. AWS가 통상적으로 하듯이 IAM 정책을 평가하지 않으며, 각 에뮬레이터는 계정 간 또는 리전 간 동작 없이 단일 계정처럼 작동합니다. 동작이 얼마나 AWS와 일치하는지는 서비스와 기능에 따라 다릅니다. 사용하는 서비스를 에뮬레이터가 얼마나 잘 지원하는지 알아보려면 AWS 에뮬레이터 설명서에서 충실도 점수를 확인하세요.
리전별 가용성을 확인하려면 AWS Builder Center의 리전별 AWS 기능 페이지를 참조하세요. API를 호출하고, 문서를 검색하고, 리전별 가용성을 확인하고, 이 새로운 기능에 대한 문제 해결을 확인하려면 선호하는 AI 도구를 사용하여 AWS MCP Server 및 플러그인을 활용하세요.
시작하려면 AWS 에뮬레이터 설명서를 참조하세요.