eventsourcing go

Tutorial de fornecimento de eventos + CQRS usando Go

Fundo

Imagine que você trabalha para uma grande editora de notícias chamada Fairflax Media , inspirada na flor de linho (não confundir com a Fairfax Media, é claro).

Você foi encarregado de dividir o enorme sistema monolítico em microsserviços e mover tudo para Kuberentes. Você prefere um design orientado a domínio e acredita que cada banco de dados só deve pertencer a um único aplicativo. Mas com o passar do tempo, você percebe que muitos serviços precisam de dados comuns. Você precisa ter certeza de que os dados são consistentes em todos os serviços e que o desempenho da consulta é razoável.

Metas do Projeto

• Crie um tutorial passo a passo para microsserviços assíncronos (opinativos) usando Golang.
• Cada etapa do tutorial deve estar em uma ramificação git separada.
• A ramificação master contém o estado inicial - serviços fortemente acoplados.
• O ramo event-sourcing deve conter a implementação Event Sourcing + CQRS, contendo serviços assíncronos, independentes e fáceis de testar.
• Apresente problemas reais e resolva-os usando Event Sourcing + CQRS em Golang (com algumas dependências)
• Use uma abordagem minimalista e tente usar menos peças móveis. (Por exemplo, os serviços são intencionalmente mantidos básicos e não incluem registro adequado, rastreamento, métricas, sinalizadores de recursos, limitação de taxa, contêineres docker, autenticação, autorização, gráficos de leme K8s, docker-compose etc.).
• Na ramificação inicial, o banco de dados é simulado intencionalmente.
• Demonstrar o uso de armazenamentos de dados na memória (por exemplo, BoltDB e Bleve).
• Seja mais detalhado e realista do que o exemplo normal do Hellow World , mas permaneça minimalista.
• Demonstre o uso de canais para o corretor de eventos básico.

Não-metas

• Tente ser tudo para todos.
• Demonstre como usar fluxos Kafka/Kafka.
• Demonstre como usar o DistributedLog.
• Garanta a entrega exatamente uma vez.
• Mostre como salvar/restaurar snapshots e usar sistemas pub/sub com períodos de retenção limitados (por exemplo, AWS Kinesis e Google Cloud Pub/Sub).
• Implemente a versão sem servidor, por exemplo, usando AWS Lambda ou similar.
• Use o fornecimento de eventos com um livro-razão/blockchain de eventos descentralizado.

Público-alvo

Este projeto é destinado a qualquer pessoa disposta a mudar para uma arquitetura de microsserviço assíncrona usando Golang.

Pré-requisitos

• Vá para 1.9 ou posterior

• $GOPATH está definido

• dep para gerenciar dependências

  No Mac OSX usando brew ...

   $ brew install dep
  $ brew upgrade dep
  

  Em outras plataformas você pode usar o script install.sh:

   $ curl https://raw.githubusercontent.com/golang/dep/master/install.sh | sh
  

• Adicione garantir que o PATH contenha $GOPATH/bin

   $ go help gopath
  $ export PATH=$PATH:$GOPATH/bin
  

Instalação rápida

 $ go get -u github.com/pavelnikolov/eventsourcing-go/demo-articles
$ go get -u github.com/pavelnikolov/eventsourcing-go/demo-graph
$ go get -u github.com/pavelnikolov/eventsourcing-go/demo-sitemap
$ go get -u github.com/pavelnikolov/eventsourcing-go/demo-rss

Clonar o repositório

Qualquer:

 $ go get -u github.com/pavelnikolov/eventsourcing-go/...

Ou:

 $ mkdir -p $GOPATH/github.com/pavelnikolov
$ cd $GOPATH/github.com/pavelnikolov
$ git clone github.com/pavelnikolov/eventsourcing-go

Em seguida instale as dependências:

 $ dep ensure

Experimente!

Execute em quatro janelas de terminal diferentes:

 go install ./cmd/demo-articles && demo-articles
go install ./cmd/demo-graph && demo-graph
go install ./cmd/demo-rss && demo-rss
go install ./cmd/demo-sitemap && demo-sitemap

Navegue até os aplicativos em seu navegador:

• IU GraphiQL - http://localhost:4001/
• Feed RSS de últimas notícias - http://localhost:4002/feed
• Feed RSS de últimas notícias de negócios - http://localhost:4002/feed/business
• Últimas notícias políticas RSS feed - http://localhost:4002/feed/politics
• (Ingênuo e inútil) Sitemap - http://localhost:4003/sitemap

Tarefas opcionais

Reconstrua o código gerado

1. Instale o compilador protobuf

2. Instale o plugin protoc Go

    $ go get -u github.com/golang/protobuf/protoc-gen-go
   

3. Reconstrua o código Go gerado

    $ go generate github.com/pavelnikolov/eventsourcing-go/...
   

   Ou execute o comando protoc (com o plugin grpc)

    $ protoc -I publishing/ publishing/publishing.proto --go_out=plugins=grpc:publishing