microservice bootstrap

Шаблон кода микросервиса

Обновлено для использования dotnet core 2.0.

Репозиторий git, который дает вам возможность начать работу над собственным микросервисом в Dotnet Core.

Цель состоит в том, чтобы снизить входной барьер при использовании микросервисов для пользователей .NET.

Репозиторий поможет вам запустить два типа микросервисов:

• Веб-сервис
• Рабочий сервис

Это поможет вам начать работу с:

1. Запуск микросервиса ASP.NET
2. Контейнеризация вашего сервиса с помощью Docker
3. Начало работы с CI/CD с Трэвисом CI
4. Использование основных потоков данных о событиях Kinesis

Начать

1. Клонировать репозиторий
2. Убедитесь, что у вас установлен Docker.
3. Имейте под рукой Visual Studio 2017 или любую другую IDE, совместимую с Dotnet.
4. Запустите docker-compose -f docker-compose.yml -f docker-compose.development.yml up -d из корневой папки репо.
5. Ура, все готово, готово!

Что, если мне просто нужно рабочее обслуживание?

• Удалите проекты WebService и WebService.UnitTests из Visual Studio и удалите папку.
• Удалите его ссылки из файла компоновки докера.
• Удалить разделы travis yml, относящиеся к веб-сервису.

Что, если мне просто нужен веб-сервис?

• Удалите проекты WorkerService и WorkerService.UnitTests из Visual Studio и удалите папку.
• Удалите его ссылки из файла компоновки докера.
• Удалите разделы 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 чтобы проверить работу веб-службы. Похлопайте себя по спине!

Ожидаемый ответ

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

Для обслуживания работников

Запустите docker-compose logs и посмотрите «Hello world», чтобы убедиться, что ваша рабочая служба работает. Похлопайте себя по спине еще раз!

Потребитель Kinesis для службы Worker

Работа над созданием потребителя kinesis для обслуживания рабочих находится в стадии разработки. Текущая идея состоит в том, чтобы посмотреть, сможем ли мы создать потребителя kinesis, которого можно будет внедрить в рабочий сервис, используя что-то вроде @sbarski KinesisNet. Репозиторий @sbarski не поддерживает ядро ​​dotnet, но версия в этом репозитории поддерживает. Если вам интересно, перейдите на № 29.

Развертывание (необходимо убедиться, что это работает... работа ведется...)

Раскомментируйте соответствующие строки в файле Deploy.sh, чтобы запустить развертывание DC2-7.

TODO

1. включить базовую инъекцию зависимостей
2. Включите показатели покрытия и сложности кода.

Идея шаблона

Служба разработана с учетом принципов микросервисов, описанных Сэмом Ньюманом.

Это хорошее видео, которое стоит посмотреть, если вы еще этого не сделали.

Принципы микросервисов, Сэм Ньюман

История развертывания

Шаблон предоставляет возможность упаковать службу в виде контейнера Docker и использует Travis CI для CI.

Вариант — использовать Aws ECS/ECR для управления кластером докеров и убедиться, что он работает (особенно, когда ваша инфраструктура размещена на aws).