다음을 통해 공유

ASP.NET에서 ASP.NET Core로의 증분 업데이트

  • 아티클

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를 사용하고 있는지 확인합니다.

Microsoft.AspNetCore.SystemWebAdapters

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 Core 앱이 더 많은 경로를 처리하는

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 애플리케이션에서 사용하는 서비스에 대한 추상화를 제공하는 지원 패키지입니다.

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

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

추가 리소스