Repolode
floci-io

floci-io/floci-az

Blob, Queue, Table, Functions, Cosmos DB 등 Azure 호환 서비스를 localhost:4577에서 실행하는 무료 오픈소스 로컬 Azure 에뮬레이터입니다.

대체할 수 있는 제품:Azure Storage EmulatorAzurite

스타
879
포크
161
열린 이슈
40
마지막 커밋
그저께

어떤 프로젝트인가요?

Floci AZ는 개발, 테스트, CI용 로컬 Azure 에뮬레이터입니다. 하나의 포트에서 Azure 호환 서비스를 제공하므로, 클라우드 계정이나 인증 토큰, 기능 제한 없이 기존 Azure SDK, CLI 또는 Terraform 워크플로에서 http://localhost:4577을 대상으로 사용할 수 있습니다.

Blob, Queue, Table Storage, Azure Functions, App Configuration, Key Vault, Event Hubs, Service Bus, Cosmos DB, Azure SQL 및 PostgreSQL, AKS, Container Apps, Redis, Entra ID 토큰 발급 등 폭넓은 서비스를 지원합니다. Functions 런타임, Event Hubs AMQP 브로커, MongoDB 및 PostgreSQL용 Cosmos DB 엔진 등 일부 서비스는 실제 Docker 컨테이너에서 실행되며, 나머지는 프로세스 내에서 구현됩니다.

네이티브 바이너리로 빌드된 Docker 이미지로 배포되며, Cosmos DB Java SDK 같은 클라이언트를 위한 선택적 TLS 지원도 제공합니다. Docker 소켓 접근은 Azure Functions처럼 Docker 기반 서비스를 사용할 때만 필요합니다.

핵심 기능

  • 01계정이나 인증 토큰 없이 단일 포트(4577)에서 다양한 Azure 서비스를 제공합니다.
  • 02Azure Functions, Event Hubs 및 여러 데이터베이스 엔진을 실제 Docker 컨테이너에서 실행합니다.
  • 03기존 연결 문자열과 워크플로를 그대로 유지해 표준 Azure SDK 클라이언트와 함께 사용할 수 있습니다.
  • 04메모리 내, 영구 저장, 하이브리드 및 write-ahead log 저장 모드를 제공합니다.
  • 05런타임에 생성한 자체 서명 인증서를 사용해 같은 포트에서 선택적으로 HTTPS를 지원합니다.

활용 사례

  • 실제 Azure 구독을 사용하지 않고 CI에서 Blob, Queue 또는 Table Storage를 대상으로 통합 테스트를 실행합니다.
  • 프로덕션에서 사용하는 것과 동일한 HTTP 트리거로 Azure Functions를 로컬에서 개발합니다.
  • 로컬 ARM 호환 엔드포인트를 대상으로 Terraform 또는 Bicep 배포를 테스트합니다.
  • 오프라인에서 Cosmos DB SQL API 쿼리와 Event Hubs 프로듀서 및 컨슈머를 테스트합니다.

빠른 시작

  1. 1

    floci-az 서비스가 포함된 docker-compose.yml을 만듭니다

  2. 2

    Docker Compose로 에뮬레이터를 시작합니다

    docker compose up

사용 전 알아둘 점

  • Azure Functions는 Docker socket을 마운트해야 하므로 호스트의 Docker에 액세스할 수 있어야 합니다.
  • Terraform 및 OpenTofu(azurerm)를 사용하려면 선택 사항인 TLS 설정이 필요하며, 기본적으로 활성화되어 있지 않습니다.

포함된 컬렉션

토픽

#azure#emulator#local-development#testing#docker#cloud#ci-cd#azure-devops#azure-functions#azure-functions-core-tools

자주 묻는 질문

floci-az은(는) 무엇인가요?
Blob, Queue, Table, Functions, Cosmos DB 등 Azure 호환 서비스를 localhost:4577에서 실행하는 무료 오픈소스 로컬 Azure 에뮬레이터입니다. Floci AZ는 개발, 테스트, CI용 로컬 Azure 에뮬레이터입니다. 하나의 포트에서 Azure 호환 서비스를 제공하므로, 클라우드 계정이나 인증 토큰, 기능 제한 없이 기존 Azure SDK, CLI 또는 Terraform 워크플로에서 http://localhost:4577을 대상으로 사용할 수 있습니다.
floci-az은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
floci-az은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
floci-az은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. floci-az의 마지막 커밋은 2026년 11월 5일입니다.
floci-az은(는) 어디에 사용할 수 있나요?
실제 Azure 구독을 사용하지 않고 CI에서 Blob, Queue 또는 Table Storage를 대상으로 통합 테스트를 실행합니다. 프로덕션에서 사용하는 것과 동일한 HTTP 트리거로 Azure Functions를 로컬에서 개발합니다. 로컬 ARM 호환 엔드포인트를 대상으로 Terraform 또는 Bicep 배포를 테스트합니다. 오프라인에서 Cosmos DB SQL API 쿼리와 Event Hubs 프로듀서 및 컨슈머를 테스트합니다.
floci-az는 어떻게 설치하나요?
floci-az 서비스가 포함된 docker-compose.yml을 만듭니다 Docker Compose로 에뮬레이터를 시작합니다: docker compose up
floci-az은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/floci-io/floci-az

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트