MVFC.Aspire.Helpers 1.0.6

MVFC.Aspire.Helpers

Conjunto de helpers para projetos .NET Aspire, incluindo integrações com Google Pub/Sub, Cloud Storage (emulador GCS) e MongoDB (com Replica Sets).

Visão Geral

Este projeto facilita a configuração e integração de recursos essenciais para aplicações distribuídas .NET Aspire, fornecendo métodos de extensão para:

• Google Cloud Storage (emulador GCS)
• MongoDB com Replica Set
• Google Pub/Sub (emulador e UI)

Além disso, inclui uma API de exemplo (MVFC.Aspire.Helpers.Api) e um AppHost para orquestração (MVFC.Aspire.Helpers.AppHost.AppHost).

Estrutura do Projeto

• MVFC.Aspire.Helpers: Biblioteca de helpers e extensões.
• MVFC.Aspire.Helpers.Api: API de exemplo com endpoints para MongoDB, Cloud Storage e Pub/Sub.
• MVFC.Aspire.Helpers.AppHost.AppHost: Orquestração de teste dos recursos usando Aspire.
• MVFC.Aspire.Helpers.AppHost.Tests: Testes automatizados para os endpoints.

Funcionalidades

Cloud Storage

• Adiciona e integra um emulador GCS usando a imagem fsouza/fake-gcs-server.
• Permite persistência opcional dos buckets via bind mount.
• Exemplo de uso: CloudStorageExtensions.

MongoDB

• Adiciona um container MongoDB configurado como Replica Set.
• Inicializa automaticamente o Replica Set via script.
• Exemplo de uso: MongoExtensions.

Pub/Sub

• Adiciona o emulador do Google Pub/Sub e interface de administração (UI).
• Cria tópicos e assinaturas automaticamente conforme configuração.
• Suporte a assinaturas do tipo push e pull.
• Exemplo de uso: PubSubExtensions.

API de Exemplo

• Endpoints para testar integração com MongoDB, Cloud Storage e Pub/Sub:
  • /api/mongo
  • /api/bucket/{bucketName}
  • /api/pub-sub-enter
  • /api/pub-sub-exit
• Implementações em Endpoints.

Instalação

Adicione o pacote NuGet ao seu projeto AppHost:

dotnet add package MVFC.Aspire.Helpers

Exemplo de Uso no AppHost

var builder = DistributedApplication.CreateBuilder(args);

var messageConfig = new MessageConfig(
                            TopicName: "test-topic",
                            SubscriptionName: "test-subscription",
                            PushEndpoint: "/api/pub-sub-exit");

var pubSubConfig = new PubSubConfig(
                            projectId: "test-project",
                            messageConfig: messageConfig);

IList<IMongoClassDump> dumps = [
    new MongoClassDump<TestDatabase>("TestDatabase", "TestCollection", 100,
        new Faker<TestDatabase>()
              .CustomInstantiator(f => new TestDatabase(f.Person.FirstName, f.Person.Cpf())))
];

builder.AddProject<Projects.MVFC_Aspire_Helpers_Api>("api-exemplo")
       .WithCloudStorage(builder, "cloud-storage", "./bucket-data")
       .WithMongoReplicaSet(builder, "mongo", dumps: dumps)
       .WithGcpPubSub(builder, "gcp-pubsub", pubSubConfig);

await builder.Build().RunAsync();