# kumo - Go로 작성된 경량 AWS 서비스 에뮬레이터

> Clean Markdown view of GeekNews topic #28793. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=28793](https://news.hada.io/topic?id=28793)
- GeekNews Markdown: [https://news.hada.io/topic/28793.md](https://news.hada.io/topic/28793.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-04-23T09:31:01+09:00
- Updated: 2026-04-23T09:31:01+09:00
- Original source: [github.com/sivchari](https://github.com/sivchari/kumo)
- Points: 7
- Comments: 0

## Topic Body

- 로컬 개발 및 CI/CD 테스트에서 실제 AWS 없이도 빠르게 호환 환경을 구성 가능  
- **단일 바이너리**로 가볍게 테스트 환경을 꾸밀수 있고, Docker 기반 실행도 가능  
- **인증 없이 동작**해 자동화 파이프라인에서 AWS 자격 증명 준비 부담을 줄일 수 있음  
- **76개 AWS 서비스**를 폭넓게 지원하며 S3, SQS, DynamoDB, Lambda, IAM, CloudWatch, ECS, RDS 같은 주요 영역을 함께 다룰 수 있음  
- 기본적으로 `localhost:4566`에서 동작하는 **로컬 AWS 호환 엔드포인트**   
- `KUMO_DATA_DIR` 설정 시 서비스별 JSON 파일로 **선택적인 데이터 보존**이 가능하고, 미설정 시에는 **깨끗한 인메모리로 실행**  
- 모든 요청을 **구조화된 로그 필드**와 함께 기록함   
  - INFO: **HTTP 메서드**, 경로, 상태 코드, 지연 시간, 요청 ID, API 대상 정보 등  
  - DEBUG: **전체 요청 본문**까지 기록해 요청 페이로드 자체를 살펴봐야 하는 디버깅 작업에 유용  
- `/kumo/` 아래에 **추가 테스트용 엔드포인트**를 제공  
  - AWS 공식 API의 일부는 아니지만, 테스트 중 애플리케이션 동작을 검증하는 데 유용함  
  - ## SES v2 전송 메일 조회  
    - `GET /kumo/ses/v2/sent-emails`를 통해 **SES v2 `SendEmail` API**로 전송된 이메일 목록을 조회  
    - 응답: MessageId, 발신 주소, 수신자, 제목, 본문, 전송 시각 등이 포함됨  
  - ## Pinpoint SMS Voice v2 전송 메시지 조회  
    - `GET /kumo/pinpointsmsvoicev2/sent-messages`를 통해 **`SendTextMessage` API**로 발송된 SMS 목록을 조회할 수 있음  
    - 응답: MessageId, 수신 전화번호, 발신 식별자, 메시지 본문, 전송 시각 등 포함  
  - 이메일·문자 발송 기능을 테스트할 때 외부 서비스 의존 없이 **결과 검증**을 수행하는 데 특히 유용  
- **MIT License**  
  
### 지원 서비스  
- 총 **76개 AWS 서비스**를 지원  
- ## 스토리지  
  - **S3**, S3 Control, S3 Tables, **DynamoDB**, ElastiCache, MemoryDB, Glacier, EBS 지원임  
- ## 컴퓨트  
  - **Lambda**, Batch, EC2, Elastic Beanstalk 지원임  
- ## 컨테이너  
  - **ECS**, ECR, EKS 지원임  
- ## 데이터베이스  
  - **RDS**, Neptune, Redshift 지원임  
- ## 메시징 및 통합  
  - **SQS**, SNS, EventBridge, Kinesis, Firehose, MQ, Pipes, MSK 지원임  
- ## 보안 및 ID  
  - **IAM**, KMS, Secrets Manager, ACM, Cognito, Security Lake, STS, Macie 지원임  
- ## 모니터링 및 로깅  
  - **CloudWatch**, CloudWatch Logs, X-Ray, CloudTrail 지원임  
- ## 네트워킹 및 콘텐츠 전송  
  - **CloudFront**, Global Accelerator, API Gateway, Route 53, Route 53 Resolver, ELBv2, App Mesh, Location 지원임  
- ## 애플리케이션 통합  
  - **Step Functions**, AppSync, SES v2, Pinpoint SMS Voice v2, Scheduler, Amplify 지원임  
- ## 관리 및 구성  
  - **SSM**, Config, CloudFormation, Organizations, Service Quotas, CodeConnections, Backup 지원임  
- ## 분석 및 ML  
  - **Athena**, Glue, Comprehend, Rekognition, SageMaker, Forecast, Data Exchange, Entity Resolution 지원임  
- ## 개발자 도구  
  - **CodeGuru Profiler**, CodeGuru Reviewer 지원임  
- ## 기타 서비스  
  - **Cost Explorer**, DLM, Directory Service, EMR Serverless, FinSpace, GameLift, Resilience Hub 지원임  
  
### 사용 예제  
- ## S3  
  - **S3 클라이언트**에서 `BaseEndpoint`를 `http://localhost:4566`으로 설정하고 `UsePathStyle`을 활성화해 로컬 에뮬레이터에 연결하는 방식임  
  - 버킷 생성 후 객체 업로드까지 이어지는 흐름을 통해 **오브젝트 스토리지 테스트**를 실제 AWS 없이 재현 가능함  
- ## SQS  
  - **SQS 클라이언트**도 같은 로컬 엔드포인트를 사용하며, 큐 생성 후 메시지 전송과 수신을 수행하는 흐름임  
  - 비동기 메시징 로직을 **로컬 통합 테스트**에서 검증하기 적합함  
- ## DynamoDB  
  - 테이블 생성, 키 스키마 정의, 아이템 저장 과정을 통해 **NoSQL 워크플로**를 재현할 수 있음  
  - 실제 클라우드 자원 없이도 애플리케이션의 데이터 접근 로직을 점검하기 쉬움  
- ## Secrets Manager  
  - 비밀 값 생성과 조회 예시가 포함돼 있어 **시크릿 저장소 연동**도 테스트 가능함  
  - JSON 형태의 민감 정보를 로컬에서 다루는 애플리케이션 검증에 유용함

## Comments



_No public comments on this page._