ministackorg/ministack

어떤 프로젝트인가요?

핵심 기능

• 01S3, SQS, DynamoDB, Lambda, Step Functions 등을 포함해 60개 이상의 AWS 서비스를 단일 포트에서 에뮬레이션합니다.
• 02엔드포인트 URL을 변경하면 boto3, AWS CLI, Terraform, CDK, Pulumi에서 사용할 수 있습니다.
• 03액세스 키를 기준으로 계정별, 리전을 기준으로 리전별 상태를 격리합니다.
• 04RDS와 ElastiCache를 위해 실제 Postgres, MySQL, Redis, Valkey 컨테이너를 실행합니다.
• 05테스트 스위트에서 사용할 수 있도록 reset 엔드포인트와 조회 엔드포인트를 제공합니다.

활용 사례

• 실제 AWS 자격 증명 없이 CI에서 AWS에 의존하는 통합 테스트를 실행합니다.
• 에뮬레이션된 SQS, SNS, EventBridge를 대상으로 Lambda 함수와 이벤트 기반 워크플로를 로컬에서 개발합니다.
• AWS에 배포하기 전에 Terraform 또는 CDK 인프라 코드를 테스트합니다.
• 로컬 개발 환경에서 유료 LocalStack 설정을 대체합니다.

빠른 시작

1. 1

   PyPI에서 설치

   pip install ministack
2. 2

   MiniStack 시작(포트 4566에서 실행)

   ministack
3. 3

   서버가 실행 중인지 확인

   curl http://localhost:4566/_ministack/health

사용 전 알아둘 점

• !Athena SQL 쿼리와 일부 실제 데이터베이스 기능을 사용하려면 더 큰 전체 Docker 이미지가 필요합니다.
• !RDS, ElastiCache, ECS, Lambda 컨테이너를 사용하려면 Docker 소켓을 마운트해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

ministack은(는) 무엇인가요?

boto3, AWS CLI, Terraform과 호환되는 무료 오픈소스 로컬 AWS 에뮬레이터로, 60개 이상의 AWS 서비스를 단일 포트에서 실행합니다. MiniStack은 개발자가 AWS 계정 없이 자신의 컴퓨터나 CI에서 S3, SQS, SNS, DynamoDB, Lambda, IAM, EC2, Step Functions와 수십 가지 다른 AWS 서비스를 실행할 수 있게 해주는 로컬 AWS 에뮬레이터입니다. 모든 서비스가 기본 포트 4566의 단일 엔드포인트로 제공되므로, 기존 boto3, AWS CLI, Terraform, CDK, Pulumi 설정에서 엔드포인트 URL만 바꾸면 됩니다.

ministack은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ministack은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ministack은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. ministack의 마지막 커밋은 2026년 11월 6일입니다.

ministack은(는) 어디에 사용할 수 있나요?

실제 AWS 자격 증명 없이 CI에서 AWS에 의존하는 통합 테스트를 실행합니다. 에뮬레이션된 SQS, SNS, EventBridge를 대상으로 Lambda 함수와 이벤트 기반 워크플로를 로컬에서 개발합니다. AWS에 배포하기 전에 Terraform 또는 CDK 인프라 코드를 테스트합니다. 로컬 개발 환경에서 유료 LocalStack 설정을 대체합니다.

ministack는 어떻게 설치하나요?

PyPI에서 설치: pip install ministack MiniStack 시작(포트 4566에서 실행): ministack 서버가 실행 중인지 확인: curl http://localhost:4566/_ministack/health

ministack은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ministackorg/ministack