microservice bootstrap

微服務代碼模板

升級為使用 dotnet core 2.0

一個 git 儲存庫，可協助您在 Dotnet Core 中建立自己的微服務。

目的是降低 .NET 用戶使用微服務的門檻。

此儲存庫將幫助您引導兩種微服務，

• 網路服務
• 工人服務

這將幫助您搶佔先機，

1. 運行 ASP.NET 微服務
2. 使用 Docker 容器化您的服務
3. 透過 Travis CI 開始 CI/CD
4. 使用基本 Kinesis 事件資料流

開始使用

1. 克隆儲存庫
2. 確保您已安裝 Docker。
3. 方便使用 Visual studio 2017 或任何其他 dotnet 相容的 IDE
4. 從儲存庫的根資料夾執行docker-compose -f docker-compose.yml -f docker-compose.development.yml up -d 。
5. 一切就緒並運行，完成！

如果我只想要工人服務怎麼辦？

• 從 Visual Studio 中刪除 WebService 和 WebService.UnitTests 專案並刪除資料夾
• 從 docker compose 檔案中刪除其引用
• 刪除 travis yml 中引用 Web 服務的部分

如果我只想要 Web 服務怎麼辦？

• 從 Visual Studio 中刪除 WorkerService 和 WorkerService.UnitTests 專案並刪除該資料夾。
• 從 docker compose 檔案中刪除其引用
• 刪除 travis yml 中涉及工作人員服務的部分

如何確保一切順利

對於網路服務

 $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

從上面的命令取得連接埠號，並在 Bash 終端機中curl -i localhost:32769/healthcheck以查看 Web 服務正在執行。拍拍自己的背！

預期回應

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

為工人服務

執行docker-compose logs並查看“Hello world”以確認您的工作服務正在運行。再次拍拍自己的背！

Worker 服務的 Kinesis 消費者

為工作者服務提供 kinesis 消費者是一項正在進行的工作。目前的想法是看看我們是否可以擁有可以使用 @sbarski KinesisNet 之類的東西注入工作服務的 kinesis 消費者。 @sbarski 的儲存庫不支援 dotnet core，但此儲存庫中的版本支援。如果您有興趣，請前往#29。

部署（需要確保其正常工作..正在進行中..）

取消註解deploy.sh中的相關行以使DC2-7部署運作。

待辦事項

1. 包括基本的依賴注入
2. 包括程式碼覆蓋率和複雜性指標

模板創意

該服務的設計考慮了 Sam Newman 記錄的微服務原則。

如果您還沒有看過，這是一個值得觀看的影片。

微服務原理，作者：Sam Newman

部署故事

此範本提供了將服務打包為 Docker 容器的方法，並使用 Travis CI 進行 CI。

一個選擇是使用 Aws ECS / ECR 來管理 docker 集群，並發現它正在工作（特別是當您的基礎設施託管在 aws 上時）。