프로젝트 소개

fakecloud는 통합 테스트 및 로컬 개발을 위해 설계된 무료 오픈소스 로컬 AWS 에뮬레이터입니다. 특히 2026년 3월 LocalStack Community Edition이 독점 라이선스로 전환된 이후, LocalStack의 대체 솔루션으로 자리매김하고 있습니다. 이 프로젝트는 약 19MB의 단일 바이너리로 제공되며 약 300ms 만에 시작되어 http://localhost:4566에서 수신 대기하므로, 더미 자격 증명으로 AWS SDK 및 CLI를 연결할 수 있습니다. 주요 기능은 다음과 같습니다: - **광범위한 서비스 지원**: S3, DynamoDB, SQS, SNS, EventBridge, Lambda, IAM, STS, KMS, Secrets Manager, CloudFormation, SES, Cognito, Kinesis, RDS, ElastiCache, ECS/ECR, EC2, Step Functions, API Gateway, Bedrock을 포함한 105개 AWS 서비스와 7,508개 작업을 지원합니다. - **적합성 테스트**: 이 프로젝트는 AWS 자체 Smithy 모델에 대해 검증된 248,557개의 테스트 변형이 모든 커밋에서 통과하여 100% Smithy 적합성을 주장합니다. CI는 또한 업스트림 terraform-provider-aws TestAcc 스위트를 실행합니다. - **실제 크로스 서비스 연동**: EventBridge에서 Step Functions로, S3에서 Lambda로, SES 인바운드에서 S3/SNS/Lambda로의 통합이 종단 간 실행됩니다. - **상태 저장 서비스 인프라**: Lambda(23개 런타임), RDS(6개 실제 엔진), ElastiCache, ECS, EC2가 실제 컨테이너로 실행되며, 선택적으로 Kubernetes Pod 백엔드를 지원합니다. - **Bedrock 에뮬레이션**: 실제 InvokeModel/Converse 스트리밍, 가드레일, 에이전트, 플로우를 포함한 4개 API에서 216개 작업을 제공하며, 구성 가능한 응답 및 장애 주입을 지원합니다. - **자체 테스트 SDK**: TypeScript, Python, Go, PHP, Java, Rust, C#/.NET용으로 제공되며, 전송된 이메일, SNS 메시지, Lambda 호출과 같은 부작용에 대한 테스트 어서션을 가능하게 합니다. - **보안 옵션**: 선택적 SigV4 검증 및 IAM 강제(소프트 또는 엄격 모드)를 지원합니다. - **호환성**: S3 가상 호스트 변형을 포함한 LocalStack 및 실제 AWS URL 패턴을 모두 지원합니다. 이 프로젝트는 AGPL-3.0-or-later 라이선스로 제공되며, 카피레프트 조항은 fakecloud 자체를 네트워크 서비스로 수정 및 재배포하는 경우에만 적용됩니다. 설치 옵션에는 셸 스크립트, Homebrew, Cargo, Docker, Docker Compose, 소스 빌드가 포함됩니다. 문서는 fakecloud.dev에서 제공되며, 패리티 매트릭스, 서비스별 문서, CI 설정, Bedrock 테스트, Kubernetes 백엔드 구성 가이드를 포함합니다.