Справочная информация по фреймворку есть в Wiki и на сайте разработчика. Видео презентация новой версии Nimble Framework v.6.
Шаблоны для создания проектов для микросервисной архитектуры успешно мигрировали на NET7. Обновились сборки всех необходимых nuget-пакетов, а также сами проекты теперь строятся на NET7. Не забудьте обновить CI/CD если будете публиковать новые версии для NET7.
Новые версии шаблонов теперь работают совместно. То есть теперь созданное приложение из шаблона Calabonga.Microservice.Module
может авторизоваться у приложения, которое создано из шаблона Calabonga.Microservice.IdentityModule
прямо после создания приложений из шаблонов.
В связи с тем, что обновления были в разных модулях в прошлый раз, шаблоны на данный момент имеют разные версии (В будущем это расхождение будет невелировано):
- Calabonga.Microservice.IdentityModule имеет версию
6.1.4
- Calabonga.Microservice.Module имеет версию
6.1.2
- Обновлены сборки (nuget-пакеты)
- Удалены шаблоны, которые использовали IdentityServer4 в качестве сервера авторизации.
- Добавлена сборка Calabonga.AspNetCore.AppDefinitions, которая подключает возможность использования AppDefinitions в проектах на платформе ASP.NET Core.
В новой версии 6.1.3
обновился метод авторизации по Authorization Code Flow
. Подключены механизмы, которые приведены в пример на сайте OpenIddict Samples. Теперь авторизация учитывает Consent
, а также подключены более жесткие требования к формированию id_token
и access_token
, которые рекомендованы стандартами OAuth2.0
.
В новой версии 6.1.2
добавлены некоторые инициализации для того, чтобы было проще подключить EntityFramework
провайдер для Microsoft SQL Server
(UseSqlClient). Добавленные строки кода были закоментированы, чтобы можно было оставить функциональность для IN-MEMORY режима.
В новой версии 6.1.1
удалены проекты из папки FullAPI (вместе с папкой). Версия с IdentityServer
больше не будет получать обновления, но пока останется доступной. Вы можете ее найти в папке MinimalAPI-IS4. Если вам еще нужны эти проекты, настоятельно рекомендую сделать fork моего репозитория.
На платформе NET6
(В папке AspNetCore v6.1) можно найти новую версию Nimble Framework
, который предназначен для быстрого создания микросервисной архитектуры. Nimble Framework
содержит IdentityModule
(AuthServer) и Module (microservice). Новая версия доступна для скачивания.
В статье блога и Видео презентация
Реализация OpenIddict
в шаблонах завершена, теперь формируются шаблоны для Visual Studio
.
Начались работы по переходу от IdentityServer4 на OpenIddict как основной сервис авторизации OAuth2.0. Причина переезда - скорое окончание срока поддержки IdentityServer4 и перехода его на платную основу.
На платформе NET6 (В папке AspNetCore v6.0
) теперь существует два вида шаблонов микросервисов (FullAPI и MinimalAPI), каждый из которых содержит IdentityModel и простой Module. Папка FullAPI содержит уже знакомые шаблоны микросервисов, просто они теперь переведены на NET6. А в папке MinimalAPI новая версия тех же шаблонов, которые построены на базе MinimalAPI.
- Удалены старые шаблоны для версий NET Core 2.2 и NET Core 3.0.
- Началась разработка шаблонов для новой версии.
v6.1.1 от 2022-07-04
- Обновлены nuget-пакеты, которые использованы в шаблонах (EntityFramework, FluentValidation).
- Удалены старые проекты.
- Обновлены собранные архивы для Visual Studio в папке OUTPUT.
v6.1.0 от 2022-05-14
- Удален IdentityServer4 как основа для аутентификации и авторизации на базе OAuth2.0. Теперь Nimble Framework использует для шаблона с сервером авторизации OpenIddict, который также реализует спецификации OAuth2.0.
- Обновлен механизм авторизации на странице swagger. Теперь используется Authorization Code Flow, который реализует форму входа. Это позволит использовать шаблон "из коробки".
- Обновлен механизм авторизации для второстепенных сервисов (механизм передачи ролей в токен)
- Обновлены почти все сборки (переведены на NET6), которые использованы в шаблонах
- Реализована система Definitions
v6.0.1 от 2022-01-16
- Обновлены nuget-пакеты Automapper и Mediatr
- Обновились сборки для ASP.NET Core, EntityFrameworkCore
- Добавлена информация к шаблону о его времени сборке и прочая информация про Copyright
- Обновлен "сборщик" шаблонов, который позволяет быстро обновлять solutions
v6.0.0 от 2021-11-12
- Шаблоны микросервисов переведены на новую версию NET6. Обновлены почти все файлы, использованы новые "фишки", которые появились в C#.
- Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). Теперь используются версии NET6.
- Удалены дубликаты контроллеров, которые демонстрировали использовать подхода Readonly/Writable (Calabonga.UnitOfWork.Controllers). Теперь остался только один пример, построенный на базе Mediatr.
- Обновлена инфраструктура папок. Использована Vertical Slice Architecture, которую представил Jimmy Bogard.
- Обновилось расширение VSIX-расширения для Visual Studio.
v5.0.8 от 2021-10-31
- Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). А также nuget-пакет FluentValidation и другие.
- Конструкции некоторых методов переведин на lambda-выражения, чтобы следовать моде.
- Обновилось расширение VSIX-расширения для Visual Studio.
v5.0.7 от 2021-09-06
- Обновились сборки для ASP.NET Core, EntityFrameworkCore и Swagger (OpenAPI). А также nuget-пакеты Calabonga.Microservices.Core, FluentValidation и другие.
- Добавлено несколько комментариев в код для обеспечения определенности в действиях
- Обновилось расширение VSIX-расширения для Visual Studio.
v5.0.6 от 2021-09-08
- Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core, Swagger, FluentValidation и другие.
- Обновились метаданные, используемые для VSIX-расширения для Visual Studio.
v5.0.5 от 2021-06-04:
- Исправлено несколько опечаток.
- Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core, Swagger, FluentValidation и другие.
v5.0.4 от 2021-03-23:
- Стандартный logger заменен на Serilog. Теперь читать логи стало проще.
- Исправлено несколько опечаток.
- Обновились сборки для ASP.NET Core и EntityFrameworkCore. А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core и другие.
- Реализация Mediatr-запросов (Request) из классов превратились в записи (class -> record) С#.
v5.0.3 от 2021-03-16:
- Удалена зависимость от некоторых сборок, которые вынесены на более высокий уровень. Это позволит обновлять их отдельно.
- Исправлено несколько опечаток.
- Обновились сборки для ASP.NET Core и EntityFrameworkCore до версий (5.0.4). А также nuget-пакеты OperationResultCore, Calabonga.Microservices.Core и другие.
- Реализация Mediatr-запросов из контроллеров перенесены в проекты шаблонов из сборки Calabonga.AspNetCore.Controllers, чтобы примеры использования были доступны разработчику.
v5.0.2 от 2021-01-27:
- Применены языковые фишки из C# 9.0. Другими словами, был неслабый рефакторинг кода для оптимизации.
- Исправлено несколько опечаток.
- Обновились сборки для
ASP.NET Core
иEntityFramework Core
до версий (5.0.2). А также nuget-пакетыOperationResultCore
,Calabonga.Microservices.Core
и другие.
v5.0.1 от 2020-12-04:
- В шаблоне микросервиса с IdentityServer4 и шаблоне без него удалены проекты xxx.Core. Файлы из этих проектов перенесены в проект xxx.Entities. Ссылки на Exceptions вынесены в nuget-пакет
Calabonga.Microservices.Core
. - В шаблоне микросервиса с IdentityServer4 добавлена возможность аутентификации как для Cookie типа, так и для Bearer. Да! Теперь настроено два типа аутентификации.
- Применены языковые фишки из C# 8.0. Другими словами, был неслабый рефакторинг кода для оптимизации.
- Исправлено множество опечаток.
v5.0.0 от 2020-11-15:
- Все проекты во всех решениях (solutions) обновились до версии .NET 5.0.
- Обновились nuget-сборки для
ASP.NET Core
иEntityFramework Core
(5.0.0). - Добавилась реализация логирования, как пример использования, который описан на видео ILogger в ASP.NET Core
- На страницу API (
Swagger
) выведена информация о названии ветки (branch) и номер публикации (commit).
Документация доступна на GitHub в разделе Wiki (в режиме наполнения).
Шаблон (template) для Visual Studio для построения инфраструктуры микросервисов на базе ASP.NET Core.
Visual Studio project template for microservice module base on ASP.NET Core
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
Calabonga.AspNetCore.Controllers nuget-пакет на базе Mediatr
Calabonga.UnitOfWork.Controllers nuget-пакет на base Readonly/Writable controllers
Микросервисы: Шаблон для микросервиса
Микросервисы: Управление доступом
Микросервисы: Обмен данными между микросервисами
Микросервисы: Прокси для frontend
Часть 0. Nimble: Установка шаблонов для микросервисов
Часть 1. Nimble: Демонстрация шаблона микросервиса на примере
Часть 2. Nimble: Установка шаблонов для микросервисов
Часть 3. Nimble: Основные и базовые понятия
Часть 4. Nimble: Создаем свой Query и Handler для IMediator
Микросервисы 2 (плей-лист)
Микросервисы (плей-лист)
Теперь шаблоны для генерации микросервисов доступны также и в Visual Studio Marketplace
Также можно установить прямо из Visual Studio
Микросервисы: Nimble Framework v.2
Nimble Framework для NET6 Готовится
Благодарности помощь каналу принимаются (Support This Project):
Пишите комментарии к видео на сайте www.calabonga.net
Сергей Калабонга (Calabonga)