eShop: запилить модульный монолит. Часть 1. .NET.. .NET. dotnet.. .NET. dotnet. hosting startup.. .NET. dotnet. hosting startup. modular monolith.. .NET. dotnet. hosting startup. modular monolith. Анализ и проектирование систем.. .NET. dotnet. hosting startup. modular monolith. Анализ и проектирование систем. Микросервисы.. .NET. dotnet. hosting startup. modular monolith. Анализ и проектирование систем. Микросервисы. Проектирование и рефакторинг.

После того как я сделал доклад на DotNext, я решил получившиеся анализаторы завернуть в отдельную библиотеку. Для конвертации микросервисного приложения сделал скилл для Claude. Натравил скилл на eShop, и за три часа он свернул все микросервисы в модули.

Я посмотрел внимательно что делал ИИ и понял, что много действий по конвертации легко автоматизируются и только небольшая часть изменений требует вмешательства человека. Поэтому я создал набор инструментов, которые помогают мигрировать микросервисную архитектуру в модульный монолит.

Статья получилась из двух частей. В первой, этой, все сервисы переезжают в один процесс и перестают ходить друг к другу по сети. Во второй свернем четыре DbContext в один, перенесем данные в одну базу и уберем шину событий и MediatR.

Это пятая статья серии:

  1. Модульность без микросервисов: почему она того стоит.

  2. Модульный монолит в ASP.NET из коробки.

  3. Модульная модель данных в EF Core.

  4. Как ломается модульный монолит и как с этим бороться.

  5. eShop: запилить микросервисы в модульный монолит. Часть 1: один процесс (вы здесь).

  6. eShop: запилить микросервисы в модульный монолит. Часть 2: одна база, без шины и MediatR.

Исходное приложение – dotnet/eShop, результат – gandjustas/eShopModules. Каждый шаг статьи – один коммит, хеши указаны в тексте. Коммиты лежат поверх свежего main исходного репозитория, это .NET 11.

TL;DR

  • Первая часть миграции заняла семь коммитов. После каждого приложение собирается и проходит тесты.

  • Было 9 процессов и 4 контейнера, стало 2 процесса и 3 контейнера. Рабочий набор в простое упал с 1627 до 613 МБ, потоков стало 120 вместо 443. CPU и время e2e при этом не улучшились.

  • Перенос Program.cs в модуль делает исправление анализатора MOD0015. dotnet modules compare после этого нашел одну регистрацию, которая поменяла победителя.

  • dotnet modules topology по инвентарю сервисов говорит, что столкнется в общем процессе, до того как его кто-то собрал.

  • Топологические тесты замораживают маршруты, подписки, фоновые службы, регистрации и таблицы каждого сервиса. При переезде правится одна строка на сервис.

  • 204 типа стали internal одной командой dotnet format. Руками пришлось разбираться с аутентификацией, cookie, шиной событий и Identity.

Что такое eShop

Архитектура eShop

Архитектура eShop

Семь сервисов: Identity, Basket, Catalog, Ordering, Webhooks, OrderProcessor и PaymentProcessor. Витрина на Blazor (WebApp), клиент вебхуков, мобильное приложение на MAUI и BFF на YARP перед ним. Postgres с четырьмя базами, Redis, RabbitMQ. Запускает все это Aspire AppHost:

var identityApi = builder.AddDotnetProject("identity-api", "../Identity.API", o => o.LaunchProfileName = launchProfileName)
    .WithExternalHttpEndpoints()
    .WithReference(identityDb);

var identityEndpoint = identityApi.GetEndpoint(launchProfileName);

var basketApi = builder.AddDotnetProject("basket-api", "../Basket.API")
    .WithReference(redis)
    .WithReference(rabbitMq).WaitFor(rabbitMq)
    .WithEnvironment("Identity__Url", identityEndpoint);

var catalogApi = builder.AddDotnetProject("catalog-api", "../Catalog.API")
    .WithReference(rabbitMq).WaitFor(rabbitMq)
    .WithReference(catalogDb);

// ... ordering-api, order-processor, payment-processor, webhooks-api

builder.AddYarp("mobile-bff")
    .WithExternalHttpEndpoints()
    .ConfigureMobileBffRoutes(catalogApi, orderingApi, identityApi);

var webApp = builder.AddDotnetProject("webapp", "../WebApp", o => o.LaunchProfileName = launchProfileName)
    .WithExternalHttpEndpoints()
    .WithReference(basketApi)
    .WithReference(catalogApi)
    .WithReference(orderingApi)
    .WithReference(rabbitMq).WaitFor(rabbitMq)
    .WaitFor(identityApi)
    .WithEnvironment("IdentityUrl", identityEndpoint);

Как работает аутентификация

Про нее надо рассказать заранее, потому что половина проблем при слиянии будет отсюда. У витрины схема по умолчанию cookie, у сервисов – JwtBearer, у Identity своя cookie от ASP.NET Identity. Пока это три процесса, у каждого своя «схема по умолчанию».

Identity.API это Duende IdentityServer поверх ASP.NET Identity. Он знает клиентов и области:

new ApiScope("orders", "Orders Service"),
new ApiScope("basket", "Basket Service"),
new ApiScope("webhooks", "Webhooks registration Service"),

new Client
{
    ClientId = "webapp",
    AllowedGrantTypes = GrantTypes.Code,
    RedirectUris = { $"{configuration["WebAppClient"]}/signin-oidc" },
    AllowedScopes = { "openid", "profile", "orders", "basket", "webshoppingagg", "webhooks" },
},

Витрина отправляет пользователя на Identity по OpenID Connect, получает токены и складывает их в свою cookie:

