2.2.0-Preview.1

@qianyuansun

This release supports .NET 6.0 and .NET 8.0. See Getting Started.

The Yarp.ReverseProxy packages are available on NuGet.org.

Breaking changes

HeaderMatchMode.NotExists now also matches headers with an empty value (#2412 by @qianyuansun).
- This makes NotExists exactly the opposite of Exists. Previously, empty values would not match either mode.
Errors triggered by the client disconnecting are now logged under a Debug severity (#2503 by @MihaZupan).
- ForwarderError.RequestCanceled, RequestBodyCanceled, and UpgradeRequestCanceled are now logged under a new ILogger event with a Debug severity. Other errors continue to be logged under the existing event with a Warning severity.
- How errors are mapped to different ForwarderErrors remains the same.

Added support for Kestrel Start/Stop events on IKestrelTelemetryConsumer (#2360 by @ajay-sainy).
Added support for controlling OutputCachePolicy in the route configuration (#2328 by @witskeeper).
- See the Output Caching documentation for more details.
X-Forwarded-For now prefers the IPv4 form for dual-mode sockets (#2400 by @hacst).
- E.g. 127.0.0.1 is used instead of ::ffff:127.0.0.1.
Fixed a bug where active health checks would consider new destinations as Healthy instead of Unknown (#2415 by @robbieknuth).
- Destinations now remain as Unknown until enough health probes have been sent.
Added a new Query property to active health check configuration (#2421 by @robbieknuth).
- Previously, only Path could have been specified, and ? would be escaped to %3F.
Added support to HttpSysDelegator for detaching from and re-initializing queues (#2426 by @NGloreous).
Fixed a race condition reliability bug in HttpSysDelegator (#2487 by @NGloreous).
OperationCanceledExceptions thrown by response transforms as part of error handling are now ignored (#2452 by @MihaZupan).
Fixed a bug where YARP validation of UseRequestTimeouts was too strict (#2501 by @MihaZupan).
Reduced the performance overhead of updating the activity timeout timer (#2475 by @MihaZupan).
Many documentation improvements.

For a full list of changes see here.