Skip to content

Add Kestrel architecture overview - #69330

Open
PureWeen wants to merge 2 commits into
dotnet:mainfrom
PureWeen:shneuvil-kestrel-architecture
Open

PureWeen wants to merge 2 commits into
dotnet:mainfrom
PureWeen:shneuvil-kestrel-architecture

Conversation

@PureWeen

Copy link
Copy Markdown
Member

Summary

  • add an area-owner-reviewable architecture overview for Kestrel
  • document startup and Hosting handoff, endpoint binding, transports, TLS and protocol selection, HTTP/1.1, HTTP/2, and HTTP/3 lifetimes, request features, body I/O and backpressure, timeouts, shutdown, pooling, diagnostics, generation, and verification boundaries
  • define adjacent ownership explicitly so Kestrel does not claim HttpSys, IIS/ANCM, generic HTTP abstractions or middleware, Hosting request lifetime, higher-level SignalR/gRPC semantics, runtime socket/TLS/QUIC internals, or reverse-proxy/application policy

Context

#69011 is the wider servers/networking review-guidance effort. This PR extracts the durable Kestrel-owned technical knowledge into a focused architecture document for server-owner validation.

The single-file shape follows @javiercn's merged Components architecture document in #69147 and the sibling architecture work in #69200, #69216, #69242, #69243, and #69292.

Validation

  • effective diff is exactly one additive file: src/Servers/Kestrel/ARCHITECTURE.md
  • git diff --check origin/main...HEAD
  • all repository-relative links resolve
  • generated Markdown anchors are unique
  • all referenced external documentation URLs return successful responses
  • the existing repository markdownlint workflow targets docs/**/*.md, so it does not apply to this source-area document

@github-actions github-actions Bot added the area-networking Includes servers, yarp, json patch, bedrock, websockets, http client factory, and http abstractions label Sep 15, 2026
@PureWeen
PureWeen marked this pull request as ready for review September 15, 2026 21:47
Copilot AI lite review requested due to automatic review settings September 15, 2026 21:47

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

The architecture document has unresolved accuracy and verification-guidance issues.

Get a fresh assessment by requesting another Copilot review.

Review tier: Lite
Findings: 3 Low severity

Open (3)
What changed in this PR

Adds a Kestrel architecture overview covering ownership, startup, transports, protocols, I/O, shutdown, diagnostics, and verification.

Changes:

  • Documents Kestrel subsystem composition and protocol lifetimes.
  • Defines ownership boundaries and verification locations.
  • Covers HTTP/1.1, HTTP/2, HTTP/3, TLS, pooling, and backpressure.
File Description
src/​Servers/​Kestrel/​ARCHITECTURE.md Adds the Kestrel architecture overview.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Comment thread src/Servers/Kestrel/ARCHITECTURE.md Outdated
Comment thread src/Servers/Kestrel/ARCHITECTURE.md Outdated
Comment thread src/Servers/Kestrel/ARCHITECTURE.md Outdated
@PureWeen
PureWeen force-pushed the shneuvil-kestrel-architecture branch from acc3e7a to 18fd772 Compare September 16, 2026 19:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-networking Includes servers, yarp, json patch, bedrock, websockets, http client factory, and http abstractions

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants