In-process hosting (Hosting trong tiến trình) với IIS và ASP.NET Core

In-process hosting chạy ứng dụng ASP.NET Core trong cùng process với IIS worker process. In-process hosting cung cấp hiệu suất được cải thiện so với out-of-process hosting vì các request không được proxy qua loopback adapter (bộ điều hợp vòng lặp), một network interface trả lại lưu lượng mạng đi ra về cùng máy.

Sơ đồ sau minh họa mối quan hệ giữa IIS, ASP.NET Core Module và ứng dụng được host in-process:

!ASP.NET Core Module trong kịch bản hosting in-process

Bật in-process hosting

Kể từ ASP.NET Core 3.0, in-process hosting được bật theo mặc định cho tất cả ứng dụng được triển khai lên IIS.

Để cấu hình tường minh ứng dụng cho in-process hosting, đặt giá trị của thuộc tính <AspNetCoreHostingModel> thành InProcess trong project file (.csproj):

<PropertyGroup>
  <AspNetCoreHostingModel>InProcess</AspNetCoreHostingModel>
</PropertyGroup>

Kiến trúc tổng quan

Luồng chung của một request như sau:

1. Request đến từ web đến kernel-mode HTTP.sys driver.
2. Driver định tuyến native request đến IIS trên port được cấu hình của website, thường là 80 (HTTP) hoặc 443 (HTTPS).
3. ASP.NET Core Module nhận native request và chuyển nó đến IIS HTTP Server (IISHttpServer). IIS HTTP Server là một in-process server implementation cho IIS, chuyển đổi request từ native sang managed.

Sau khi IIS HTTP Server xử lý request:

1. Request được gửi đến ASP.NET Core middleware pipeline (đường ống phần mềm trung gian).
2. Middleware pipeline xử lý request và chuyển nó như một instance HttpContext đến logic của ứng dụng.
3. Phản hồi của ứng dụng được chuyển lại IIS thông qua IIS HTTP Server.
4. IIS gửi phản hồi đến client đã khởi tạo request.

CreateDefaultBuilder thêm một instance IServer bằng cách gọi phương thức UseIIS để boot CoreCLR và host ứng dụng bên trong IIS worker process (w3wp.exe hoặc iisexpress.exe). Performance tests (kiểm tra hiệu suất) cho thấy rằng hosting ứng dụng .NET in-process mang lại throughput request cao hơn đáng kể so với hosting ứng dụng out-of-process và proxy request đến Kestrel.

Các ứng dụng được publish dưới dạng single file executable không thể được tải bởi mô hình hosting in-process.

Cấu hình ứng dụng

Để cấu hình tùy chọn IIS, bao gồm cấu hình dịch vụ cho IISServerOptions trong Program.cs. Ví dụ sau vô hiệu hóa AutomaticAuthentication:

using Microsoft.AspNetCore.Authentication;
using Microsoft.AspNetCore.Identity;
using Microsoft.AspNetCore.Server.IIS;
using Microsoft.EntityFrameworkCore;
using RPauth.Data;

var builder = WebApplication.CreateBuilder(args);

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString));
builder.Services.AddDatabaseDeveloperPageExceptionFilter();

builder.Services.AddDefaultIdentity<IdentityUser>(options => options.SignIn.RequireConfirmedAccount = true)
    .AddEntityFrameworkStores<ApplicationDbContext>();

builder.Services.Configure<IISServerOptions>(options =>
{
    options.AutomaticAuthentication = false;
});

builder.Services.AddTransient<IClaimsTransformation, MyClaimsTransformation>();
builder.Services.AddAuthentication(IISServerDefaults.AuthenticationScheme);

builder.Services.AddRazorPages();

var app = builder.Build();

if (app.Environment.IsDevelopment())
{
    app.UseMigrationsEndPoint();
}
else
{
    app.UseExceptionHandler("/Error");
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseRouting();

app.UseAuthentication();
app.UseAuthorization();

app.MapRazorPages();

app.Run();

Sự khác biệt giữa in-process và out-of-process hosting

Các đặc điểm sau áp dụng khi hosting in-process:

• IIS HTTP Server (IISHttpServer) được sử dụng thay vì Kestrel server. Đối với in-process, CreateDefaultBuilder gọi UseIIS để:
• Đăng ký IISHttpServer.
• Cấu hình port và base path mà server nên lắng nghe khi chạy đằng sau ASP.NET Core Module.
• Cấu hình host để capture các lỗi khởi động.
• Thuộc tính requestTimeout không áp dụng cho in-process hosting.
• Chia sẻ app pool giữa các ứng dụng không được hỗ trợ. Sử dụng một app pool cho mỗi ứng dụng.
• Kiến trúc (bitness) của ứng dụng và runtime đã cài đặt (x64 hoặc x86) phải khớp với kiến trúc của app pool. Ví dụ, các ứng dụng được publish cho 32-bit (x86) phải có 32-bit được bật cho IIS Application Pools của chúng.
• Client disconnects (ngắt kết nối client) được phát hiện. Cancellation token HttpContext.RequestAborted bị hủy khi client ngắt kết nối.
• Khi hosting in-process, AuthenticateAsync không được gọi nội bộ để khởi tạo người dùng. Do đó, việc triển khai IClaimsTransformation được dùng để chuyển đổi claims (xác nhận quyền) sau mỗi lần xác thực không được kích hoạt theo mặc định. Khi chuyển đổi claims với triển khai IClaimsTransformation, gọi AddAuthentication để thêm dịch vụ xác thực.
• Web Package (single-file) deployments không được hỗ trợ.

Lấy thông tin timing

Xem Lấy thông tin timing chi tiết với IHttpSysRequestTimingFeature.