microservice bootstrap

Microservice-Code-Vorlage

Auf die Verwendung von Dotnet Core 2.0 aktualisiert

Ein Git-Repo, das Ihnen einen Vorsprung bei Ihrem eigenen Microservice in Dotnet Core verschafft.

Ziel ist es, die Einstiegsbarriere für Microservices für .NET-Benutzer zu verringern.

Das Repo hilft Ihnen beim Bootstrap zweier Arten von Microservices:

• Webdienst
• Arbeiterdienst

Dies wird Ihnen einen Vorsprung verschaffen,

1. Ausführen eines ASP.NET Microservice
2. Containerisieren Sie Ihren Service mit Docker
3. Vorsprung mit CI / CD mit Travis CI
4. Nutzen Sie grundlegende Kinesis-Ereignisdatenströme

Legen Sie los

1. Klonen Sie das Repo
2. Stellen Sie sicher, dass Docker installiert ist.
3. Halten Sie Visual Studio 2017 oder eine andere Dotnet-kompatible IDE bereit
4. Führen Sie docker-compose -f docker-compose.yml -f docker-compose.development.yml up -d aus dem Stammordner des Repos aus.
5. Juhu, alles läuft, fertig!

Was ist, wenn ich nur einen Arbeiterdienst möchte?

• Entfernen Sie WebService- und WebService.UnitTests-Projekte aus Visual Studio und löschen Sie den Ordner
• Entfernen Sie die Verweise aus der Docker-Compose-Datei
• Entfernen Sie Abschnitte von Travis YML, die sich auf den Webdienst beziehen

Was ist, wenn ich nur einen Webservice möchte?

• Entfernen Sie die Projekte „WorkerService“ und „WorkerService.UnitTests“ aus Visual Studio und löschen Sie den Ordner.
• Entfernen Sie die Verweise aus der Docker-Compose-Datei
• Entfernen Sie Abschnitte von Travis YML, die sich auf den Worker-Service beziehen

So stellen Sie sicher, dass alles gut ist

Für Webservice

 $docker-compose ps
                Name                           Command          State            Ports
-----------------------------------------------------------------------------------------------
microservicebootstrap_webservice_1      dotnet run -c Release   Up      0.0.0.0:32769->4000/tcp
microservicebootstrap_workerservice_1   dotnet run -c Release   Up

Rufen Sie die Portnummer mit dem obigen Befehl ab und geben Sie in einem Bash-Terminal curl -i localhost:32769/healthcheck um zu sehen, ob der Webdienst ausgeführt wird. Klopfen Sie sich selbst auf die Schulter!

Erwartete Antwort

 HTTP/1.1 200 OK
Date: Wed, 19 Jul 2017 01:57:31 GMT
Content-Length: 0
Server: Kestrel

Für den Arbeiterdienst

Führen Sie docker-compose logs aus und sehen Sie sich „Hello World“ an, um zu bestätigen, dass Ihr Worker-Dienst ausgeführt wird. Klopfen Sie sich noch einmal selbst auf die Schulter!

Kinesis-Verbraucher für den Worker-Dienst

Die Einrichtung eines Kinesis-Verbrauchers für den Arbeitsdienst ist in Arbeit. Die aktuelle Idee besteht darin, zu sehen, ob wir einen Kinesis-Konsumenten haben können, der mit etwas wie @sbarski KinesisNet in den Worker-Dienst eingefügt werden kann. Das Repo von @sbarski unterstützt Dotnet Core nicht, die Version in diesem Repo jedoch schon. Wenn Sie interessiert sind, gehen Sie bitte zu Nr. 29.

Bereitstellung (Es muss sichergestellt werden, dass dies funktioniert. In Arbeit.)

Kommentieren Sie die relevanten Zeilen in „deploy.sh“ aus, um die DC2-7-Bereitstellung auszuführen.

TODO

1. Dazu gehört die grundlegende Abhängigkeitsinjektion
2. Beziehen Sie Codeabdeckungs- und Komplexitätsmetriken ein

Vorlagenidee

Der Dienst wurde unter Berücksichtigung der von Sam Newman dokumentierten Prinzipien von Microservices entwickelt.

Es ist ein gutes Video, das Sie sich ansehen sollten, falls Sie es noch nicht gesehen haben.

Prinzipien von Microservices, von Sam Newman

Bereitstellungsgeschichte

Die Vorlage bietet die Möglichkeit, den Dienst als Docker-Container zu verpacken und verwendet Travis CI für CI.

Eine Option besteht darin, Aws ECS/ECR zur Verwaltung des Docker-Clusters zu verwenden und festgestellt zu haben, dass es funktioniert (insbesondere, wenn Ihre Infrastruktur auf aws gehostet wird).