onofrej / sqssample

This project has the objective to show how to use AWS SQS with .NET.

SqsSample.Worker

Este projeto foi gerado automaticamente pela StackSpot.

Execução do projeto criado

Após criar o projeto, acesse o diretório em que foi criado e execute o seguinte comando:

dotnet restore SqsSample.Worker.sln

Realize também o build do projeto, através do comando abaixo:

dotnet build SqsSample.Worker.sln

Realize a execução dos testes unitários e de integração, através do comando abaixo:

dotnet test SqsSample.Worker.sln

Para testar a aplicação, ainda no diretório, execute o seguinte comando:

dotnet run --project ./src/SqsSample.Worker/SqsSample.Worker.csproj

Em seguida, abra http://localhost:5000/health no seu navegador.

Dica: Neste caso, a estrutura com exemplo foi criada automaticamente.

Configuração do Docker

Para que o Docker funcione, você precisará adicionar um certificado SSL temporário e montar um volume para manter esse certificado. Você pode encontrar no Microsoft Docs que descrevem as etapas necessárias para Windows, macOS e Linux.

Para Windows: O seguinte precisará ser executado a partir do seu terminal para criar um certificado:

dotnet dev-certs https -ep %USERPROFILE%\.aspnet\https\aspnetapp.pfx -p Your_password123
dotnet dev-certs https --trust

NOTA: Ao usar o PowerShell, substitua %USERPROFILE% por $env:USERPROFILE.

PARA macOS:

dotnet dev-certs https -ep ${HOME}/.aspnet/https/aspnetapp.pfx -p Your_password123
dotnet dev-certs https --trust

PARA Linux:

dotnet dev-certs https -ep ${HOME}/.aspnet/https/aspnetapp.pfx -p Your_password123
dotnet dev-certs https --trust

Para construir e executar os containers docker, execute o comando abaixo na raiz da solução onde você encontra o arquivo docker-compose.yml

docker-compose -f 'docker-compose.yml' up --build

. Você também pode usar "Docker Compose" do Visual Studio para fins de debug. Em seguida, abra http://localhost:5000/health no seu navegador.

Visão Geral

Camada de Domain

Contem todas as entidades, enumerações, exceções, interfaces, tipos e lógicas específicas da camada de domínio.

Camada de Application

Essa camada contém toda a lógica do worker. É dependente da camada de domínio, mas não tem dependências de nenhuma outra camada ou projeto. Essa camada define interfaces que são implementadas por camadas externas. Por exemplo, se o aplicativo precisar acessar um serviço de notificação, uma nova interface será adicionada ao aplicativo e uma implementação será criada na infraestrutura.

Camada de Infrastructure

Essa camada contém classes para acessar recursos externos, como sistemas de arquivos, serviços da Web, smtp e assim por diante. Essas classes devem ser baseadas em interfaces definidas na camada de aplicação.

Camada de Worker

Essa camada é um serviço background em net6.0. Essa camada depende das camadas Aplicativo e Infraestrutura, no entanto, a dependência da infraestrutura é apenas para dar suporte à injeção de dependência. Portanto, apenas Program.cs deve fazer referência à infraestrutura.

Componentes Utilizados

• AutoMapper
• FluentAssertions
• MediatR
• Moq
• Shouldly
• WireMock.Net
• xunit

Referências

• Clean Architecture: descubra o que é e onde aplicar Arquitetura Limpa
• Clean Architecture with ASP.NET Core 3.0 • Jason Taylor • GOTO 2019