services.AddAuthentication(options =>
{
    options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie(options => options.ExpireTimeSpan = TimeSpan.FromMinutes(sessionCookieLifetime))
.AddOpenIdConnect(options =>
{
    options.SignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
    options.Authority = identityUrl;
    options.ClientId = "webapp";
    options.ResponseType = "code";
    options.SaveTokens = true;
    options.Scope.Add("orders");
    options.Scope.Add("basket");
});

Когда витрина идет в сервис, она достает токен из cookie и кладет в заголовок:

builder.Services.AddGrpcClient<Basket.BasketClient>(o => o.Address = new("http://basket-api"))
    .AddAuthToken();

// внутри AddAuthToken
var accessToken = await context.GetTokenAsync("access_token");
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", accessToken);

А сервис проверяет токен, спрашивая ключи у того же Identity:

services.AddAuthentication().AddJwtBearer(options =>
{
    options.Authority = identityUrl;
    options.Audience = audience;
    options.TokenValidationParameters.ValidIssuers = [identityUrl, "https://10.0.2.2:5243"];
});

Сколько это стоит

Прежде чем что-то менять, я написал (прим.: тут мем с конем) скрипт замера (6aba5c0). Он стартует AppHost, гоняет Playwright e2e из репозитория и снимает CPU, память и потоки процессов, счетчики рантайма через dotnet-counters и docker stats.

Пока я писал статью, исходный eShop переехал на .NET 11. Все цифры в статье получены на .NET 11.

Services - totals (6aba5c0, медиана трех запусков)

processCount   9
idleWsMb       1627.1
wsPeakMb       2085.4
threadsAvg     443
gcHeapPeakMb   651.9

Containers: eventbus 125.8 MB, mobile-bff 53.5 MB, postgres 31.8 MB, redis 5.4 MB

OrderProcessor занимает 109 МБ и за весь прогон тратит чуть больше секунды CPU.

Шаг 1. Сервисы становятся модулями

Сначала снимаем состояние «до», оно понадобится на следующем шаге:

dotnet tool install FusionModules.Tool

Эти инструменты дополняют библиотеку и помогают при миграции.

dotnet modules inventory eShop.slnx -o inventory-before.json

Инструмент находит AppHost, собирает каждый хост и запускает его под пробой, без инфраструктуры. В JSON попадает то, что хост реально собрал: эндпоинты, регистрации в DI, фоновые службы, DbContext’ы, конфигурация. Файл получается большой даже для учебного проекта и строится 19 секунд на моем компьютере. Глазами его смотреть необязательно, с ним работают инструменты.

Теперь добавляем пакет в Directory.Build.props:

<PackageVersion Include="FusionModules" Version="0.4.0" />

И ссылку в каждый сервис:

<PackageReference Include="FusionModules" />

В Program.cs появляется подсказка:

MOD0015: 1 statement(s) of this program register or map the project's own code and can move into a module in the same project

Исправление можно сделать из Visual Studio (Code)

eShop: запилить модульный монолит. Часть 1 - 2

Или из командной строки

dotnet format analyzers eShop.slnx --diagnostics MOD0015

Исправление создает Module.cs в том же проекте и переносит туда регистрации и эндпоинты, которые называют код самого проекта. Вызовы фреймворка и общих библиотек остаются на месте. Вот PaymentProcessor, самый простой сервис. Анализатор насчитал в нем одно выражение, AddOptions<PaymentOptions>. Подписку на событие он не тронул, потому что AddRabbitMqEventBus пришел из общей библиотеки, и ее я перенес в модуль руками. Было:

var builder = WebApplication.CreateBuilder(args);

builder.AddServiceDefaults();

builder.AddRabbitMqEventBus("EventBus")
    .AddSubscription<OrderStatusChangedToStockConfirmedIntegrationEvent, OrderStatusChangedToStockConfirmedIntegrationEventHandler>();

builder.Services.AddOptions<PaymentOptions>()
    .BindConfiguration(nameof(PaymentOptions));

var app = builder.Build();

app.MapDefaultEndpoints();

await app.RunAsync();

Стало:

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.AddServiceDefaults();

var app = builder.Build();

app.MapDefaultEndpoints();

await app.RunAsync();

А всё свое сервис теперь приносит в классе модуля:

// Module.cs
[assembly: HostingStartup(typeof(PaymentProcessor.Module))]

namespace PaymentProcessor;

internal sealed class Module : ModuleBase
{
    protected override void ConfigureServices(IHostApplicationBuilder builder)
    {
        builder.AddRabbitMqEventBus("EventBus")
            .AddSubscription<OrderStatusChangedToStockConfirmedIntegrationEvent, OrderStatusChangedToStockConfirmedIntegrationEventHandler>();
        builder.Services.AddOptions<PaymentOptions>()
            .BindConfiguration(nameof(PaymentOptions));
    }
}

Подписка и настройки оплаты уехали. AddServiceDefaults и MapDefaultEndpoints остались: телеметрия и /health нужны процессу, а не оплате.

В Webhooks.API анализатор насчитал два выражения, оба про маршруты. Исправление перенесло их в Configure модуля и добавило UseModuleRouting в Program.cs. Внутрь AddApplicationServices оно не заглядывает, поэтому регистрации из этого метода я разобрал руками. Было:

var builder = WebApplication.CreateBuilder(args);

builder.AddServiceDefaults();
builder.AddApplicationServices();   // аутентификация, шина, DbContext, сервисы

var withApiVersioning = builder.Services.AddApiVersioning(options =>
{
    options.ReportApiVersions = true;
});

builder.AddDefaultOpenApi(withApiVersioning);

var app = builder.Build();

app.MapDefaultEndpoints();

var webHooks = app.NewVersionedApi("Web Hooks");

webHooks.MapWebHooksApiV1()
        .RequireAuthorization();

app.UseDefaultOpenApi();
app.Run();

Стало:

// Program.cs
var builder = WebApplication.CreateBuilder(args);

builder.AddServiceDefaults();
builder.AddDefaultAuthentication();   // вынесено из AddApplicationServices

var withApiVersioning = builder.Services.AddApiVersioning(options =>
{
    options.ReportApiVersions = true;
});

builder.AddDefaultOpenApi(withApiVersioning);

var app = builder.Build();
app.UseModuleRouting();               // добавлено
app.MapDefaultEndpoints();
app.UseDefaultOpenApi();

app.Run();

UseModuleRouting нужен чтобы зарегистрировать минимальный набор Middleware: routing, antiforgery, аутентификацию и авторизацию. Если этого не сделать то мэпинг эндпоинтов может падать. Если Middleware уже добавляются в хост, то UseModuleRouting не нужен.

Модуль регистрирует свои сервисы в ConfigureServices и мапит свои эндпоинты в Configure:

// Module.cs
internal sealed class Module : ModuleBase
{
    protected override void ConfigureServices(IHostApplicationBuilder builder)
    {
        builder.AddRabbitMqEventBus("eventbus")
               .AddSubscription<ProductPriceChangedIntegrationEvent, ProductPriceChangedIntegrationEventHandler>()
               .AddSubscription<OrderStatusChangedToShippedIntegrationEvent, OrderStatusChangedToShippedIntegrationEventHandler>()
               .AddSubscription<OrderStatusChangedToPaidIntegrationEvent, OrderStatusChangedToPaidIntegrationEventHandler>();

        builder.AddNpgsqlDbContext<WebhooksContext>("webhooksdb");
        builder.Services.AddMigration<WebhooksContext>();

        builder.Services.AddTransient<IGrantUrlTesterService, GrantUrlTesterService>();
        builder.Services.AddTransient<IWebhooksRetriever, WebhooksRetriever>();
        builder.Services.AddTransient<IWebhooksSender, WebhooksSender>();
    }

    protected override void Configure(IApplicationBuilder app)
    {
        app.UseEndpoints(endpoints =>
        {
            var webHooks = endpoints.NewVersionedApi("Web Hooks");

            webHooks.MapWebHooksApiV1()
                    .RequireAuthorization();
        });
    }
}

База, подписки и эндпоинты вебхуков в модуле. Аутентификация, версии API и OpenAPI в Program.cs. Так сделаны все семь сервисов. Каждый по-прежнему запускается своим процессом: сборка приложения сама себе hosting startup, HOSTINGSTARTUPASSEMBLIES пока не нужна.

И пока модуль живет в собственном хосте, проверки видимости типов к нему не применяются. Для анализатора проект с точкой входа это хост, а хосту публичные типы не запрещены. public class BasketService никого не беспокоит, до шага 7.

Коммит 01f1e16.

Шаг 2. Проверяем что ничего не изменилось

Код переехал из одного файла в другой. Сервисы должны собирать ровно то же самое. Снимаем инвентарь еще раз и сравниваем:

dotnet modules inventory eShop.slnx -o inventory-microservices-modules.json
dotnet modules compare inventory-before.json inventory-microservices-modules.json
basket-api: the same
  note: + module Basket.API.Module

catalog-api: the same
  note: + module Catalog.API.Module

identity-api: 3 differences
  - registration Transient Duende.IdentityServer.Services.IProfileService -> Duende.IdentityServer.Services.DefaultProfileService (Duende.IdentityServer)
  + winner Duende.IdentityServer.Services.IProfileService -> Duende.IdentityServer.AspNetIdentity.ProfileService<eShop.Identity.API.Models.ApplicationUser> (Duende.IdentityServer.AspNetIdentity)
  - winner Duende.IdentityServer.Services.IProfileService -> eShop.Identity.API.Services.ProfileService (Identity.API)
  note: + module Identity.API.Module

order-processor: the same
ordering-api: the same
payment-processor: the same
webapp: the same

webhooks-api: 2 differences
  - framework registrations Microsoft.Extensions.Options: 111
  + framework registrations Microsoft.Extensions.Options: 112

webhooksclient: the same

9 hosts compared: 7 the same, 2 different.

Семь сервисов собирают то же, что раньше. У Webhooks одна лишняя регистрация опций, это не страшно. А вот Identity интересный. Было:

builder.Services.AddIdentityServer(options => { ... })
    .AddInMemoryClients(Config.GetClients(builder.Configuration))
    .AddAspNetIdentity<ApplicationUser>()
    .AddDeveloperSigningCredential();

builder.Services.AddTransient<IProfileService, ProfileService>();
builder.Services.AddTransient<ILoginService<ApplicationUser>, EFLoginService>();
builder.Services.AddTransient<IRedirectService, RedirectService>();

Стало, после переноса в модуль:

builder.Services.AddTransient<ILoginService<ApplicationUser>, EFLoginService>();
builder.Services.AddTransient<IRedirectService, RedirectService>();
builder.Services.AddTransient<IProfileService, ProfileService>();

builder.Services.AddIdentityServer(options => { ... })
    .AddInMemoryClients(Config.GetClients(builder.Configuration))
    .AddAspNetIdentity<ApplicationUser>()
    .AddDeveloperSigningCredential();

Три строки поднялись выше AddIdentityServer. AddAspNetIdentity тоже регистрирует IProfileService, а в контейнере побеждает последний. Профиль пользователя в токене теперь собирает класс Duende, а не eShop. Сборка зеленая, сервис стартует, вход работает. Клеймы в токене другие.

На ревью я бы эту перестановку не заметил. Исправление простое, регистрация возвращается под AddAspNetIdentity:

    .AddAspNetIdentity<ApplicationUser>()
    .AddDeveloperSigningCredential();

// После AddAspNetIdentity: он регистрирует свой IProfileService, а побеждает последняя регистрация
builder.Services.AddTransient<IProfileService, ProfileService>();

В истории это изменение попало лежит в коммите шага 5, вместе с остальными правками Identity.

Топологические тесты

Инвентарь это разовая проверка. Чтобы она жила в репозитории и шла на каждом коммите, то же самое замораживаем в тестах. Ожидания сняты один раз с работающих сервисов:

// Baseline.cs. Файл не правится при переезде: после него модуль обязан отдавать то же самое
["Basket.API"] = new(
    Routes:
    [
        "POST /BasketApi.Basket/DeleteBasket",
        "POST /BasketApi.Basket/GetBasket",
        "POST /BasketApi.Basket/UpdateBasket",
    ],
    Events: ["OrderStartedIntegrationEvent"],
    Hosted: ["factory x1"],
    Services:
    [
        "Singleton eShop.Basket.API.Repositories.IBasketRepository -> eShop.Basket.API.Repositories.RedisBasketRepository",
        "Transient [...OrderStartedIntegrationEvent] eShop.EventBus.Abstractions.IIntegrationEventHandler -> ...OrderStartedIntegrationEventHandler",
    ],
    Tables: []),

Второй файл говорит, какой хост поднимать и с какими модулями. Пока каждый сервис сам себе хост, список модулей пуст:

// Topologies.cs. Единственный файл, который правится при переезде
public sealed record Topology(string Name, Type Program, string[] Modules, string RoutePrefix = "");

public static readonly Topology[] Current =
[
    new("Basket.API", typeof(basket::Program), []),
    new("Catalog.API", typeof(catalog::Program), []),
    new("Identity.API", typeof(identity::Program), []),
    new("Ordering.API", typeof(ordering::Program), []),
    new("OrderProcessor", typeof(orderprocessor::Program), []),
    new("PaymentProcessor", typeof(payment::Program), []),
    new("WebApp", typeof(webapp::Program), []),
    new("WebhookClient", typeof(webhookclient::Program), []),
    new("Webhooks.API", typeof(webhooks::Program), []),
];

Тест поднимает хост топологии и сравнивает то, что он отдает, с замороженным:

[Theory]
[MemberData(nameof(Names))]
public async Task Serves_the_routes_of_the_service(string name)
{
    var topology = Find(name);
    await using var host = TopologyHost.Start(topology);

    Check(
        topology,
        Baseline.Services[name].Routes.Select(route => Prefixed(route, topology.RoutePrefix)),
        TopologyProbe.Routes(host));
}

// и такие же Subscribes_to_the_events, Runs_the_background_services,
// Registers_the_services, Owns_the_tables

static void Check(Topology topology, IEnumerable<string> expected, string[] actual)
{
    // сервис сам себе хост: отдает ровно то, что в ожиданиях
    if (topology.Modules.Length == 0)
    {
        Assert.Equal(Sorted(expected), actual);
        return;
    }

    // модуль в чужом хосте: все что отдавал раньше обязано остаться, лишнее принес хост
    var lost = Sorted(expected).Where(line => !Contains(actual, line)).ToArray();
    Assert.True(lost.Length == 0, "Сервис перестал отдавать:" + Environment.NewLine + string.Join(Environment.NewLine, lost));
}

Хост поднимается без Docker и базы:

public sealed class TopologyFactory<TProgram>(string[] modules)
    : ModularWebApplicationFactory<TProgram>(modules), ITopologyHost
    where TProgram : class
{
    const string Postgres = "Host=127.0.0.1;Port=1;Database=unused;Username=unused;Password=unused";

    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        builder
            .UseConnectionStrings(("redis", Redis), ("eventbus", RabbitMq), ("catalogdb", Postgres), /* ... */)
            .UseEnvironment("Production")
            // сначала запомнить регистрации, потом убрать фоновые службы
            .ConfigureTestServices(services => descriptors = [.. services])
            .WithoutApplicationHostedServices();
        base.ConfigureWebHost(builder);
    }
}

46 тестов, несколько секунд. Зато теперь поломка топологии ломает тест. Коммит 8f25a0b.

Шаг 3. Что столкнется в одном процессе

Тот же инвентарь умеет отвечать на вопрос «а что если сложить все это в один хост»:

dotnet modules topology inventory-before.json
Fails startup: modules register one service differently (1):
  eShop.IntegrationEventLogEF.Services.IIntegrationEventLogService
    catalog-api: IntegrationEventLogService<CatalogContext>
    ordering-api: IntegrationEventLogService<OrderingContext>
  What to do: Keep one implementation, or register a keyed service or one contract per module.

Logged at startup: one route in two services (1):
  /
    catalog-api: GET / (eShop.ServiceDefaults.Extensions.<UseDefaultOpenApi>b__1)
    ordering-api: GET / (eShop.ServiceDefaults.Extensions.<UseDefaultOpenApi>b__1)
    webhooks-api: GET / (eShop.ServiceDefaults.Extensions.<UseDefaultOpenApi>b__1)
    webhooksclient: GET,POST / (eShop.WebhookClient.Components.Pages.Home.Home)
    webapp: GET,POST / (eShop.WebApp.Components.Pages.Catalog.Catalog)
  What to do: A request it matches gets a 500 (AmbiguousMatchException): move one under a prefix...

One shared handler in several services (12):
  /alive
    identity-api, basket-api, catalog-api, ordering-api, order-processor, ...
  /health
    identity-api, basket-api, catalog-api, ordering-api, order-processor, ...
  /openapi/{}.json
    catalog-api, ordering-api, webhooks-api
  /scalar/{?}
    catalog-api, ordering-api, webhooks-api
  ...
  What to do: Map it once, in the host, and remove it from the modules.

One configuration key, two values (8):
  EventBus:SubscriptionClientName (appsettings.json)
    basket-api: Basket
    catalog-api: Catalog
    ordering-api: Ordering
    order-processor: OrderProcessor
    payment-processor: PaymentProcessor
    webhooks-api: Webhooks
    webapp: Ordering.webapp
  Identity:Audience (appsettings.json)
    basket-api: basket
    ordering-api: orders
    webhooks-api: webhooks
  OpenApi:Document:Title (appsettings.json)
    catalog-api: eShop - Catalog HTTP API
    ordering-api: eShop - Ordering HTTP API
    webhooks-api: eShop - Webhooks HTTP API
  ...

1 service collision that fails startup, 1 route in two services,
12 shared routes to map once, 8 configuration keys with two values.

Это список работ на следующий шаг. С --pairs видно с кого начинать:

basket-api + identity-api: 2 shared routes to map once
basket-api + order-processor: 2 shared routes to map once, 1 configuration key with two values
catalog-api + ordering-api: 1 service collision that fails startup, 8 shared routes to map once, 4 configuration keys with two values
catalog-api + webapp: 1 route in two services, 2 shared routes to map once, 1 configuration key with two values
...

Чего здесь нет: поведения в рантайме. Схем аутентификации, cookie, порядка middleware, кода который ищет что-то в сборке точки входа.

Шаг 4. Шесть сервисов переезжают в WebApp

Хостом я сделал витрину (WebApp). Она на Blazor и её сложно сделать модулем. В ее проект добавляются ссылки на сервисы, чтобы сборки модулей оказались рядом с хостом:

<!-- WebApp.csproj, добавлено -->
<ItemGroup>
  <ProjectReference Include="..Basket.APIBasket.API.csproj" Aliases="modules" />
  <ProjectReference Include="..Catalog.APICatalog.API.csproj" Aliases="modules" />
  <ProjectReference Include="..Ordering.APIOrdering.API.csproj" Aliases="modules" />
  <ProjectReference Include="..OrderProcessorOrderProcessor.csproj" Aliases="modules" />
  <ProjectReference Include="..PaymentProcessorPaymentProcessor.csproj" Aliases="modules" />
  <ProjectReference Include="..Webhooks.APIWebhooks.API.csproj" Aliases="modules" />
</ItemGroup>

Без Aliases в хосте шесть классов Program в глобальном пространстве имен, и он не собирается. А с псевдонимом хост не может написать typeof(Catalog.API.Something), пока не добавит extern alias modules.

В Program.cs хоста появляются проверка имен модулей, общие для процесса сервисы и маршрутизация модулей:

// WebApp/Program.cs
var builder = WebApplication.CreateBuilder(args).ValidateModules();   // добавлено ValidateModules

builder.AddServiceDefaults();

builder.Services.AddRazorComponents().AddInteractiveServerComponents();
builder.AddAuthenticationServices();

// добавлено: то, что делал Program.cs каждого сервиса
builder.AddDefaultAuthentication();
builder.Services.AddProblemDetails();

var withApiVersioning = builder.Services.AddApiVersioning(options =>
{
    options.ReportApiVersions = true;
});

builder.AddDefaultOpenApi(withApiVersioning);
// конец добавленного

builder.AddApplicationServices();

var app = builder.Build();
// ...
app.UseModuleRouting(antiforgery: true);   // было app.UseAntiforgery()
app.UseDefaultOpenApi();                   // добавлено

То, что на первом шаге осталось в Program.cs каждого сервиса, теперь один раз стоит в Program.cs хоста. Вот зачем было правило.

В тестах топологии у переехавших сервисов меняется хост и появляется имя модуля:

// Topologies.cs
new("Basket.API", typeof(webapp::Program), ["Basket.API"]),       // было typeof(basket::Program), []
new("Catalog.API", typeof(webapp::Program), ["Catalog.API"]),     // было typeof(catalog::Program), []
new("Identity.API", typeof(identity::Program), []),               // пока не трогаем
new("Ordering.API", typeof(webapp::Program), ["Ordering.API"]),   // было typeof(ordering::Program), []

Baseline.cs не меняется.

Длаее решаем конкретные проблемы запуска в одном процессе.

Журнал событий

Fails startup: IIntegrationEventLogService. Интерфейсы в двух сервисах одинаковые, но каждый имеет свою реализацию, которая пишет в свою базу. В одном контейнере каталог писал бы события в базу заказов.

Было:

// Catalog.API
builder.Services.AddTransient<IIntegrationEventLogService, IntegrationEventLogService<CatalogContext>>();

// Ordering.API
services.AddTransient<IIntegrationEventLogService, IntegrationEventLogService<OrderingContext>>();

Превратил в keyed service :

// Catalog.API
builder.Services.AddKeyedTransient<IIntegrationEventLogService, IntegrationEventLogService<CatalogContext>>("catalog");

// Ordering.API
services.AddKeyedTransient<IIntegrationEventLogService, IntegrationEventLogService<OrderingContext>>("ordering");

Тот, кто журналом пользуется, просит его по ключу:

public class OrderingIntegrationEventService(IEventBus eventBus,
    OrderingContext orderingContext,
    [FromKeyedServices("ordering")] IIntegrationEventLogService integrationEventLogService,   // добавлен ключ
    ILogger<OrderingIntegrationEventService> logger) : IOrderingIntegrationEventService

Корень сайта

one route in two services: /. Три сервиса в Development редиректили / на Scalar. Редирект удален, корень принадлежит витрине.

Общие маршруты и конфигурация

Map it once, in the host: это уже сделано в Program.cs выше. Восемь ключей с двумя значениями свелись к одному appsettings.json хоста:

"EventBus": {
  "SubscriptionClientName": "eShop"
},
"Identity": {
  "Audience": "eshop",
  "Scopes": {
    "orders": "Orders API",
    "webhooks": "Webhooks API"
  }
},
"OpenApi": {
  "Document": {
    "Title": "eShop HTTP API",
    "Version": "v1"
  }
},

Раньше в appsettings.json витрины из этого был только SubscriptionClientName со значением Ordering.webapp.

Одна шина на процесс

SubscriptionClientName один, значит и очередь одна. А AddRabbitMqEventBus зовут хост и каждый модуль. Вторая шина это второй потребитель той же очереди. Теперь повторный вызов возвращает билдер для подписок и вторую шину не создает:

public static IEventBusBuilder AddRabbitMqEventBus(this IHostApplicationBuilder builder, string connectionName)
{
    // добавлено: шину регистрирует тот, кто первым о ней попросил
    if (builder.Services.Any(d => d.ServiceType == typeof(IEventBus)))
    {
        return new EventBusBuilder(builder.Services);
    }

    builder.AddRabbitMQClient(connectionName);
    // ...

Одно имя события, три типа

Этого инвентарь не увидел. В микросервисах каждый сервис объявляет свою копию события. OrderStatusChangedToPaidIntegrationEvent есть в Ordering, в Catalog, в Webhooks и в WebApp, и это четыре разных типа.

Было:

public Dictionary<string, Type> EventTypes { get; } = [];

// подписка
o.EventTypes[typeof(T).Name] = typeof(T);

// получение сообщения
var integrationEvent = DeserializeMessage(message, eventType);

foreach (var handler in scope.ServiceProvider.GetKeyedServices<IIntegrationEventHandler>(eventType))
{
    await handler.Handle(integrationEvent);
}

Со словарем по короткому имени последняя подписка затирала предыдущие. Событие молча получал один модуль из четырех. Стало:

public Dictionary<string, HashSet<Type>> EventTypes { get; } = [];

// подписка
if (!o.EventTypes.TryGetValue(typeof(T).Name, out var types))
{
    o.EventTypes[typeof(T).Name] = types = [];
}

types.Add(typeof(T));

// получение сообщения: каждый модуль получает событие в своем типе
foreach (var eventType in eventTypes)
{
    var integrationEvent = DeserializeMessage(message, eventType);

    foreach (var handler in scope.ServiceProvider.GetKeyedServices<IIntegrationEventHandler>(eventType))
    {
        await handler.Handle(integrationEvent);
    }
}

Схема по умолчанию

Это то, про что я писал во введении. У сервиса RequireAuthorization() значило «проверь токен». В хосте витрины оно значит «проверь cookie», и мобильный клиент с токеном вместо 401 получает редирект на страницу входа.

Поэтому появилась именованная политика, которая проверяет именно токен:

// ServiceDefaults/AuthenticationExtensions.cs
public const string BearerPolicy = "Bearer";

// было services.AddAuthorization();
services.AddAuthorizationBuilder()
    .AddPolicy(BearerPolicy, policy => policy
        .AddAuthenticationSchemes(JwtBearerDefaults.AuthenticationScheme)
        .RequireAuthenticatedUser());

Эндпоинты модулей ссылаются на нее:

// Ordering.API/Module.cs
orders.MapOrdersApiV1()
      .RequireAuthorization(AuthenticationExtensions.BearerPolicy);   // было RequireAuthorization()

// Basket.API/Module.cs
endpoints.MapGrpcService<BasketService>()
         .RequireAuthorization(AuthenticationExtensions.BearerPolicy);   // добавлено

Файлы модуля

Каталог отдает картинки товаров из папки Pics. Было:

builder.Services.AddKeyedSingleton<IFileProvider>("pics", (services, _) =>
    new PhysicalFileProvider(Path.Combine(
        services.GetRequiredService<IWebHostEnvironment>().ContentRootPath, "Pics")));

ContentRootPath в общем хосте это папка WebApp, картинок товаров там нет. Стало:

builder.Services.AddKeyedSingleton<IFileProvider>("pics", (_, _) =>
    new PhysicalFileProvider(Path.Combine(CatalogFiles.Root, "Pics")));

internal static class CatalogFiles
{
    public static string Root { get; } = Path.GetDirectoryName(typeof(CatalogFiles).Assembly.Location)!;
}

Middleware модуля

Каталог хотел ProblemDetails на 404 от своего API. В общем хосте так же начали отвечать страницы витрины. Теперь middleware включается только для путей API:

// Catalog.API/Module.cs
protected override void Configure(IApplicationBuilder app)
{
    // было app.UseStatusCodePages() на весь пайплайн
    app.UseWhen(context => context.Request.Path.StartsWithSegments("/api"), api => api.UseStatusCodePages());

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapCatalogApi();
    });
}

