Update Kestrel Overview to 6.0 (#24079)
* Update Kestrel Overview to 6.0 * . * . * . * .pull/24084/head
parent
35df907c2b
commit
5c14d05fc2
|
@ -28,15 +28,13 @@ Kestrel supports the following scenarios:
|
||||||
|
|
||||||
Kestrel is supported on all platforms and versions that .NET Core supports.
|
Kestrel is supported on all platforms and versions that .NET Core supports.
|
||||||
|
|
||||||
[View or download sample code](https://github.com/dotnet/AspNetCore.Docs/tree/main/aspnetcore/fundamentals/servers/kestrel/samples/5.x) ([how to download](xref:index#how-to-download-a-sample))
|
|
||||||
|
|
||||||
## Get started
|
## Get started
|
||||||
|
|
||||||
ASP.NET Core project templates use Kestrel by default when not hosted with IIS. In *Program.cs*, the <xref:Microsoft.Extensions.Hosting.GenericHostBuilderExtensions.ConfigureWebHostDefaults%2A> method calls <xref:Microsoft.AspNetCore.Hosting.WebHostBuilderKestrelExtensions.UseKestrel%2A>:
|
ASP.NET Core project templates use Kestrel by default when not hosted with IIS. In *Program.cs*, the <xref:Microsoft.AspNetCore.Builder.WebApplication.CreateBuilder%2A?displayProperty=nameWithType> method calls <xref:Microsoft.AspNetCore.Hosting.WebHostBuilderKestrelExtensions.UseKestrel%2A>:
|
||||||
|
|
||||||
:::code language="csharp" source="kestrel/samples/5.x/KestrelSample/Program.cs" id="snippet_DefaultBuilder" highlight="8":::
|
:::code language="csharp" source="kestrel/samples/6.x/KestrelSample/Program.cs" id="snippet_CreateBuilder" highlight="1":::
|
||||||
|
|
||||||
For more information on building the host, see the *Set up a host* and *Default builder settings* sections of <xref:fundamentals/host/generic-host#set-up-a-host>.
|
For more information on configuring `WebApplication` and `WebApplicationBuilder`, see <xref:fundamentals/minimal-apis>.
|
||||||
|
|
||||||
## Optional client certificates
|
## Optional client certificates
|
||||||
|
|
||||||
|
|
|
@ -49,7 +49,7 @@ HTTP/3 isn't currently supported on macOS and may be available in a future relea
|
||||||
|
|
||||||
HTTP/3 is not enabled by default. Add configuration to *Program.cs* to enable HTTP/3.
|
HTTP/3 is not enabled by default. Add configuration to *Program.cs* to enable HTTP/3.
|
||||||
|
|
||||||
[!code-csharp[](samples/6.x/Http3Sample/Program.cs?name=snippet_UseHttp3&highlight=7-8)]
|
:::code language="csharp" source="samples/6.x/KestrelSample/Snippets/Program.cs" id="snippet_Http3" highlight="7-8":::
|
||||||
|
|
||||||
The preceding code configures port 5001 to:
|
The preceding code configures port 5001 to:
|
||||||
|
|
||||||
|
|
|
@ -1,7 +0,0 @@
|
||||||
<Project Sdk="Microsoft.NET.Sdk.Web">
|
|
||||||
|
|
||||||
<PropertyGroup>
|
|
||||||
<TargetFramework>net6.0</TargetFramework>
|
|
||||||
</PropertyGroup>
|
|
||||||
|
|
||||||
</Project>
|
|
|
@ -1,22 +0,0 @@
|
||||||
using System;
|
|
||||||
using System.Net;
|
|
||||||
using System.Threading.Tasks;
|
|
||||||
using Microsoft.AspNetCore.Builder;
|
|
||||||
using Microsoft.AspNetCore.Hosting;
|
|
||||||
using Microsoft.AspNetCore.Server.Kestrel.Core;
|
|
||||||
|
|
||||||
#region snippet_UseHttp3
|
|
||||||
var builder = WebApplication.CreateBuilder(args);
|
|
||||||
builder.WebHost.ConfigureKestrel((context, options) =>
|
|
||||||
{
|
|
||||||
options.ListenAnyIP(5001, listenOptions =>
|
|
||||||
{
|
|
||||||
// Use HTTP/3
|
|
||||||
listenOptions.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
|
|
||||||
listenOptions.UseHttps();
|
|
||||||
});
|
|
||||||
});
|
|
||||||
#endregion
|
|
||||||
await using var app = builder.Build();
|
|
||||||
app.MapGet("/", () => "Hello World!");
|
|
||||||
await app.RunAsync();
|
|
|
@ -0,0 +1,10 @@
|
||||||
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
||||||
|
|
||||||
|
<PropertyGroup>
|
||||||
|
<TargetFramework>net6.0</TargetFramework>
|
||||||
|
<Nullable>enable</Nullable>
|
||||||
|
<ImplicitUsings>enable</ImplicitUsings>
|
||||||
|
<EnablePreviewFeatures>True</EnablePreviewFeatures>
|
||||||
|
</PropertyGroup>
|
||||||
|
|
||||||
|
</Project>
|
|
@ -0,0 +1,8 @@
|
||||||
|
// <snippet_CreateBuilder>
|
||||||
|
var builder = WebApplication.CreateBuilder(args);
|
||||||
|
var app = builder.Build();
|
||||||
|
|
||||||
|
app.MapGet("/", () => "Hello World!");
|
||||||
|
|
||||||
|
app.Run();
|
||||||
|
// </snippet_CreateBuilder>
|
|
@ -0,0 +1,22 @@
|
||||||
|
using Microsoft.AspNetCore.Server.Kestrel.Core;
|
||||||
|
|
||||||
|
namespace KestrelSample.Snippets;
|
||||||
|
|
||||||
|
public static class Program
|
||||||
|
{
|
||||||
|
public static void Http3(string[] args)
|
||||||
|
{
|
||||||
|
// <snippet_Http3>
|
||||||
|
var builder = WebApplication.CreateBuilder(args);
|
||||||
|
|
||||||
|
builder.WebHost.ConfigureKestrel((context, options) =>
|
||||||
|
{
|
||||||
|
options.ListenAnyIP(5001, listenOptions =>
|
||||||
|
{
|
||||||
|
listenOptions.Protocols = HttpProtocols.Http1AndHttp2AndHttp3;
|
||||||
|
listenOptions.UseHttps();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
// </snippet_Http3>
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,8 @@
|
||||||
|
{
|
||||||
|
"Logging": {
|
||||||
|
"LogLevel": {
|
||||||
|
"Default": "Information",
|
||||||
|
"Microsoft.AspNetCore": "Warning"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
|
@ -0,0 +1,9 @@
|
||||||
|
{
|
||||||
|
"Logging": {
|
||||||
|
"LogLevel": {
|
||||||
|
"Default": "Information",
|
||||||
|
"Microsoft.AspNetCore": "Warning"
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"AllowedHosts": "*"
|
||||||
|
}
|
Loading…
Reference in New Issue