Repository files navigation

Внимание! Пожалуйста, ознакомьтесь со всеми комментариями с надписью "ATTENTION!", потому что эти места потребуют от вас некоторых решений и/или действий.

Для установки шаблонов в среду разработки (Visual Studio,Rider,dotnet CLI) пожалуйста прочитайте статьюwiki, в которой описано, как очень просто установить шаблоны при помощи одной команды из командной строки на ваш рабочий компьютер.

• Calabonga.Microservice.IdentityModule.Template nuget-пакет для установки шаблона микросервиса в среду разработки (Visual Studio,Rider,dotnet CLI) с OpenIddict.
• Calabonga.Microservice.Module.Template nuget-пакет для установки шаблона микросервиса в среду разработки (Visual Studio,Rider,dotnet CLI) без OpenIddict.

• Насайте разработчика.
• Видео презентация новой версииNimble Framework v.6.

• New ASP.NET Core RazorPages template addedCalabonga.AspNetCoreRazorPages.Template

• Nugets dependencies were updated

• СборкаMediatR заменена на подобнуюMediator.Net в связи с тем, что"MediatR is going commercial". Mediator.NET реализует всё, что есть в MediatR, только при помощиSourceGenerator - что означает, что в принципе отсутстуетReflection, что, в свою очередь, существенно влияет на производительность в положительную сторону.
• Automapper удален.
• Исправлены синтакситеческие опечатки.
• Обновлены некоторые зависимости (nuget-пакеты).

• Обновились nuget-пакеты в проектеIdentityModule.
  • Microsoft.EntityFrameworkCore.Tools
  • Microsoft.EntityFrameworkCore.InMemory
  • OpenIddict.EntityFrameworkCore
  • Microsoft.EntityFrameworkCore
  • Microsoft.AspNetCore.Identity.EntityFrameworkCore*
  • FluentValidation
• Обновились nuget-пакеты в проектеModule.
  • Microsoft.EntityFrameworkCore
  • Microsoft.EntityFrameworkCore.InMemory
  • Microsoft.AspNetCore.Identity.EntityFrameworkCore
  • FluentValidation
  • FluentValidation.DependencyInjectionExtensions
  • MediatR
  • Microsoft.AspNetCore.Authentication.OpenIdConnect
  • Microsoft.AspNetCore.Authentication.JwtBearer
  • Microsoft.AspNetCore.Components.QuickGrid.EntityFrameworkAdapter
  • Microsoft.AspNetCore.OpenApi
  • Microsoft.EntityFrameworkCore.Tools

• Обновились nuget-пакеты в проектеIdentityModule.
  • Calabonga.UnitOfWork 6.0.0
  • Swashbuckle.AspNetCore.SwaggerUI 7.3.1
• Обновились nuget-пакеты в проектеModule.
  • Calabonga.UnitOfWork 6.0.0
  • Swashbuckle.AspNetCore.SwaggerUI 7.3.1
• При создании нового проекта из шаблона теперь название задается правильно

• Обновились nuget-пакеты в проектеIdentityModule.
• Обновились nuget-пакеты в проектеModule.

• Обновились nuget-пакеты в проектеIdentityModule.
  • OpenIddict.EntityFrameworkCore 6.0.0
  • OpenIddict.AspNetCore 6.0.0
• OpenIddict обновления для 6.0.0. Их много, но основное то, чтоLogout изменен наEndSession:

  - OpenIddictConstants.Permissions.Endpoints.Logout,+ OpenIddictConstants.Permissions.Endpoints.EndSession,

• Создана новая папка в репозиторииAuthClientSamples, в которую добавлен проектCalabonga.BlazorApp на базеBlazor Web App, как демонстрация исползованияCalabonga.Microservice.IdentityModule в качестве сервера авторизации Blazor-приложений. Больше информации и c картинками наWiki.

• ПодключенEnableLogoutEndpointPassthrough endpoint, а такжеSetIntrospectionEndpointUris.
• Подключена поддержкаPKCE дляAuthorization Code Flow.
• Обновились nuget-пакеты в проектеIdentityModule.
• Обновились nuget-пакеты в проектеModule.

• Обновилась версия платформы NET9.0, установлены nuget-пакеты, соответствующие версии.
• ПодключенMicrosoft.AspNetCore.OpenApi как основной генератор документации.
• Swashbuckle.AspNetCore nuget-пакет удален.
• Swashbuckle.AspNetCore.SwaggerUI nuget-пакет установлен для использования как UI для интерактивного использования OpenApi документации (openapi/v1.json).
• Настройки CORS обновлены
• Сборка CI/CD переведена на использование NET9,
• Из репозитория удалена папкаOutput, где хранились собранные сборки предыдущих версий.
• Из репозитория удален проект (папкаVSIX) с расширением дляVisual Studio, так поддерживать данный плагин нецелесообразно, в виду просты использования шаблонов для Visual Studio.
• Из репозитория удалена папкаIdentityServer4Mvc, где хранились формы MVC-проекта для IdentityServer4.
• Из репозитория удален проектBuilder (папка Builder), который позволял "вручную" собирать проекты шаблонов. Данный функционал больше не требуется.

