floci-io/floci

어떤 프로젝트인가요?

핵심 기능

• 01엔드포인트만 변경하면 표준 AWS SDK, CLI, IaC 도구와 함께 사용할 수 있습니다.
• 02Lambda, RDS, ElastiCache, ECS, EC2, EKS를 실제 Docker 기반 서비스로 실행합니다.
• 03메모리, 영구 저장, 하이브리드, write-ahead log 저장 모드를 제공합니다.
• 0412자리 access key ID를 사용해 계정별로 리소스를 격리합니다.
• 05Java, Node.js, Python, .NET용 Testcontainers 모듈을 제공합니다.

활용 사례

• 클라우드 계정 없이 AWS에 의존하는 애플리케이션 코드와 테스트를 로컬에서 실행합니다.
• 실제 인프라 대신 에뮬레이션된 AWS 서비스에 연결해 CI 파이프라인을 실행합니다.
• AWS에 배포하기 전에 Terraform, CDK, OpenTofu 구성을 테스트합니다.
• 기존 Docker Compose 설정에서 LocalStack Community를 대체합니다.

빠른 시작

1. 1

   공식 CLI로 Floci를 시작합니다

   floci start
2. 2

   AWS 환경 변수를 내보냅니다

   eval $(floci env)
3. 3

   표준 AWS CLI 명령을 Floci 대상으로 실행합니다

   aws s3 mb s3://my-bucket

사용 전 알아둘 점

• !일부 서비스는 Docker 기반의 실제 실행을 사용하므로, Docker 엔진이 실행 중이어야 하고 Docker 소켓에 액세스할 수 있어야 합니다.
• !README의 "Web Console" 기능을 사용하려면 Docker 소켓을 컨테이너에 마운트해야 합니다.

토픽

자주 묻는 질문

floci은(는) 무엇인가요?

계정이나 인증 토큰 없이 로컬에서 AWS 서비스를 실행할 수 있는 무료 오픈소스 AWS 에뮬레이터입니다. Floci는 개발, 테스트, CI를 위한 로컬 AWS 에뮬레이터입니다. AWS SDK, CLI, Terraform, CDK, OpenTofu 또는 테스트 스위트가 http://localhost:4566을 바라보도록 설정하면 기존 워크플로를 그대로 사용할 수 있으며, 클라우드 계정이나 인증 토큰, 유료 기능 등급도 필요하지 않습니다.

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

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

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

활발히 유지보수 중. floci의 마지막 커밋은 2026년 10월 20일입니다.

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

클라우드 계정 없이 AWS에 의존하는 애플리케이션 코드와 테스트를 로컬에서 실행합니다. 실제 인프라 대신 에뮬레이션된 AWS 서비스에 연결해 CI 파이프라인을 실행합니다. AWS에 배포하기 전에 Terraform, CDK, OpenTofu 구성을 테스트합니다. 기존 Docker Compose 설정에서 LocalStack Community를 대체합니다.

floci는 어떻게 설치하나요?

공식 CLI로 Floci를 시작합니다: floci start AWS 환경 변수를 내보냅니다: eval $(floci env) 표준 AWS CLI 명령을 Floci 대상으로 실행합니다: aws s3 mb s3://my-bucket

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

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