Hot Reload в Debug

Эта правка появилась уже после перехода на .NET 11. Debug-сборка WebApp стала падать с ошибкой про scoped css bundles без подходящих endpoint’ов: несколько веб-проектов в одном хосте приносят одинаковый JS-модуль Hot Reload. Release собирался нормально. Я отключил его одной строкой в Directory.Build.props:

<EnableHotReloadInRuntimeConfigDevFile>false</EnableHotReloadInRuntimeConfigDevFile>

Пока еще не нашел как не отключать Hot Reload для wasm от blazor.

Коммит 483fb22.

Шаг 5. Identity и один процесс

Identity это MVC с контроллерами, представлениями, статикой и своими cookie. И он хочет жить в корне сайта.

Префикс

Контроллеры Identity переезжают под /identity:

// Identity.API/Module.cs
// было app.UseEndpoints(endpoints => endpoints.MapDefaultControllerRoute());
app.UseEndpoints(endpoints => endpoints.MapControllerRoute(
    name: "identity",
    pattern: "identity/{controller=Home}/{action=Index}/{id?}"));

ASP.NET Identity и IdentityServer сами редиректят на страницы входа, им новые адреса надо назвать явно:

// добавлено
builder.Services.ConfigureApplicationCookie(options =>
{
    options.LoginPath = "/identity/Account/Login";
    options.LogoutPath = "/identity/Account/Logout";
    options.AccessDeniedPath = "/identity/Account/AccessDenied";
});

builder.Services.AddIdentityServer(options =>
{
    // добавлено
    options.UserInteraction.LoginUrl = "/identity/Account/Login";
    options.UserInteraction.LogoutUrl = "/identity/Account/Logout";
    options.UserInteraction.ConsentUrl = "/identity/Consent";
    options.UserInteraction.ErrorUrl = "/identity/Home/Error";
    options.UserInteraction.DeviceVerificationUrl = "/identity/Device";
    // ...

Страницы под /identity, протокольные адреса /connect/* и /.well-known/* в корне. В тестах это четвертый параметр топологии:

// было new("Identity.API", typeof(identity::Program), []),
new("Identity.API", typeof(webapp::Program), ["Identity.API"], "/identity"),

Контроллеры и статика из сборки модуля

MVC ищет контроллеры и представления в сборке приложения. Теперь это WebApp, и сборку модуля надо назвать:

builder.Services.AddControllersWithViews()
        .AddApplicationPart(typeof(Module).Assembly);   // добавлено

Со статикой проще. В Identity.API.csproj добавлено свойство StaticWebAssetBasePath со значением _content/Identity.API, а в представлениях ссылки вида ~/css/site.css заменены на ~/_content/Identity.API/css/site.css. Без базового пути wwwroot модуля и витрины сталкиваются уже при сборке.

Чья cookie

Три схемы из введения встретились в одном процессе. AddIdentity в модуле ставит свои схемы по умолчанию, и витрина начинает читать пользователя из cookie Identity. Витрина закрепляет свои схемы явно:

// WebApp
services.AddAuthentication(options =>
{
    options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
    options.DefaultAuthenticateScheme = CookieAuthenticationDefaults.AuthenticationScheme;   // добавлено
    options.DefaultSignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;         // добавлено
    options.DefaultChallengeScheme = OpenIdConnectDefaults.AuthenticationScheme;
})

А IdentityServer наоборот, читает сессию входа из схемы по умолчанию, то есть из cookie витрины. Пользователь вводит пароль и снова попадает на страницу входа. Бесконечно. Ему надо сказать, где его cookie:

builder.Services.AddIdentityServer(options =>
{
    options.Authentication.CookieAuthenticationScheme = IdentityConstants.ApplicationScheme;   // добавлено
    // ...

И то же самое контроллерам Identity, которые требуют входа:

[SecurityHeaders]
[Authorize(AuthenticationSchemes = "Identity.Application")]   // было [Authorize]
public class ConsentController : Controller

SameSite

По http вход все равно зацикливался. В исходном сервисе от этого защищала одна строка пайплайна:

// было, в Program.cs сервиса
// This cookie policy fixes login issues with Chrome 80+ using HTTP
app.UseCookiePolicy(new CookiePolicyOptions { MinimumSameSitePolicy = SameSiteMode.Lax });
app.UseRouting();
app.UseIdentityServer();

В модуле UseCookiePolicy стоит после UseRouting хоста и до cookie входа не дотягивается. ASP.NET Identity ставит SameSite=None, без Secure браузер такую cookie выбрасывает. Поставил Lax явно, Identity и витрина теперь на одном сайте:

// добавлено в настройки IdentityServer
options.Authentication.CookieSameSiteMode = SameSiteMode.Lax;
options.Authentication.CheckSessionCookieSameSiteMode = SameSiteMode.Lax;

// добавлено для cookie ASP.NET Identity
builder.Services.PostConfigure<CookieAuthenticationOptions>(IdentityConstants.ApplicationScheme,
    options => options.Cookie.SameSite = SameSiteMode.Lax);

Сборка точки входа

Оформление заказа падало с ArgumentNullException в недрах outbox. Журнал событий искал тип события так:

public IntegrationEventLogService(TContext context)
{
    _context = context;
    _eventTypes = Assembly.Load(Assembly.GetEntryAssembly().FullName)
        .GetTypes()
        .Where(t => t.Name.EndsWith(nameof(IntegrationEvent)))
        .ToArray();
}

// ...
.Select(e => e.DeserializeJsonContent(_eventTypes.FirstOrDefault(t => t.Name == e.EventTypeShortName)));

Сборка точки входа теперь WebApp, событий заказов в ней нет, FirstOrDefault возвращает null. Это Assembly.GetEntryAssembly() из списка «что еще проверять» в четвертой статье, только на живом коде. Стало:

private static Type FindEventType(string fullName)
{
    if (s_eventTypes.TryGetValue(fullName, out var known))
    {
        return known;
    }

    var type = AppDomain.CurrentDomain.GetAssemblies()
        .Select(assembly => assembly.GetType(fullName, throwOnError: false))
        .FirstOrDefault(candidate => candidate is not null && typeof(IntegrationEvent).IsAssignableFrom(candidate))
        ?? throw new InvalidOperationException($"The integration event type '{fullName}' is not loaded in this process.");
    return s_eventTypes[fullName] = type;
}

// ...
.Select(e => e.DeserializeJsonContent(FindEventType(e.EventTypeName)));

AppHost

Было – AppHost из введения: семь AddDotnetProject, у каждого свои WithReference, WaitFor и Identity__Url. Стало:

// Порядок важен: миграции Ordering идут до воркера OrderProcessor, который читает их таблицы.
// Раньше это был WaitFor(orderingApi)
string[] modules =
[
    "Identity.API", "Catalog.API", "Basket.API", "Ordering.API",
    "Webhooks.API", "OrderProcessor", "PaymentProcessor",
];

var webApp = builder.AddDotnetProject("webapp", "../WebApp", o => o.LaunchProfileName = launchProfileName)
    .WithExternalHttpEndpoints()
    .WithReference(redis)
    .WithReference(rabbitMq).WaitFor(rabbitMq)
    .WithReference(catalogDb)
    .WithReference(identityDb)
    .WithReference(orderDb).WaitFor(orderDb)
    .WithReference(webhooksDb)
    .WithHttpHealthCheck("/health")
    .WithEnvironment("ASPNETCORE_HOSTINGSTARTUPASSEMBLIES", string.Join(';', modules));

var webAppEndpoint = webApp.GetEndpoint(launchProfileName);

// Identity, сервисы и сама витрина живут по одному адресу
webApp.WithEnvironment("IdentityUrl", webAppEndpoint)
      .WithEnvironment("Identity__Url", webAppEndpoint)
      .WithEnvironment("CallBackUrl", webAppEndpoint);

// Вызовы между частями идут по прежним именам сервисов, но на адрес самого хоста
foreach (var service in new[] { "basket-api", "catalog-api", "ordering-api", "webhooks-api" })
{
    webApp.WithEnvironment($"services__{service}__{launchProfileName}__0", webAppEndpoint);
}

Последние строки значат, что витрина шлет HTTP и gRPC сама себе. С токеном и сериализацией. Выглядит глупо, зато код витрины на этом шаге не тронут вообще.

Тесты на все модули сразу

Топология с одним модулем не видит, сталкиваются ли модули друг с другом. Для этого добавились тесты, которые поднимают все семь:

[Fact]
public async Task AllModules_ServeNoRouteTwice()
{
    await using var host = StartAll();

    // Одинаковые метод и маршрут у двух модулей дают AmbiguousMatchException на запрос
    var twice = host.Services.Routes()
        .GroupBy(route => $"{route.Method} {route.Pattern}")
        .Where(group => group.Select(route => route.Module).Distinct().Count() > 1)
        .Select(group => $"{group.Key}: {string.Join(", ", group.Select(route => route.Module ?? "-"))}")
        .ToArray();

    Assert.True(twice.Length == 0, "Маршруты двух модулей совпадают:" + Environment.NewLine + string.Join(Environment.NewLine, twice));
}

Плюс AllModules_StartTogether, AllModules_ServeTheRoutesOfEveryService и Storefront_KeepsItsDefaultSchemes. Всего 51.

Шаги 4 и 5 я хотел сделать независимыми, но не вышло: на 483fb22 AppHost еще запускает сервисы отдельно, а витрина уже настроена на общий хост, и e2e проходят 2 из 4. С 1904d00 зеленые.

Что получилось после слияния

                           база  1904d00
Процессов                     9        2
Контейнеров                   4        4
Старт, с                   19.1     23.9
e2e, с                     15.1     14.5
WS простоя, МБ             1627      609
WS пик, МБ                 2085      689
Private, МБ                1294      437
Потоки                      443      119
Куча GC, МБ                 652      236
CPU сервисов, с            41.5     52.0
Аллокации, МБ               660     1203
Паузы GC, мс                310      393
Контейнеры, МБ              217      216

Три запуска на коммит, в каждом прогрев и три прогона e2e, в таблице медиана.

Память упала в 2,7 раза, потоков стало в 3,7 раза меньше. Весь эффект от одного изменения: процессов два вместо девяти. CPU-время и аллокации при этом выросли, к ним вернусь в итоговых замерах. Второй процесс это WebhookClient, он в модули не переезжал.

При этом ни один проект еще не стал библиотекой. Все семь сервисов по-прежнему исполняемые, у каждого есть Program.cs, и любой можно запустить отдельно:

new("Catalog.API", typeof(webapp::Program), ["Catalog.API"]),    // модуль в общем хосте
new("Catalog.API", typeof(catalog::Program), []),                // и так тоже работает

Это страховка на время переезда. И топология, которую можно оставить насовсем, если каталогу понадобится отдельный процесс.

Контейнеров по-прежнему четыре, и вот на что они тратят ресурсы:

container    cpuAvgPct  memAvgMb
eventbus          0.43     125.3
mobile-bff        1.57      53.5
postgres          0.00      31.7
redis             0.33       5.6

По медиане BFF потребляет CPU вдвое больше, чем Postgres, Redis и RabbitMQ вместе взятые. В e2e нет ни одного запроса от мобильного клиента. Коммит 1904d00.

Шаг 6. Мобильный BFF больше не нужен

BFF пересылал запросы мобильного клиента в каталог, заказы и Identity. После слияния все три его кластера указывали на один адрес:

builder.AddYarp("mobile-bff")
    .WithExternalHttpEndpoints()
    .ConfigureMobileBffRoutes(webApp, webApp, webApp);

Этот вызов удален, вместе с ним метод ConfigureMobileBffRoutes на семь десятков строк YARP-маршрутов и пакет Aspire.Hosting.Yarp. Минус контейнер.

Клиенты теперь ходят прямо в хост. Раньше у мобильного приложения было три разных адреса, каждый со своим портом:

private static string _baseAddress = DeviceInfo.Platform == DevicePlatform.Android ? "10.0.2.2" : "localhost";

IdentityEndpoint       = $"https://{_baseAddress}:5243";
GatewayCatalogEndpoint = $"http://{_baseAddress}:11632";
GatewayBasketEndpoint  = $"http://{_baseAddress}:5221";
GatewayOrdersEndpoint  = $"http://{_baseAddress}:11632";

Теперь адрес один, и лежит он в файле, который подключен ссылкой в оба MAUI-проекта и в AppHost:

// Android-эмулятор тоже ходит на localhost: перед запуском выполните
//   adb reverse tcp:17298 tcp:17298 && adb reverse tcp:15045 tcp:15045
internal static class WebAppAddress
{
    public const int HttpsPort = 17298;
    public const int HttpPort = 15045;

    public const string Https = "https://localhost:17298";
    public const string Http = "http://localhost:15045";
}

Клиент берет адреса оттуда:

IdentityEndpoint       = WebAppAddress.Https;
GatewayCatalogEndpoint = WebAppAddress.Http;
GatewayBasketEndpoint  = WebAppAddress.Https;   // gRPC корзины идет по https
GatewayOrdersEndpoint  = WebAppAddress.Http;

AppHost по тем же константам открывает у WebApp два дополнительных порта, поэтому клиент не зависит от launchSettings.json:

var webApp = builder.AddDotnetProject("webapp", "../WebApp", o => o.LaunchProfileName = launchProfileName)
    // ...
    .WithHttpsEndpoint(port: WebAppAddress.HttpsPort, name: "mobile-https")   // добавлено
    .WithHttpEndpoint(port: WebAppAddress.HttpPort, name: "mobile-http")      // добавлено
    .WithEnvironment("Identity__ValidIssuers__0", WebAppAddress.Https)        // добавлено

Третья строка нужна потому, что IdentityServer берет издателя токена из адреса запроса. Токен, выданный на порту 17298, сервисы не примут, пока этот адрес не добавить в допустимые. Было:

#if DEBUG
    //Needed if using Android Emulator Locally.
    options.TokenValidationParameters.ValidIssuers = [identityUrl, "https://10.0.2.2:5243"];
#else
    options.TokenValidationParameters.ValidIssuers = [identityUrl];
#endif

Стало, список приходит из конфигурации:

var extraIssuers = identitySection.GetSection("ValidIssuers").Get<string[]>() ?? [];
options.TokenValidationParameters.ValidIssuers = [identityUrl, .. extraIssuers];

Чего я не проверял: само мобильное приложение на устройстве или эмуляторе. Проверено, что порты отвечают и что IdentityServer на 17298 выдает правильного издателя. Коммит 9c2dbfd.

Шаг 7. Сервисы становятся библиотеками

В каждом из семи проектов добавляется <OutputType>Library</OutputType> и удаляется Program.cs. Собираем:

error MOD0001: Type 'IBasketRepository' is public in a module assembly
error MOD0001: Type 'RedisBasketRepository' is public in a module assembly
error MOD0001: Type 'CustomerBasket' is public in a module assembly
...

Вот теперь проверки видимости включились: у проекта больше нет точки входа, и для анализатора он модуль. У правила есть исправление, поэтому руками править не надо:

dotnet format analyzers eShop.slnx --diagnostics MOD0001

204 типа сменили public на internal, отсюда 215 файлов в коммите. После этого пошла вторая волна ошибок, и с ней уже разбирался я.

MVC находит только публичные контроллеры, а контроллеры Identity стали internal. MOD0011 подсказывает что делать, и его исправление дописывает вызов:

builder.Services.AddControllersWithViews()
        .AddApplicationPart(typeof(Module).Assembly)
        .AllowInternalControllers();   // добавлено

Юнит-тесты мокают интерфейсы модулей через NSubstitute. Для internal-интерфейса прокси не создается, пока не откроешь внутренности динамической сборке Castle. В проекты модулей добавлены InternalsVisibleTo для тестовых проектов и для DynamicProxyGenAssembly2.

FluentValidation по умолчанию сканирует только публичные валидаторы. Заказы начали проходить без валидации, и ни один юнит-тест не упал:

// было AddValidatorsFromAssemblyContaining<CancelOrderCommandValidator>()
services.AddValidatorsFromAssemblyContaining<CancelOrderCommandValidator>(includeInternalTypes: true);

MediatR регистрировался через typeof(Program), которого больше нет. Заменил на тип из той же сборки.

Каталог генерировал OpenAPI-документ при сборке через пакет Microsoft.Extensions.ApiDescription.Server. Ему нужна точка входа, чтобы запустить приложение, а у библиотеки ее нет. Генерацию пришлось убрать. Это честная потеря: документ теперь есть только в рантайме и один на весь хост.

Функциональные тесты поднимали Program своего сервиса. Теперь они поднимают WebApp и называют модуль, который нужен:

// было CatalogApiFixture : WebApplicationFactory<Program>
public sealed class CatalogApiFixture : ModularWebApplicationFactory<webapp::Program>, IAsyncLifetime
{
    public CatalogApiFixture()
        : base(["Catalog.API"])   // добавлено
    {

Сами тесты не изменились. Catalog 38, Ordering 11, Webhooks 2: все проходят на хосте, в котором загружен один модуль из семи.

Публичными остались три типа: CatalogBrand, CatalogItem, CatalogType. Это сущности EF, для них в той же сборке есть IEntityTypeConfiguration<T>, правило их пропускает. Коммит 108eea6.

Шаг 8. Вызовы в процессе вместо сети

Витрина перестает ходить к себе по сети. Для этого нужен контракт. Он лежит в новом проекте eShop.Contracts без единой зависимости, на который ссылаются и хост, и модули:

// Покупатель - аргумент: по сети о нем говорил токен, в процессе витрина его и так знает
public interface IBasketService
{
    Task<IReadOnlyCollection<BasketQuantity>> GetBasketAsync(string buyerId);
    Task UpdateBasketAsync(string buyerId, IReadOnlyCollection<BasketQuantity> items);
    Task DeleteBasketAsync(string buyerId);
}

public record BasketQuantity(int ProductId, int Quantity);

Модуль корзины реализует контракт поверх того же репозитория, которым пользуется gRPC-сервис, и регистрирует реализацию у себя в Module.cs:

internal sealed class LocalBasketService(IBasketRepository repository) : IBasketService
{
    public async Task<IReadOnlyCollection<BasketQuantity>> GetBasketAsync(string buyerId)
        => await repository.GetBasketAsync(buyerId) is { } basket
            ? [.. basket.Items.Select(item => new BasketQuantity(item.ProductId, item.Quantity))]
            : [];

    public async Task UpdateBasketAsync(string buyerId, IReadOnlyCollection<BasketQuantity> items)
    {
        var basket = new CustomerBasket { BuyerId = buyerId };
        basket.Items.AddRange(items.Select(item => new Model.BasketItem { ProductId = item.ProductId, Quantity = item.Quantity }));

        _ = await repository.UpdateBasketAsync(basket)
            ?? throw new InvalidOperationException($"Basket with buyer id {buyerId} does not exist");
    }

    public Task DeleteBasketAsync(string buyerId) => repository.DeleteBasketAsync(buyerId);
}

Клиент корзины в витрине был gRPC-клиентом, который перекладывал объекты в сообщения и обратно:

public class BasketService(GrpcBasketClient basketClient)
{
    public async Task<IReadOnlyCollection<BasketQuantity>> GetBasketAsync()
    {
        var result = await basketClient.GetBasketAsync(new ());
        return MapToBasket(result);
    }

    public async Task UpdateBasketAsync(IReadOnlyCollection<BasketQuantity> basket)
    {
        var updatePayload = new UpdateBasketRequest();

        foreach (var item in basket)
        {
            var updateItem = new GrpcBasketItem
            {
                ProductId = item.ProductId,
                Quantity = item.Quantity,
            };
            updatePayload.Items.Add(updateItem);
        }

        await basketClient.UpdateBasketAsync(updatePayload);
    }

    private static List<BasketQuantity> MapToBasket(CustomerBasketResponse response)
    {
        var result = new List<BasketQuantity>();
        foreach (var item in response.Items)
        {
            result.Add(new BasketQuantity(item.ProductId, item.Quantity));
        }

        return result;
    }
}

Теперь он берет покупателя из состояния аутентификации и зовет контракт:

public class BasketService(IBasketService basket, AuthenticationStateProvider authenticationStateProvider)
{
    public async Task<IReadOnlyCollection<BasketQuantity>> GetBasketAsync()
        => await authenticationStateProvider.GetBuyerIdAsync() is { } buyerId
            ? await basket.GetBasketAsync(buyerId)
            : [];

    public async Task UpdateBasketAsync(IReadOnlyCollection<BasketQuantity> items)
        => await basket.UpdateBasketAsync(await BuyerIdAsync(), items);

    private async Task<string> BuyerIdAsync()
        => await authenticationStateProvider.GetBuyerIdAsync()
           ?? throw new InvalidOperationException("The caller is not authenticated.");
}

Из регистраций витрины ушло все сетевое. Вот что удалено:

builder.Services.AddHttpForwarderWithServiceDiscovery();

builder.Services.AddGrpcClient<Basket.BasketClient>(o => o.Address = new("https://basket-api"))
    .AddAuthToken();

builder.Services.AddHttpClient<CatalogService>(o => o.BaseAddress = new("https+http://catalog-api"))
    .AddApiVersion(2.0)
    .AddAuthToken();

builder.Services.AddHttpClient<OrderingService>(o => o.BaseAddress = new("https+http://ordering-api"))
    .AddApiVersion(1.0)
    .AddAuthToken();

Вместе с этим из AppHost удалены переменные service discovery, которые направляли имена basket-api, catalog-api и ordering-api обратно на хост. Прокси /product-images в витрине тоже удален: адрес картинки теперь ведет прямо на эндпоинт каталога api/catalog/items/{id}/pic.

С заказами я не стал звать MediatR напрямую. Реализация контракта вызывает тот же метод, который отвечает на POST /api/orders, потому что в нем маскируется номер карты и проверяется идемпотентность по requestId:

internal sealed class LocalOrderingService(IServiceScopeFactory scopes) : IOrderingService
{
    public async Task CreateOrderAsync(Contract.CreateOrderRequest request, Guid requestId)
    {
        // scope на вызов, как на HTTP-запрос
        await using var scope = scopes.CreateAsyncScope();
        var services = ActivatorUtilities.CreateInstance<OrderServices>(scope.ServiceProvider);

        await OrdersApi.CreateOrderAsync(requestId, new CreateOrderRequest(/* ... */), services);
    }
}

