Skip to content

Commit ea9300f

Browse files
committed
move inc folder
1 parent 3a82866 commit ea9300f

39 files changed

+86
-76
lines changed

.openpublishing.redirection.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -976,7 +976,7 @@
976976
"redirect_document_id": false
977977
},
978978
{
979-
"source_path": "aspnetcore/migration/inc/http-modules.md",
979+
"source_path": "aspnetcore/migration/fx-to-core/inc/http-modules.md",
980980
"redirect_url": "/aspnet/core/migration/fx-to-core/areas/http-modules",
981981
"redirect_document_id": false
982982
},

aspnetcore/migration/70-80.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -483,7 +483,7 @@ Updated configuration guidance appears in the following locations:
483483

484484
### Drop Blazor Server with Yarp routing workaround
485485

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.
487487

488488
### Migrate `CascadingValue` components in layout components
489489

aspnetcore/migration/inc/abtesting.md renamed to aspnetcore/migration/fx-to-core/inc/abtesting.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ ms.author: tasou
66
monikerRange: '>= aspnetcore-6.0'
77
ms.date: 3/1/2023
88
ms.topic: article
9-
uid: migration/inc/ab-testing
9+
uid: migration/fx-to-core/inc/ab-testing
1010
---
1111

1212
# A/B Testing endpoints during migration
1313

1414
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.
1515

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.
1717

1818
## Conditional endpoint selection
1919

aspnetcore/migration/inc/blazor.md renamed to aspnetcore/migration/fx-to-core/inc/blazor.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ monikerRange: '>= aspnetcore-6.0 < aspnetcore-8.0'
66
ms.author: tasou
77
ms.custom: "mvc"
88
ms.date: 03/01/2023
9-
uid: migration/inc/blazor
9+
uid: migration/fx-to-core/inc/blazor
1010
---
1111
# Enable ASP.NET Core Blazor Server support with Yarp in incremental migration
1212

File renamed without changes.

aspnetcore/migration/inc/overview.md renamed to aspnetcore/migration/fx-to-core/inc/overview.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ ms.author: riande
66
monikerRange: '>= aspnetcore-6.0'
77
ms.date: 11/9/2022
88
ms.topic: article
9-
uid: migration/inc/overview
9+
uid: migration/fx-to-core/inc/overview
1010
---
1111

1212
<!-- see mermaid.txt to change diagrams -->
@@ -19,24 +19,24 @@ One of the larger challenges is the pervasive use of <xref:System.Web.HttpContex
1919

2020
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.
2121

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).
2323

2424
## App migration to ASP.NET Core
2525

2626
Before starting the migration, the app targets ASP.NET Framework and runs on Windows with its supporting libraries:
2727

28-
![Before starting the migration](~/migration/inc/overview/static/1.png)
28+
![Before starting the migration](~/migration/fx-to-core/inc/overview/static/1.png)
2929

3030
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:
3131

32-
![start updating routes](~/migration/inc/overview/static/nop.png)
32+
![start updating routes](~/migration/fx-to-core/inc/overview/static/nop.png)
3333

3434
To migrate business logic that relies on `HttpContext`, the libraries need to be built with `Microsoft.AspNetCore.SystemWebAdapters`. Building the libraries with `SystemWebAdapters` allows:
3535

3636
* The libraries to be built against .NET Framework, .NET Core, or .NET Standard 2.0.
3737
* Ensures that the libraries are using APIs that are available on both ASP.NET Framework and ASP.NET Core.
3838

39-
![Microsoft.AspNetCore.SystemWebAdapters](~/migration/inc/overview/static/sys_adapt.png)
39+
![Microsoft.AspNetCore.SystemWebAdapters](~/migration/fx-to-core/inc/overview/static/sys_adapt.png)
4040

4141
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.
4242

@@ -48,14 +48,14 @@ During the migration process, additional services and infrastructure are identif
4848

4949
Eventually, the ASP.NET Core app handles more of the routes than the .NET Framework app:
5050

51-
![the ASP.NET Core app handles more of the routes](~/migration/inc/overview/static/sys_adapt.png)
51+
![the ASP.NET Core app handles more of the routes](~/migration/fx-to-core/inc/overview/static/sys_adapt.png)
5252

5353
Once the ASP.NET Framework app is no longer needed and deleted:
5454

5555
* The app is running on the ASP.NET Core app stack, but is still using the adapters.
5656
* The remaining migration work is removing the use of adapters.
5757

58-
![final pic](~/migration/inc/overview/static/final.png)
58+
![final pic](~/migration/fx-to-core/inc/overview/static/final.png)
5959

6060
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/).
6161

@@ -68,12 +68,12 @@ The `Microsoft.AspNetCore.SystemWebAdapters` namespace is a collection of runtim
6868
* `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.
6969
* `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.
7070

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).
7272

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).
7474

7575
## Additional Resources
7676

7777
* [Example migration of eShop to ASP.NET Core](/dotnet/architecture/porting-existing-aspnet-apps/example-migration-eshop)
7878
* [Video:Tooling for Incremental ASP.NET Core Migrations](https://www.youtube.com/watch?v=P96l0pDNVpM)
79-
* <xref:migration/inc/unit-testing>
79+
* <xref:migration/fx-to-core/inc/unit-testing>

0 commit comments

Comments
 (0)