• Обновились nuget-пакеты в проектеIdentityModule
• Обновились nuget-пакеты в проектеModule.

• Обновились nuget-пакеты в проектеIdentityModule
• Обновились nuget-пакеты в проектеModule.

• Обновились nuget-пакеты в проектеIdentityModule
• Обновились nuget-пакеты в проектеModule.

• Обновились nuget-пакеты в проектеIdentityModule
• Обновились nuget-пакеты в проектеModule.
• Исправлена ошибка генерации решения из шаблона: дублирование sln-файла. Спасибоandrew-moiseyev.
• Обновлены проекты nuget-templates для обоих tool CLI.

• Обновились nuget-пакеты
• Исправлены некоторые синтаксические ошибки.

Вместо nuget-пакетаOperationResultCoreв обоих шаблонах теперь используется более простая и современная реализация RFC7807 -Calabonga.Results, которая существенно "облегчила" сериализацию выдаваемых результатов повысив параметры производительности в несколько раз.

• СборкаOperationResultCore удалена из обоих шаблонов.
• СборкаCalabonga.Results установлена из обоих шаблонов.
• Обновились nuget-пакеты
• Удалены ненужные архивы старых версий на платформах ниже версии 8.x.
• Удалены артефакты, которые позволяли генерировать шаблоны без использования template-проектов.

Новая и первая версия шаблонов для микросервисов на платформе NET8.

• Произведен некоторый рефакторинг папок и, соответственно, namespace в шаблонах, чтобы соблюсти договоренности о именованиях.

• Обновлены nuget-пакеты

• IdentityModule: добавлена возможно авторизации и поBearer вдобавок кCookie.

• IdentityModule: добавленаPolicyCorsName иPolicyDefaultName

• IdentityModule иModule: обновлена реализацияEventItemEndpoints иProfilesEndpoints чтобы можно было использоватьEndpoint Explorer для генерации.http файлов для вызова методов прямо изVisual Studio:

  

• Подключена сборкаMicrosoft.AspNetCore.OpenApi для полноценной реализацииOpenApi. Удалены ненужные зависимости.

• Произведены другие мелкие правки, в том числе синтаксические.

• Из репозитория удалены исходные файлы для NET 5, а также готовые архивы для использования NET 5.

• Обновлены nuget-пакеты

• Небольшие правки по оптимизацииappSettings.json дляdevelop иproduction развертывания.

• Добавлена обязательная проверка возможных NullReferenceException в файл проекта для каждого из шаблонов.

  -    <PropertyGroup>-        <TargetFramework>net7.0</TargetFramework>-        <Nullable>enable</Nullable>-        <ImplicitUsings>enable</ImplicitUsings>-    </PropertyGroup>+    <PropertyGroup>+        <TargetFramework>net7.0</TargetFramework>+        <Nullable>enable</Nullable>+        <ImplicitUsings>enable</ImplicitUsings>+        <TreatWarningsAsErrors>true</TreatWarningsAsErrors>+        <WarningsAsErrors>enable</WarningsAsErrors>+    </PropertyGroup>

• Обновлена конфигурация.editor.config.

  +[*.json]++indent_size = 4+indent_style = space+tab_width = 4# C# files[*.cs]@@ -218,10 +223,15 @@ dotnet_naming_style.instance_field_style.required_prefix = _# ReSharper propertiesmax_line_length = 200+resharper_arguments_anonymous_function = named+resharper_blank_lines_after_multiline_statements = 1+resharper_blank_lines_before_control_transfer_statements = 1+resharper_csharp_keep_blank_lines_in_code = 1resharper_csharp_max_line_length = 200resharper_csharp_wrap_after_declaration_lpar = trueresharper_csharp_wrap_extends_list_style = chop_if_longresharper_csharp_wrap_lines = false+resharper_instance_members_qualify_declared_in = base_classresharper_max_attribute_length_for_same_line = 300resharper_place_type_constraints_on_same_line = trueresharper_wrap_before_arrow_with_expressions = true

• Сделан рефакторинг папок в проектах с целью добиться максимального соответствия концепции Clean Architecture, и в частности Vertical Slice Architecture. Выпущена
• Обновлены nuget-пакеты некоторых базовых сборок
• Исправлены мелкие недочеты (naming convention, syntax issies, etc.)

Созданы шаблоны дляdotnet CLI. Теперь можно установить шаблоны очень просто через командуdotnet. Например, чтобы установить шаблон дляMicroservice Identity Module достаточно выполнить команду:

dotnet new install Calabonga.Microservice.IdentityModule.Template

А для установкиMicroservice Module нужно такую команду:

dotnet new install Calabonga.Microservice.Module.Template

Проверить установлены ли шаблоны можно командой

dotnet new list

Команда выведет список всех установленных шаблонов:

Также после установки шаблонов, они станут доступы в Visual Studio и JetBrains Rider.

• Обновлены nuget-пакеты
• Немного изменена структура классов для наследников отIRequest иIRequestHandler. Теперь запросы с перехватчиками объединены в один класс, что на самом деле гораздо удобнее.
• Поправлены некоторые описания Summary

