Repolode
Enviar
floci-io

floci-io/floci-az

Emulador local gratuito e open source do Azure, com serviços compatíveis como Blob, Queue, Table, Functions e Cosmos DB em localhost:4577.

Alternativa open source a:Azure Storage EmulatorAzurite

Ver no GitHubSite
Estrelas
879
Forks
161
Issues abertas
40
Último commit
ontem

O que é?

O Floci AZ é um emulador local do Azure para desenvolvimento, testes e CI. Ele disponibiliza serviços compatíveis com o Azure em uma única porta, permitindo apontar fluxos de trabalho existentes com Azure SDK, CLI ou Terraform para http://localhost:4577, sem precisar de uma conta na nuvem, token de autenticação ou feature gates.

O emulador oferece uma ampla variedade de serviços, incluindo Blob, Queue e Table Storage, Azure Functions, App Configuration, Key Vault, Event Hubs, Service Bus, Cosmos DB, Azure SQL e PostgreSQL, AKS, Container Apps, Redis e emissão de tokens do Entra ID. Alguns serviços rodam em contêineres Docker reais, como os runtimes do Functions, os brokers AMQP do Event Hubs e os mecanismos do Cosmos DB para MongoDB e PostgreSQL; outros são implementados no próprio processo.

Ele é distribuído como uma imagem Docker compilada em um binário nativo, com suporte opcional a TLS para clientes como o Cosmos DB Java SDK. O acesso ao socket do Docker só é necessário para serviços que dependem do Docker, como o Azure Functions.

Recursos principais

  • 01Disponibiliza diversos serviços do Azure em uma única porta, 4577, sem exigir conta ou token de autenticação.
  • 02Executa Azure Functions, Event Hubs e vários mecanismos de banco de dados em contêineres Docker reais.
  • 03Funciona com clientes padrão do Azure SDK, mantendo as strings de conexão e os fluxos de trabalho existentes.
  • 04Oferece modos de armazenamento em memória, persistente, híbrido e com write-ahead log.
  • 05Oferece suporte opcional a HTTPS na mesma porta, com um certificado autoassinado gerado em tempo de execução.

Casos de uso

  • Executar testes de integração com Blob, Queue ou Table Storage no CI sem acessar uma assinatura real do Azure.
  • Desenvolver Azure Functions localmente usando os mesmos gatilhos HTTP da produção.
  • Testar implantações do Terraform ou Bicep em um endpoint local compatível com ARM.
  • Testar consultas da SQL API do Cosmos DB e produtores e consumidores do Event Hubs offline.

Início rápido

  1. 1

    Crie um docker-compose.yml com o serviço floci-az

  2. 2

    Inicie o emulador com o Docker Compose

    docker compose up

Antes de usar

  • O Azure Functions exige a montagem do Docker socket, por isso precisa de acesso ao Docker no host.
  • Terraform e OpenTofu (azurerm) exigem a configuração opcional de TLS, que não vem habilitada por padrão.

Em coleções

Frameworks de teste e ferramentas de automação de testes

Tópicos

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

Perguntas frequentes

O que é floci-az?
Emulador local gratuito e open source do Azure, com serviços compatíveis como Blob, Queue, Table, Functions e Cosmos DB em localhost:4577. O Floci AZ é um emulador local do Azure para desenvolvimento, testes e CI. Ele disponibiliza serviços compatíveis com o Azure em uma única porta, permitindo apontar fluxos de trabalho existentes com Azure SDK, CLI ou Terraform para http://localhost:4577, sem precisar de uma conta na nuvem, token de autenticação ou feature gates.
floci-az é gratuito? Qual é a licença?
floci-az é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
floci-az ainda é mantido?
Manutenção ativa. O último commit de floci-az foi em 5 de nov. de 2026.
Para que posso usar floci-az?
Executar testes de integração com Blob, Queue ou Table Storage no CI sem acessar uma assinatura real do Azure. Desenvolver Azure Functions localmente usando os mesmos gatilhos HTTP da produção. Testar implantações do Terraform ou Bicep em um endpoint local compatível com ARM. Testar consultas da SQL API do Cosmos DB e produtores e consumidores do Event Hubs offline.
Como instalar floci-az?
Crie um docker-compose.yml com o serviço floci-az Inicie o emulador com o Docker Compose: docker compose up
Onde consigo floci-az?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/floci-io/floci-az

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados