You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: aspnetcore/migration/70-80.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -483,7 +483,7 @@ Updated configuration guidance appears in the following locations:
483
483
484
484
### Drop Blazor Server with Yarp routing workaround
485
485
486
-
If you previously followed the guidance in <xref:migration/inc/blazor?view=aspnetcore-7.0&preserve-view=true> for migrating a Blazor Server app with Yarp to .NET 6 or .NET 7, you can reverse the workaround steps that you took when following the article's guidance. Routing and deep linking for Blazor Server with Yarp work correctly in .NET 8.
486
+
If you previously followed the guidance in <xref:migration/fx-to-core/inc/blazor?view=aspnetcore-7.0&preserve-view=true> for migrating a Blazor Server app with Yarp to .NET 6 or .NET 7, you can reverse the workaround steps that you took when following the article's guidance. Routing and deep linking for Blazor Server with Yarp work correctly in .NET 8.
487
487
488
488
### Migrate `CascadingValue` components in layout components
Copy file name to clipboardExpand all lines: aspnetcore/migration/fx-to-core/inc/abtesting.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,14 +6,14 @@ ms.author: tasou
6
6
monikerRange: '>= aspnetcore-6.0'
7
7
ms.date: 3/1/2023
8
8
ms.topic: article
9
-
uid: migration/inc/ab-testing
9
+
uid: migration/fx-to-core/inc/ab-testing
10
10
---
11
11
12
12
# A/B Testing endpoints during migration
13
13
14
14
During incremental migration, new endpoints are brought over to a [YARP](https://dotnet.github.io/yarp/) enabled ASP.NET Core app. With the default setup, these endpoints are automatically served for all requests once deployed. In order to test these endpoints, or be able to turn them off if needed, additional setup is needed.
15
15
16
-
This document describes how to setup a conditional endpoint selection system to enable A/B testing during incremental migration. It assumes a setup as described in [incremental migration overview](xref:migration/inc/overview) as a starting point.
16
+
This document describes how to setup a conditional endpoint selection system to enable A/B testing during incremental migration. It assumes a setup as described in [incremental migration overview](xref:migration/fx-to-core/inc/overview) as a starting point.
Copy file name to clipboardExpand all lines: aspnetcore/migration/fx-to-core/inc/overview.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ ms.author: riande
6
6
monikerRange: '>= aspnetcore-6.0'
7
7
ms.date: 11/9/2022
8
8
ms.topic: article
9
-
uid: migration/inc/overview
9
+
uid: migration/fx-to-core/inc/overview
10
10
---
11
11
12
12
<!-- see mermaid.txt to change diagrams -->
@@ -19,24 +19,24 @@ One of the larger challenges is the pervasive use of <xref:System.Web.HttpContex
19
19
20
20
A complete migration may take considerable effort depending on the size of the app, dependencies, and non-portable APIs used. In order to keep deploying an app to production while working on updating, the best pattern is to follow is the [Strangler Fig pattern](/azure/architecture/patterns/strangler-fig). The *Strangler Fig pattern* allows for continual development on the old system with an incremental approach to replacing specific pieces of functionality with new services. This document describes how to apply the Strangler Fig pattern to an ASP.NET app updating towards ASP.NET Core.
21
21
22
-
If you'd like to skip this overview article and get started, see [Get started](xref:migration/inc/start).
22
+
If you'd like to skip this overview article and get started, see [Get started](xref:migration/fx-to-core/inc/start).
23
23
24
24
## App migration to ASP.NET Core
25
25
26
26
Before starting the migration, the app targets ASP.NET Framework and runs on Windows with its supporting libraries:
27
27
28
-

28
+

29
29
30
30
Migration starts by introducing a new app based on ASP.NET Core that becomes the entry point. Incoming requests go to the ASP.NET Core app, which either handles the request or proxies the request to the .NET Framework app via [YARP](https://dotnet.github.io/yarp/). At first, the majority of code providing responses is in the .NET Framework app, but the ASP.NET Core app is now set up to start migrating routes:
To migrate business logic that relies on `HttpContext`, the libraries need to be built with `Microsoft.AspNetCore.SystemWebAdapters`. Building the libraries with `SystemWebAdapters` allows:
35
35
36
36
* The libraries to be built against .NET Framework, .NET Core, or .NET Standard 2.0.
37
37
* Ensures that the libraries are using APIs that are available on both ASP.NET Framework and ASP.NET Core.
Once the ASP.NET Core app using YARP is set up, you can start updating routes from ASP.NET Framework to ASP.NET Core. For example, WebAPI or MVC controller action methods,handlers, or some other implementation of a route. If the route is available in the ASP.NET Core app, it's matched and served.
42
42
@@ -48,14 +48,14 @@ During the migration process, additional services and infrastructure are identif
48
48
49
49
Eventually, the ASP.NET Core app handles more of the routes than the .NET Framework app:
50
50
51
-

51
+

52
52
53
53
Once the ASP.NET Framework app is no longer needed and deleted:
54
54
55
55
* The app is running on the ASP.NET Core app stack, but is still using the adapters.
56
56
* The remaining migration work is removing the use of adapters.
The Visual Studio extension [.NET Upgrade Assistant](https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.upgradeassistant) can help upgrade ASP.NET Framework web apps to ASP.NET Core. For more information see the blog post [Upgrading your .NET projects with Visual Studio](https://devblogs.microsoft.com/dotnet/upgrade-assistant-now-in-visual-studio/).
61
61
@@ -68,12 +68,12 @@ The `Microsoft.AspNetCore.SystemWebAdapters` namespace is a collection of runtim
68
68
*`Microsoft.AspNetCore.SystemWebAdapters.CoreServices`: This package only targets .NET 6+ and is intended to provide services to ASP.NET Core applications to configure behavior of `System.Web` APIs as well as opting into any behaviors for incremental migration. This is generally not expected to be referenced from libraries, but rather from the applications themselves.
69
69
*`Microsoft.AspNetCore.SystemWebAdapters.Abstractions`: This package is a supporting package that provides abstractions for services used by both the ASP.NET Core and ASP.NET Framework application such as session state serialization.
70
70
71
-
For examples of scenarios where this is useful, see [the adapters article](xref:migration/inc/adapters).
71
+
For examples of scenarios where this is useful, see [the adapters article](xref:migration/fx-to-core/inc/adapters).
72
72
73
-
For guidance around usage, see the [usage guidance article](xref:migration/inc/usage_guidance).
73
+
For guidance around usage, see the [usage guidance article](xref:migration/fx-to-core/inc/usage_guidance).
74
74
75
75
## Additional Resources
76
76
77
77
*[Example migration of eShop to ASP.NET Core](/dotnet/architecture/porting-existing-aspnet-apps/example-migration-eshop)
78
78
*[Video:Tooling for Incremental ASP.NET Core Migrations](https://www.youtube.com/watch?v=P96l0pDNVpM)
0 commit comments