Пример использования шаблона для построения backend (API) для каталога товаров. В этом репозитории "пошаговая" реализация, которая записана на видео. Можно посмотреть примеры (examples of using) разных механизмов: Validation, Transactions, Notification and etc.

• Обновлены сборки (nuget) дляAutoMapper,FluentValidation,Microsoft.AspNetCore.Authentication,Serilog.
• Конфигурация дляSerilog вынесена вappSettings.json
• LoggerExtensions удалены, потому что подключено Structural logging на базеSerilog.
• Потому какStopTheHostException переименованHostAbortedException перехватывать его теперь стали по-новому.
• Перехват исключенийValidationException теперь работает черезOperationResult, для этого обновленValidatorBehavior.

• Обновлены сборки (nuget) для OpenIddict (OAuth2.0).
• Из шаблона удалена сборкаGitInfo, которая позволяла использовать версионирование на основе GIT, потому что при создании проекта вне папки репозитория появлялась ошибка:NETSDK1018 Invalid NuGet version string: '0.0.0+main.'.. Пожалуйста, ознакомьтесь со всеми комментариями с надписью "ATTENTION!", потому что эти места потребует от вас некоторых решений или действий. Например, использовать или не использовать версионирование на основе GIT возможностей.
• Исправлена работаFluentValidation дляEventItemValidator.
• Исправлена работаErrorHandlerMiddleware для отображения ошибок валидации.

Версия получила следующие изменения:

• Новая версияMediatr получила обновление, в том числе была удалена зависимость от nuget-пакетаMediatR.Extensions.Microsoft.DependencyInjection. А также изменилась регистрация зависимости.

- services.AddMediatR(Assembly.GetExecutingAssembly());+ services.AddMediatR(cfg => cfg.RegisterServicesFromAssemblyContaining<Program>());

• Обновились сборкиEntityFramework.
• Обновилась версия для расширение для Visual Studio (VSIX).

• Обновлены почти все nuget-пакеты, в том числе и один из самых важныхOpenIddict:

- <PackageReference Include="OpenIddict.AspNetCore" Version="3.1.1" />+ <PackageReference Include="OpenIddict.AspNetCore" Version="4.0.0" />

• Исправлено несколько синтаксических ошибок
• Обновлены методы вIAccountService. За счет этого существенно сокращено количество повторяющихся запрос в базу данных за информацией о пользователе.

Шаблоны для создания проектов для микросервисной архитектуры успешно мигрировали на 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 моего репозитория.

• Обновлены nuget-пакеты, которые использованы в шаблонах (EntityFramework, FluentValidation).
• Удалены старые проекты.
• Обновлены собранные архивы для Visual Studio в папке OUTPUT.

На платформеNET6 (В папке AspNetCore v6.1) можно найти новую версиюNimble Framework, который предназначен для быстрого создания микросервисной архитектуры.Nimble Framework содержитIdentityModule (AuthServer) и Module (microservice). Новая версия доступна для скачивания.

• Удален IdentityServer4 как основа для аутентификации и авторизации на базе OAuth2.0. Теперь Nimble Framework использует для шаблона с сервером авторизации OpenIddict, который также реализует спецификации OAuth2.0.
• Обновлен механизм авторизации на странице swagger. Теперь используется Authorization Code Flow, который реализует форму входа. Это позволит использовать шаблон "из коробки".
• Обновлен механизм авторизации для второстепенных сервисов (механизм передачи ролей в токен)
• Обновлены почти все сборки (переведены на NET6), которые использованы в шаблонах
• Реализована система Definitions

1. Обновлены nuget-пакеты Automapper и Mediatr
2. Обновились сборки для ASP.NET Core, EntityFrameworkCore
3. Добавлена информация к шаблону о его времени сборке и прочая информация про Copyright
4. Обновлен "сборщик" шаблонов, который позволяет быстро обновлять solutions

В статье блога иВидео презентация

РеализацияOpenIddict в шаблонах завершена, теперь формируются шаблоны дляVisual Studio.

Начались работы по переходу от IdentityServer4 на OpenIddict как основной сервис авторизации OAuth2.0. Причина переезда - скорое окончание срока поддержки IdentityServer4 и перехода его на платную основу.

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

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.

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

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

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

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

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

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

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

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

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

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).

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

Шаблон (template) для Visual Studio для построения инфраструктуры микросервисов на базе 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

Установка Nimble Templates

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

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

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

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

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

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

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

Про NimbleFramework можно найти следующие видео ролики. Они разделятся по версиям, но для всеобщего понимания настоятельно рекомендуется

Nimble Framework v6.1

Nimble Framework v6.0

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

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

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

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

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

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

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

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

Посмотреть marketplace

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

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

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

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

Благодарности помощь каналу принимаются (Support This Project):

• https://www.calabonga.net/site/thanks

Пишите комментарии к видео на сайтеwww.calabonga.net

Сергей Калабонга (Calabonga)

• Блог по программированию
• Видео канал Boosty.to/Calabonga