e-Shop | Cloud Native

Cloud Native | Cloud Agnostic | Hexagonal Architecture | Event Driven Architecture

Loja Virtual feita com .NET seguindo Cloud Native (Containers, Microservice, DevOps, Continuous Delivery), Cloud Agnostic, Hexagonal Architecture, Event Driven Architecture. Desenvolvido com .NET 6, usando Visual Studio e Docker, pronto para ser executado no kubernetes em produção.

Baixando e Executando o projeto

Esse projeto foi pensado em endereçar problemas reais de um cenário crítico de microsserviços. Assim uma das necessidades em um projeto dessa natureza é poder controlar versões de cada microsserviço de forma independente. Permitindo que os times trabalhem de forma independente. Dada a forma como o git trabalha, gitmodules é uma das estratégias para conseguir o mínimo de sanidade nessa tarefa.

🎯 Esse projeto usa git modules, portanto não ignore o parâmetro --recursive na hora do clone.

git clone https://github.com/luizcarlosfaria/eshop-cloudnative.git --recursive
cd ./eshop-cloudnative

Subindo Serviços de Infra

Opção 1 - Serviços mínimos

./_run-infra-light.sh

Nesta opção os seguintes serviços não são criados:

OpenSearch (Similar ao ElasticSearch)
OpenSearch Dashboard (Similar ao Kibana)
LogStash

Opção 2 - Serviços mínimos + Enterprise Application Log

no WSL 2 execute

sysctl -w vm.max_map_count=262144

./_run-infra-full.sh

Agora basta abrir o visual studio e rodar a aplicação pelo docker compose.

Ou executar docker compose up --build

Agora basta acessar http://localhost:90/ no seu navegador.

100% Cloud Agnostic

Nenhuma dependência de NENHUM CLOUD PROVIDER!

Todas os serviços, aplicações e dependências podem ser instaladas em qualquer Cloud Provider, nosso setup tem única e exclusiva dependência: o Kubernetes. As instalações podem ser realizadas em qualquer cloud provider, como Azure, AWS, GCP em soluções como AKS, EKS ou GKE ou ainda em serviços como Hetzner, Scaleway e Digital Ocean ou mesmo em máquinas virtuais ou bare metal na nuvem ou On-Premise.

Um dos objetivos desse projeto é demonstrar como podemos não depender dos Cloud Providers para criar soluções incríveis.

Sub Modules

Infra | Infraestrutura de Produção

Catalog | Produtos, Categorias, Menu, Imagens

Profile | Endereço e Dados Pessoais

Architecture | Infraestrutura base que molda a aplicação.

Foco da Solução

Backend
Arquitetura
Containers
Microsserviços
Mensageria
Event Driven Architecture
Agnostic Service
Hexagonal Architecture

Entendendo a stack

sequenceDiagram
    autonumber
    actor Usuario
    participant VarnishCache
    participant WebApp
    participant Kong
    participant WebAPI
    participant Postgres
    participant Minio
    
    Usuario->>VarnishCache: Exibir home
    activate VarnishCache
    VarnishCache->>WebApp: GET /
    activate WebApp
    WebApp->>Kong:  GET /catalog/Category/HomeCatalog
    activate Kong
    Kong->>WebAPI: GET /Category/HomeCatalog
    activate WebAPI
    WebAPI->>Postgres: Select * from...
    activate Postgres
    Note over VarnishCache,Postgres: Obtenção de dados
    Postgres-->>WebAPI: {dados}
    deactivate Postgres
    WebAPI-->>Kong: Response...
    deactivate WebAPI
    Kong-->>WebApp: Response...
    deactivate Kong
    WebApp-->>VarnishCache: Response...    
    deactivate WebApp
    VarnishCache-->>Usuario: Response... 
    deactivate VarnishCache
    

    Usuario->>VarnishCache: Exibir imagem
    activate VarnishCache
    VarnishCache->>Kong: GET /minio/catalog-images/67001dd3-b0e1-4ed2-80f7-8cdf9454f556
    activate Kong
    Kong->>Minio:  GET /catalog-images/67001dd3-b0e1-4ed2-80f7-8cdf9454f556
    activate Minio
    Note over VarnishCache,Minio: Obtenção de Imagens
    Minio-->>Kong: {stream}
    deactivate Minio
    Kong-->>VarnishCache: Response...   
    deactivate Kong 
    VarnishCache-->>Usuario: Response...  
    deactivate VarnishCache

O Varnish tem o papel de simular Akamai e qualquer outro cache service.

A web app é nossa aplicação web. Nesse momento ela ainda é uma aplicação ASP.NET Core MVC, com front-end desenvolvido com Tailwind CSS e VueJS.

Entre a aplicação web e a WebAPI temos o Kong como nosso API Gateway.

Todas as API's só aceitam requisições oriundas do Kong. Assim garantimos autenticação (e não autorização), visando conseguir determinar com clareza, quais serviços estão consumindo quais API's. No banco de dados temos o Postgres, implantado no Kubernetes em um cluster totalizando 1 master e 2 replicas.

O minio é nosso Object Storage, ele, assim como o cluster RabbitMQ e o cluster Postgres estão usando Longhorn para block storage com volumes replicados em todo o cluster.

Entendendo os serviços

Projeto final Cloud Native .NET

Esse projeto tem a missão de ser o projeto final do Cloud Native .NET.

Ele aglutina diversas jornadas de entendimento do desenho de uma arquitetura. Com ele podemos falar de agnóstic services, podemos falar de mensageria, de event driven architecture, de injeção de dependência, de exception management, de alm, gerência de configuração, RabbitMQ, Redis, Logging, Métricas, API Gateway e muito mais.

Caso queira participar e ver aulas sobre esse projeto, visite cloudnative.net.br e descubra como se tornar aluno.

Quer entender as decisões técnicas desse projeto?

Esse projeto conta com um Decision Log contendo todas as grandes decisões de arquitetura, design e estratégia de codificação do projeto.

🚨 Clique na imagem acima para ver ler sobre as decisões técncias do projeto

Parte importante é demonstrar como conseguimos endereçar cada assunto do nosso board no código.

Ação e reação

Os eventos que produzem mudanças na arquitetura, no design, na infraestrutura.

Um guia sobre a história do projeto.

🚨 Clique na imagem acima para ver toda a história do projeto

luizcarlosfaria / eshop-cloudnative