Skip to content

Commit

Permalink
Update doc supported .NET 6 runtime (#1659)
Browse files Browse the repository at this point in the history
* Update doc supported .NET 6 runtime

* Apply suggestions from code review

Co-authored-by: Chris Ross <Tratcher@Outlook.com>
Co-authored-by: Miha Zupan <mihazupan.zupan1@gmail.com>

* Update doc supported .NET 7 runtime

* Update docs/docfx/articles/runtimes.md

Co-authored-by: Chris Ross <Tratcher@Outlook.com>

Co-authored-by: Chris Ross <Tratcher@Outlook.com>
Co-authored-by: Miha Zupan <mihazupan.zupan1@gmail.com>
  • Loading branch information
3 people authored Apr 20, 2022
1 parent fdb5689 commit b8a58a6
Showing 1 changed file with 19 additions and 2 deletions.
21 changes: 19 additions & 2 deletions docs/docfx/articles/runtimes.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,9 @@ title: Supported Runtimes

# YARP Supported Runtimes

YARP 1.0 previews support ASP.NET Core 3.1 and 5.0. You can download the .NET 5 SDK from https://dotnet.microsoft.com/download/dotnet/5.0. See [Releases](https://github.com/microsoft/reverse-proxy/releases) for specific version support.
YARP 1.1 supports ASP.NET Core 3.1, 5.0 and 6.0. You can download the .NET SDK from https://dotnet.microsoft.com/download/dotnet/. See [Releases](https://github.com/microsoft/reverse-proxy/releases) for specific version support.

YARP is taking advantage of ASP.NET Core 5.0 features and optimizations. This does mean that some features may not be available if you're running on ASP.NET Core 3.1.
YARP is taking advantage of ASP.NET Core 6.0 features and optimizations. This does mean that some features may not be available if you're running on the previous versions of ASP.NET.

## Difference in features supported on .NET Core 3.1 vs .NET 5.0 and higher

Expand Down Expand Up @@ -55,3 +55,20 @@ These are related improvements in .NET 5.0 or ASP.NET Core 5.0 that YARP is able
- [Allocation savings via pipe pooling](https://github.com/dotnet/aspnetcore/pull/19356).
- HttpClient HTTP/2 [performance improvements](https://github.com/dotnet/runtime/issues/35184).

## Related 6.0 Runtime Improvements

- [HTTP/3](http3.md) - support for inbound and outbound connections (preview).
- [Distributed Tracing](distributed-tracing.md) - .NET 6.0 has built-in configurable support that YARP takes advantage of to enable more scenarios out-of-the-box.
- [Http.sys Delegation](httpsys-delegation.md) - a kernel-level ASP.NET Core 6 feature that allows a request to be transferred to a different process.
- [UseHttpLogging](diagnosing-yarp-issues.md#using-aspnet-6-request-logging) - includes an additional middleware component that can be used to provide more details about the request and response.
- [Dynamic HTTP/2 window scaling](https://github.com/dotnet/runtime/pull/54755) - improves HTTP/2 download speed on high-latency connections.
- [NonValidated headers](https://github.com/microsoft/reverse-proxy/pull/1507) - improves perfomance by using non-validated HttpClient headers.


## Related 7.0 Runtime Improvements

- [HTTP/3](http3.md) - support for inbound and outbound connections (stable).
- [Zero-byte reads on HttpClient's response streams](https://github.com/dotnet/runtime/pull/61913) - reduces memory usage.
- [Header allocation reductions](https://github.com/dotnet/runtime/pull/62981) - reduces memory usage.
- [Kestrel Http/2 perf improvements](https://github.com/dotnet/aspnetcore/pull/40925) - Improve contention and throughput for multiple requests on one connection.

0 comments on commit b8a58a6

Please sign in to comment.