Побочный эффект, которого я не планировал: под профилем http (так запускается CI) корзина раньше не работала, gRPC нужен HTTP/2. Теперь gRPC между витриной и корзиной нет, и e2e проходят по http. Коммит f32d0f6.

Проверяем что ничего не потеряли

dotnet modules inventory eShop.slnx -o inventory-after.json
dotnet modules compare inventory-before.json inventory-after.json --merged webapp basket-api catalog-api identity-api ordering-api webhooks-api order-processor payment-processor

--merged сравнивает один хост «после» с суммой сервисов «до»:

webapp = basket-api + catalog-api + identity-api + ordering-api + webhooks-api + order-processor + payment-processor: 100 differences
  - endpoint GET /Account/Login/{id?} (controller, Identity.API; anonymous)
  + endpoint GET /identity/Account/Login/{id?} (controller, Identity.API; anonymous)
  - endpoint GET /Consent/Index/{id?} (controller, Identity.API; authenticated)
  + endpoint GET /identity/Consent/Index/{id?} (controller, Identity.API; schemes=Identity.Application)
  - endpoint GET /api/orders/ (minimal, Ordering.API; authenticated)
  + endpoint GET /api/orders/ (minimal, Ordering.API; policy=Bearer)
  - endpoint DELETE /api/webhooks/{id:int} (minimal, Webhooks.API; authenticated)
  + endpoint DELETE /api/webhooks/{id:int} (minimal, Webhooks.API; policy=Bearer)
  - endpoint GET / (minimal, eShop.ServiceDefaults; no authorization)
  + endpoint GET,POST / (component, WebApp; no authorization)
  + endpoint GET,POST /cart (component, WebApp; authenticated)
  - registration Transient ...IIntegrationEventLogService -> ...IntegrationEventLogService<...OrderingContext>
  + registration Transient ...IIntegrationEventLogService [key catalog] -> ...IntegrationEventLogService<...CatalogContext>
  + registration Transient ...IIntegrationEventLogService [key ordering] -> ...IntegrationEventLogService<...OrderingContext>
  ...

1 host compared: 0 the same, 1 different.

Сто различий, и в них читается вся миграция. Страницы Identity переехали под /identity и требуют свою схему. У API вместо authenticated теперь policy=Bearer. Корень сайта отдает витрина, а не редирект на Scalar. Журнал событий стал keyed. Плюс страницы витрины и Local*-реализации контрактов. Эндпоинтов, потерянных без замены, нет.

Хостов было 9, стало 2: WebApp (163 регистрации, 71 эндпоинт) и WebhookClient. На последнем коммите проходят все десять тестовых проектов и e2e, 4 из 4, и по https, и по http.

Итоговые замеры

                           база    шаг 7    шаг 8
Процессов                     9        2        2
Контейнеров                   4        3        3
e2e, с                     15.1     14.4     12.0
WS простоя, МБ             1627      619      613
WS пик, МБ                 2085      739      688
Private, МБ                1294      499      455 <--- самое главное
Потоки                      443      118      120
Куча GC, МБ                 652      243      239 
Контейнеры, МБ              217      165      163

После миграции из сервисов в модульный монолит потребление памяти сократилось в два с половиной раза! И быстродействие в e2e выросло на 20%.

Что стало с кодом

Я снял метрики на тех же коммитах. Структура решения считается скриптом по файлам проектов, строки и сложность считает Metrics.exe из Roslyn.

1904d00 – первый шаг, когда в каждом сервисе появился Module.cs 108eea6 это все сервисы в одном процессе, но витрина ходит к ним по сети. f32d0f6 с вызовами в процессе.

                              база    шаг 1    шаг 7    шаг 8
Проектов в src                  19       19       19       20
  из них исполняемых            11       11        4        4
Файлов Program.cs               13       13        6        6
Ссылок между проектами          27       34       34       38
Типов в сервисах: public       206      204        4        4
Типов в сервисах: internal       6       14      212      215
HTTP/gRPC клиентов и прокси     10       10        9        4
Строк тестов                  2318     2893     2917     2931

Самое заметное изменение в видимости. До шага 7 сервис показывал наружу двести типов, после него четыре. Это не косметика: пока сервис был отдельным процессом, public ничего не значил, потому что на сборку никто не ссылался. Когда семь сервисов стали библиотеками одного хоста, любой публичный тип можно позвать из соседнего модуля, и анализатор эту дверь закрыл.

Ссылок между проектами стало больше, 27 → 38. Это цена слияния: WebApp теперь ссылается на все модули, а модули на eShop.Contracts. Зато сетевых клиентов осталось четыре из десяти.

Теперь сам код, без миграций EF и без того, что генерирует protobuf:

                              база    шаг 1    шаг 7    шаг 8
Типов                          361      367      361      366
Строк кода                   10247    10422    10229    10225
Исполняемых строк             3272     3289     3156     3136
Цикломатическая сложность     2032     2053     2039     2053
Индекс сопровождаемости       71.7     71.8     72.2     72.3

Исполняемых строк стало меньше на 136, это 4%. Почти все они ушли на шаге 7, когда вместе с типом проекта удалились Program.cs сервисов: 3272 → 3156 это семь раз повторенные CreateBuilder, AddServiceDefaults, Build и Run. Пока шло слияние, код наоборот рос, +17 строк к шагу 5: это те самые правки про схему, cookie и шину.

Сложность не изменилась, 2032 → 2053. Удалялся линейный шаблонный код, а ветвления остались где были. По сервисам тоже ничего драматичного: PaymentProcessor 20 → 8 исполняемых строк, Webhooks.API 177 → 152, Ordering.API 541 → 527. Везде небольшое уменьшение из-за переноса общего кода в хост.

Что осталось на вторую часть

Здесь только миграция: код сервисов переехал в один процесс почти без изменений. Архитектура внутри модулей осталась как была. Кода во всех проектах стало даже чуть больше за счет тестов.

RabbitMQ остался. Модули в одном процессе по-прежнему общаются через брокер, сага заказа идет через семь событий. Четыре базы остались четырьмя базами, общей модели данных из третьей статьи нет. Вход витрины в Identity все еще идет по OpenID Connect, то есть процесс редиректит браузер сам на себя.

Этим займется вторая часть. План такой: свернуть четыре DbContext в один, перенести данные в одну базу, потом убрать шину событий и MediatR. Это даст значимое сокращение кода.

PS. Если попробуете dotnet modules topology на своем решении, напишите в комментариях что он нашел. Мне правда интересно, насколько eShop типичный.

Материалы

Автор: gandjustas

Источник