This release supports .NET Core 3.1 and .NET 5.0. See Getting Started.
The Yarp.ReverseProxy packages are available on NuGet.org.
Major changes and features:
- [Breaking change] This release contains a number of API breaking changes that aim to make YARP easier and more consistent to use:
ProxyMatch
=>RouteMatch
AddProxyConfigFilter
=>AddConfigFilter
UseProxyLoadBalancing
=>UseLoadBalancing
UseAffinitizedDestinationLookup
=>UseSessionAffinity
- Removed
RouteManager
,ClusterManager
,DestinationManager
- Changed the routes config model from an array to a Dictionary - #900
Sample change might look like:
"Routes": [ { "RouteId": "route1", "ClusterId": "cluster1" } ]
"Routes": { "route1": { "ClusterId": "cluster1" } }
- [Breaking change]
X-Fowarded-PathBase
header has been replaced withX-Forwarded-Prefix
- Added the ability to interrupt and replace proxy responses (like adding retries) - #866
- Exposed
ProxyHttpClientFactory
, simplifying the customization ofHttpClient
instances - #869 - Added
WebProxy
support for outgoing requests - #879 - [Breaking change] For the
Telemetry.Consumption
library, removedAdd*TelemetryListener
methods in favour of a singleAddTelemetryListeners
, forcing consumer lifetime to singleton - #928 - Many small fixes
For a complete list of changes see the PR history.