ASP.NET Core 업데이트에 대한 증분 ASP.NET

ASP.NET Framework에서 ASP.NET Core로 앱을 업데이트하는 것은 대부분의 프로덕션 앱에서 간단하지 않습니다. 이러한 앱은 새로운 기술을 사용할 수 있게 되면서 통합하는 경우가 많으며 종종 많은 레거시 의사 결정으로 구성됩니다. 이 문서에서는 ASP.NET Framework 앱을 ASP.NET Core로 업데이트하기 위한 도구에 대한 지침과 링크를 제공합니다.

더 큰 과제 중 하나는 코드 베이스 전체에서 HttpContext을 만연하게 사용하는 것입니다. 증분 접근 방식과 도구가 없는 경우 HttpContext 종속성을 제거하려면 대규모의 다시 쓰기가 필요합니다. dotnet/systemweb-adapters의 어댑터는 최소한의 변경만으로 ASP.NET Core에서 작동하는 방식으로 ASP.NET Framework 앱에서 사용되는 형식에 액세스할 수 있는 런타임 도우미 세트를 제공합니다.

완전한 마이그레이션은 사용되는 앱, 종속성 및 이식할 수 없는 API의 크기에 따라 상당한 노력이 필요할 수 있습니다. 업데이트 작업 중에도 프로덕션에 앱을 계속 배포하기 위해 가장 좋은 패턴은 스트랭글러 무화과 패턴입니다. 스트랭글러 무화과 패턴을 사용하면 특정 기능을 새 서비스로 대체하는 증분 방식으로 이전 시스템에서 지속적으로 개발할 수 있습니다. 이 문서에서는 ASP.NET Core로 업데이트되는 ASP.NET 앱에 스트랭글러 무화과 패턴을 적용하는 방법을 설명합니다.

이 개요 문서를 건너뛰고 시작하려면 시작을 참조하세요.

ASP.NET Core로 앱 마이그레이션

마이그레이션을 시작하기 전에 앱은 ASP.NET Framework를 대상으로 하며 지원 라이브러리를 사용하여 Windows에서 실행됩니다.

마이그레이션은 진입점이 되는 ASP.NET Core를 기반으로 하는 새 앱을 도입하여 시작합니다. 들어오는 요청은 요청을 처리하거나 YARP를 통해 .NET Framework 앱에 요청을 프록시하는 ASP.NET Core 앱으로 이동합니다. 처음에는 응답을 제공하는 대부분의 코드가 .NET Framework 앱에 있지만 ASP.NET Core 앱은 이제 경로 마이그레이션을 시작하도록 설정되었습니다.

HttpContext를 사용하는 비즈니스 논리를 마이그레이션하려면 Microsoft.AspNetCore.SystemWebAdapters를 사용하여 라이브러리를 빌드해야 합니다. SystemWebAdapters를 사용하여 라이브러리를 빌드하면 다음을 수행할 수 있습니다.

• .NET Framework, .NET Core 또는 .NET Standard 2.0에 대해 빌드할 라이브러리
• 라이브러리가 ASP.NET Framework와 ASP.NET Core 모두에서 사용할 수 있는 API를 사용하고 있는지 확인합니다.

YARP를 사용하는 ASP.NET Core 앱이 설정되면 ASP.NET Framework에서 ASP.NET Core로 경로를 업데이트할 수 있습니다. 예를 들어 WebAPI 또는 MVC 컨트롤러 작업 메서드, 처리기 또는 경로의 다른 구현이 있습니다. ASP.NET Core 앱에서 경로를 사용할 수 있는 경우 일치 과정을 거쳐 제공됩니다.

마이그레이션 프로세스 중에 .NET Core에서 실행되도록 업데이트해야 하는 추가 서비스 및 인프라가 식별됩니다. 유지 관리 기능 순서로 나열된 옵션은 다음과 같습니다.

1. 코드를 공유 라이브러리로 이동
2. 새 프로젝트의 코드 연결
3. 코드 복제

결국 ASP.NET Core 앱은 .NET Framework 앱보다 더 많은 경로를 처리합니다.

ASP.NET Framework 앱이 더 이상 필요하지 않고 삭제되면 다음을 수행합니다.

• 앱은 ASP.NET Core 앱 스택에서 실행 중이지만 어댑터를 계속 사용하고 있습니다.
• 나머지 마이그레이션 작업은 어댑터 사용을 제거하는 것입니다.

Visual Studio 확장 .NET 업그레이드 도우미 는 ASP.NET Framework 웹앱을 ASP.NET Core로 업그레이드하는 데 도움이 될 수 있습니다. 자세한 내용은 Visual Studio를 사용하여 .NET 프로젝트 업그레이드 블로그 게시물을 참조하세요.

System.Web 어댑터

Microsoft.AspNetCore.SystemWebAdapters 네임스페이스는 ASP.NET Core 이동하는 동안 System.Web에 대해 작성된 코드를 쉽게 사용할 수 있도록 하는 런타임 도우미의 컬렉션입니다. 이러한 어댑터의 기능을 사용하는 데 사용할 수 있는 몇 가지 패키지가 있습니다.

• Microsoft.AspNetCore.SystemWebAdapters: 이 패키지는 라이브러리를 지원하는 데 사용되며 HttpContext 및 기타와 같이 종속성을 사용할 수 있는 System.Web API를 제공합니다. 이 패키지는 .NET Standard 2.0, .NET 4.5 이상 및 .NET 6+를 대상으로 합니다.
• Microsoft.AspNetCore.SystemWebAdapters.FrameworkServices: 이 패키지는 .NET Framework만을 대상으로 하며 증분 마이그레이션을 제공해야 할 수 있는 ASP.NET Framework 애플리케이션에 서비스를 제공하는 것을 목적으로 합니다. 이는 일반적으로 라이브러리에서 참조되는 것이 아니라 애플리케이션 자체에서 참조될 것으로 예상됩니다.
• Microsoft.AspNetCore.SystemWebAdapters.CoreServices: 이 패키지는 .NET 6 이상만 대상으로 하며 ASP.NET Core 애플리케이션에 서비스를 제공하여 System.Web API의 동작을 구성하고 증분 마이그레이션에 대한 동작을 선택하도록 하기 위한 것입니다. 이는 일반적으로 라이브러리에서 참조되는 것이 아니라 애플리케이션 자체에서 참조될 것으로 예상됩니다.
• Microsoft.AspNetCore.SystemWebAdapters.Abstractions: 이 패키지는 세션 상태 serialization과 같은 ASP.NET Core 및 ASP.NET Framework 애플리케이션에서 사용하는 서비스에 대한 추상화를 제공하는 지원 패키지입니다.

유용한 시나리오의 예는 어댑터 문서를 참조하세요.

사용량에 대한 지침은 사용 지침 문서를 참조하세요.

추가 리소스

• eShop을 ASP.NET Core로 마이그레이션 예제
• 비디오:증분 ASP.NET Core 마이그레이션을 위한 도구
• 단위 테스트