/Microservice-Template

Template for microservice module based on the ASP.NET Core platform. (NET Core 3.1, NET 5, NET 6)

Primary LanguageC#MIT LicenseMIT

Информация

Справочная информация по фреймворку есть в Wiki и на сайте разработчика. Видео презентация новой версии Nimble Framework v.6.

Новости

21.11.2021

На платформе NET6 (В папке AspNetCore v6.0) теперь существует два вида шаблонов микросервисов (FullAPI и MinimalAPI), каждый из которых содержит IdentityModel и простой Module. Папка FullAPI содержит уже знакомые шаблоны микросервисов, просто они теперь переведены на NET6. А в папке MinimalAPI новая версия тех же шаблонов, которые построены на базе MinimalAPI.

09.11.2021:

  1. Удалены старые шаблоны для версий NET Core 2.2 и NET Core 3.0.
  2. Началась разработка шаблонов для новой версии.

История версий Nimble Framework

v.6.0.0 от 12.11.2022

  1. Шаблоны микросервисов переведены на новую версию NET6. Обновлены почти все файлы, использованы новые "фишки", которые появились в C#.
  2. Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). Теперь используются версии NET6.
  3. Удалены дубликаты контроллеров, которые демонстрировали использовать подхода Readonly/Writable (Calabonga.UnitOfWork.Controllers). Теперь остался только один пример, построенный на базе Mediatr.
  4. Обновлена инфраструктура папок. Использована Vertical Slice Architecture, которую представил Jimmy Bogard.
  5. Обновилось расширение VSIX-расширения для Visual Studio.

v.5.0.8 от 31.10.2021:

  1. Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). А также nuget-пакет FluentValidation и другие.
  2. Конструкции некоторых методов переведин на lambda-выражения, чтобы следовать моде.
  3. Обновилось расширение VSIX-расширения для Visual Studio.

v.5.0.7 от 06.09.2021:

  1. Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). А также nuget-пакеты Calabonga.Microservices.Core, FluentValidation и другие.
  2. Добавлено несколько комментариев в код для обеспечения определенности в действиях
  3. Обновилось расширение VSIX-расширения для Visual Studio.

v.5.0.6 от 09.08.2021:

  1. Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core, Swagger, FluentValidation и другие.
  2. Обновились метаданные, используемые для VSIX-расширения для Visual Studio.

v.5.0.5 от 04.06.2021:

  1. Исправлено несколько опечаток.
  2. Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core, Swagger, FluentValidation и другие.

v.5.0.4 от 23.03.2021:

  1. Стандартный logger заменен на Serilog. Теперь читать логи стало проще.
  2. Исправлено несколько опечаток.
  3. Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core и другие.
  4. Реализация Mediatr-запросов (Request) из классов превратились в записи (class -> record) С#.

v.5.0.3 от 16.03.2021:

  1. Удалена зависимость от некоторых сборок, которые вынесены на более высокий уровень. Это позволит обновлять их отдельно.
  2. Исправлено несколько опечаток.
  3. Обновились сборки для ASP.NET Core и EntityFrameworkCore до версий (5.0.4). А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core и другие.
  4. Реализация Mediatr-запросов из контроллеров перенесены в проекты шаблонов из сборки Calabonga.AspNetCore.Controllers, чтобы примеры использования были доступны разработчику.

v.5.0.2 от 27.01.2021:

  1. Применены языковые фишки из C# 9.0. Другими словами, был неслабый рефакторинг кода для оптимизации.
  2. Исправлено несколько опечаток.
  3. Обновились сборки для ASP.NET Core и EntityFramework Core до версий (5.0.2). А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core и другие.

v.5.0.1 от 04.12.2020:

  1. В шаблоне микросервиса с IdentityServer4 и шаблоне без него удалены проекты xxx.Core. Файлы из этих проектов перенесены в проект xxx.Entities. Ссылки на Exceptions вынесены в nuget-пакет Calabonga.Microservices.Core.
  2. В шаблоне микросервиса с IdentityServer4 добавлена возможность аутентификации как для Cookie типа, так и для Bearer. Да! Теперь настроено два типа аутентификации.
  3. Применены языковые фишки из C# 8.0. Другими словами, был неслабый рефакторинг кода для оптимизации.
  4. Исправлено множество опечаток.

v.5.0.0 от 15.11.2020:

  1. Все проекты во всех решениях (solutions) обновились до версии .NET 5.0.
  2. Обновились nuget-сборки для ASP.NET Core и EntityFramework Core (5.0.0).
  3. Добавилась реализация логирования, как пример использования, который описан на видео ILogger в ASP.NET Core
  4. На страницу API (Swagger) выведена информация о названии ветки (branch) и номер публикации (commit).

Logo

Документация

Документация доступна на GitHub в разделе Wiki (в режиме наполнения).

Микросервисы

Шаблон (template) для Visual Studio для построения инфраструктуры микросервисов на базе ASP.NET Core.

Microservices

Visual Studio project template for microservice module base on ASP.NET Core

Скачать (Download)

ASP NET Core 3.1 - Шаблоны для версии ASP.NET Core 3.1

ASP NET Core 5.0 - Шаблоны для версии ASP.NET Core 5.0

ASP NET Core 6.0 - Шаблоны для версии ASP.NET Core 6.0

Инструкции и дополнительные материалы

Установка Nimble Templates

Calabonga.AspNetCore.Controllers nuget-пакет на базе Mediatr

Calabonga.UnitOfWork.Controllers nuget-пакет на base Readonly/Writable controllers

Микросервисы: Шаблон для микросервиса

Микросервисы: Управление доступом

Микросервисы: Обмен данными между микросервисами

Микросервисы: Прокси для frontend

Вопросы можно задать в блоге

Видео по версии 6.0

Nimble Framework v.6

Видео по версии 3.1 (3.0)

Часть 0. Nimble: Установка шаблонов для микросервисов

Часть 1. Nimble: Демонстрация шаблона микросервиса на примере

Часть 2. Nimble: Установка шаблонов для микросервисов

Часть 3. Nimble: Основные и базовые понятия

Часть 4. Nimble: Создаем свой Query и Handler для IMediator

Микросервисы 2 (плей-лист)

Видео по версии 2.2

Микросервисы (плей-лист)

Visual Studio Extensions

Теперь шаблоны для генерации микросервисов доступны также и в Visual Studio Marketplace

marketplace

Посмотреть marketplace

Также можно установить прямо из Visual Studio extension

Дополнительные материалы по Nimble Framework

Микросервисы: Nimble Framework v.2

Nimble: Создание микросервиса

Nimble Framework для NET6 Готовится