83 lines
2.8 KiB
Markdown
83 lines
2.8 KiB
Markdown
---
|
|
title: Migrate from ASP.NET Core 5.0 to 6.0
|
|
author: scottaddie
|
|
description: Learn how to migrate an ASP.NET Core 5.0 project to ASP.NET Core 6.0.
|
|
ms.author: scaddie
|
|
ms.date: 03/15/2021
|
|
no-loc: [appsettings.json, "ASP.NET Core Identity", cookie, Cookie, Blazor, "Blazor Server", "Blazor WebAssembly", "Identity", "Let's Encrypt", Razor, SignalR]
|
|
uid: migration/50-to-60
|
|
---
|
|
# Migrate from ASP.NET Core 5.0 to 6.0
|
|
|
|
This article explains how to update an existing ASP.NET Core 5.0 project to ASP.NET Core 6.0.
|
|
|
|
## Prerequisites
|
|
|
|
# [Visual Studio](#tab/visual-studio)
|
|
|
|
[!INCLUDE[](~/includes/net-prereqs-vs-6.0.md)]
|
|
|
|
# [Visual Studio Code](#tab/visual-studio-code)
|
|
|
|
[!INCLUDE[](~/includes/net-prereqs-vsc-6.0.md)]
|
|
|
|
# [Visual Studio for Mac](#tab/visual-studio-mac)
|
|
|
|
[!INCLUDE[](~/includes/net-prereqs-mac-6.0.md)]
|
|
|
|
---
|
|
|
|
## Update .NET SDK version in global.json
|
|
|
|
If you rely upon a [global.json](/dotnet/core/tools/global-json) file to target a specific .NET SDK version, update the `version` property to the .NET 6.0 SDK version that's installed. For example:
|
|
|
|
```diff
|
|
{
|
|
"sdk": {
|
|
- "version": "5.0.100"
|
|
+ "version": "6.0.100-preview.2.21155.3"
|
|
}
|
|
}
|
|
```
|
|
|
|
## Update the target framework
|
|
|
|
Update the project file's [Target Framework Moniker (TFM)](/dotnet/standard/frameworks) to `net6.0`:
|
|
|
|
```diff
|
|
<Project Sdk="Microsoft.NET.Sdk.Web">
|
|
|
|
<PropertyGroup>
|
|
- <TargetFramework>net5.0</TargetFramework>
|
|
+ <TargetFramework>net6.0</TargetFramework>
|
|
</PropertyGroup>
|
|
|
|
</Project>
|
|
```
|
|
|
|
## Update package references
|
|
|
|
In the project file, update each [Microsoft.AspNetCore.*](https://www.nuget.org/packages?q=Microsoft.AspNetCore.*) and [Microsoft.Extensions.*](https://www.nuget.org/packages?q=Microsoft.Extensions.*) package reference's `Version` attribute to 6.0.0 or later. For example:
|
|
|
|
```diff
|
|
<ItemGroup>
|
|
- <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="5.0.3" />
|
|
- <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="5.0.0" />
|
|
+ <PackageReference Include="Microsoft.AspNetCore.JsonPatch" Version="6.0.0-preview.2.*" />
|
|
+ <PackageReference Include="Microsoft.Extensions.Caching.Abstractions" Version="6.0.0-preview.2.*" />
|
|
</ItemGroup>
|
|
```
|
|
|
|
## Update Docker images
|
|
|
|
For apps using Docker, update your *Dockerfile* `FROM` statements and scripts. Use a base image that includes the ASP.NET Core 6.0 runtime. Consider the following `docker pull` command difference between ASP.NET Core 5.0 and 6.0:
|
|
|
|
```diff
|
|
- docker pull mcr.microsoft.com/dotnet/aspnet:5.0
|
|
+ docker pull mcr.microsoft.com/dotnet/aspnet:6.0
|
|
```
|
|
|
|
## Review breaking changes
|
|
|
|
For breaking changes from .NET 5.0 to .NET 6.0, see [Breaking changes for migration from version 5.0 to 6.0](/dotnet/core/compatibility/6.0). ASP.NET Core and Entity Framework Core are also included in the list.
|