microservice bootstrap

マイクロサービスコードテンプレート

dotnet core 2.0 を使用するようにアップグレードされました

Dotnet Core の独自のマイクロサービスで有利なスタートを切ることができる git リポジトリ。

その目的は、.NET ユーザー向けのマイクロサービスの導入障壁を軽減することです。

このリポジトリは、2 種類のマイクロサービスをブートストラップするのに役立ちます。

• ウェブサービス
• ワーカーサービス

これは、有利なスタートを切るのに役立ちます。

1. ASP.NETマイクロサービスの実行
2. Docker を使用したサービスのコンテナ化
3. Travis CI で CI / CD を有利にスタート
4. 基本的な Kinesis イベントデータストリームを消費する

始めましょう

1. リポジトリのクローンを作成する
2. Docker がインストールされていることを確認してください。
3. Visual Studio 2017 またはその他のドットネット互換 IDE を手元に用意します。
4. リポジトリのルート フォルダーからdocker-compose -f docker-compose.yml -f docker-compose.development.yml up -dを実行します。
5. やったー、準備万端、完了！

ワーカーサービスだけを希望する場合はどうすればよいですか?

• WebService および WebService.UnitTests プロジェクトを Visual Studio から削除し、フォルダーを削除します。
• docker compose ファイルからその参照を削除します。
• Web サービスを参照している travis yml のセクションを削除します

Web サービスだけが必要な場合はどうすればよいですか?

• Visual Studio から WorkerService プロジェクトと WorkerService.UnitTests プロジェクトを削除し、フォルダーを削除します。
• docker compose ファイルからその参照を削除します。
• ワーカー サービスを参照している travis yml のセクションを削除します

すべてが順調であることを確認する方法

Webサービス用

 $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 コアをサポートしていませんが、このリポジトリのバージョンはサポートしています。興味のある方は#29へどうぞ。

導入 (これが機能していることを確認する必要があります。作業中です。)

DC2-7 のデプロイメントを実行するには、deploy.sh 内の関連する行のコメントを解除します。

TODO

1. 基本的な依存性注入を含む
2. コードカバレッジと複雑さのメトリクスを含める

テンプレートのアイデア

このサービスは、Sam Newman が文書化したマイクロサービスの原則を考慮して設計されています。

まだ見ていない場合は、見てみると良いビデオです。

マイクロサービスの原則、Sam Newman 著

導入ストーリー

このテンプレートは、サービスを Docker コンテナとしてパッケージ化する方法を提供し、CI には Travis CI を使用します。

オプションとして、Aws ECS / ECR を使用して Docker クラスターを管理することもできますが、それが機能していることがわかりました (特にインフラが aws でホストされている場合)。