eventsourcing go

Sourcing d'événements + CQRS à l'aide du didacticiel Go

Arrière-plan

Imaginez que vous travaillez pour un grand éditeur de presse appelé Fairflax Media , inspiré de la fleur de lin (à ne pas confondre avec Fairfax Media, bien sûr).

Vous avez été chargé de diviser l'énorme système monolithique en microservices et de tout déplacer vers Kuberentes. Vous préférez une conception axée sur le domaine et pensez que chaque base de données ne devrait appartenir qu'à une seule application. Mais au fil du temps, on remarque que de nombreux services ont besoin de données communes. Vous devez vous assurer que les données sont cohérentes sur tous les services et que les performances des requêtes sont raisonnables.

Objectifs du projet

• Créez un didacticiel étape par étape pour les microservices asynchrones (opiniâtres) à l'aide de Golang.
• Chaque étape du didacticiel doit se trouver dans une branche git distincte.
• La branche master contient l'état initial - des services étroitement couplés.
• La branche event-sourcing doit contenir l'implémentation Event Sourcing + CQRS, contenant des services asynchrones, indépendants et faciles à tester.
• Présenter des problèmes réels et les résoudre à l'aide d'Event Sourcing + CQRS dans Golang (avec quelques dépendances)
• Utilisez une approche minimaliste et essayez d’utiliser moins de pièces mobiles. (Par exemple, les services sont intentionnellement basiques et n'incluent pas de journalisation, de traçage, de métriques, d'indicateurs de fonctionnalités, de limitation de débit, de conteneurs Docker, d'authentification, d'autorisation, de graphiques de barre K8, de composition de docker, etc.).
• Dans la branche initiale, la base de données est intentionnellement simulée.
• Démontrer l'utilisation de magasins de données en mémoire (par exemple BoltDB et Bleve).
• Soyez plus détaillé et réaliste que l'exemple classique de Hellow World , mais restez minimaliste.
• Démontrer l’utilisation des canaux pour le courtier d’événements de base.

Non-objectifs

• Essayez d'être tout pour tout le monde.
• Montrez comment utiliser Kafka/Kafka Streams.
• Montrez comment utiliser DistributedLog.
• Garantie de livraison en une seule fois.
• Montrez comment enregistrer/restaurer des instantanés et utiliser des systèmes pub/sub avec des périodes de conservation limitées (par exemple AWS Kinesis et Google Cloud Pub/Sub).
• Implémentez une version sans serveur, par exemple en utilisant AWS Lambda ou similaire.
• Utilisez le sourcing d’événements avec un registre/blockchain d’événements décentralisé.

Public cible

Ce projet est destiné à toute personne souhaitant passer à une architecture de microservices asynchrone utilisant Golang.

Conditions préalables

• Passez à la version 1.9 ou ultérieure

• $GOPATH est défini

• dep pour gérer les dépendances

  Sur Mac OSX en utilisant brew ...

   $ brew install dep
  $ brew upgrade dep
  

  Sur d'autres plateformes, vous pouvez utiliser le script install.sh :

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

• Assurez-vous que le PATH contient $GOPATH/bin

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

Installation rapide

 $ 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

Cloner le référentiel

Soit:

 $ 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

Installez ensuite les dépendances :

 $ dep ensure

Essayez-le !

Exécuter dans quatre fenêtres de terminal différentes :

 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

Accédez aux applications dans votre navigateur :

• Interface utilisateur GraphiQL - http://localhost:4001/
• Flux RSS des dernières actualités - http://localhost:4002/feed
• Flux RSS des dernières actualités économiques - http://localhost:4002/feed/business
• Flux RSS des dernières actualités politiques - http://localhost:4002/feed/politics
• (Naïf et inutile) Plan du site - http://localhost:4003/sitemap

Tâches facultatives

Reconstruire le code généré

1. Installer le compilateur Protobuf

2. Installez le plugin protocole Go

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

3. Reconstruire le code Go généré

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

   Ou exécutez la commande protoc (avec le plugin grpc)

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