다음을 통해 공유

빠른 시작: .NET용 GitHub Copilot 앱 현대화를 사용하여 .NET 프로젝트 평가 및 마이그레이션

이 빠른 시작에서는 .NET용 GitHub Copilot 앱 현대화를 사용하여 .NET 프로젝트를 평가하고 마이그레이션합니다. 다음 작업을 완료합니다.

  • 샘플 프로젝트 평가(Contoso University)
  • 마이그레이션 프로세스 시작

Prerequisites

앱 준비 상태 평가

.NET 평가를 위한 GitHub Copilot 앱 현대화는 앱 준비 문제를 찾고, 영향을 알아보고, 권장되는 마이그레이션 작업을 확인하는 데 도움이 됩니다. 각 마이그레이션 작업에는 Azure 리소스를 설정하고, 구성을 추가하고, 코드를 변경하는 참조가 포함됩니다. 마이그레이션을 시작하려면 다음 단계를 수행합니다.

  1. .NET 마이그레이션 코파일럿 샘플 리포지토리를 컴퓨터에 복제합니다.

  2. Visual Studio의 샘플 리포지토리에서 Contoso University 솔루션을 엽니다.

  3. 솔루션 탐색기에서 솔루션 노드를 마우스 오른쪽 단추로 클릭하고 현대화를 선택합니다.

    상황에 맞는 메뉴의 현대화 옵션을 보여 주는 스크린샷.

  4. GitHub Copilot 채팅 창이 시작 메시지 및 미리 정의된 옵션과 함께 열립니다. 사용 가능한 선택 항목에서 Azure로 마이그레이션 을 선택하고 Copilot로 보냅니다.

    마이그레이션 옵션이 포함된 환영 메시지를 보여 주는 스크린샷.

    Tip

    3단계와 4단계 대신 GitHub Copilot 채팅을 직접 열고 전송 @Modernize Migrate to Azure 하여 평가 및 마이그레이션 흐름을 시작할 수 있습니다.

  5. 새 코필로트 채팅 세션이 열리고 환영 메시지가 표시됩니다. 평가는 자동으로 시작되고 마이그레이션 준비 상태를 위해 프로젝트를 분석합니다.

    상태 표시기가 있는 진행 중인 평가를 보여 주는 스크린샷

  6. 평가가 완료되면 포괄적인 평가 보고서 UI 페이지와 채팅 창에 마이그레이션 작업 목록이 표시됩니다.

    자세한 결과가 포함된 생성된 평가 보고서를 보여 주는 스크린샷.

앱 마이그레이션

.NET용 GitHub Copilot 앱 현대화에는 일반적인 마이그레이션 시나리오에 대한 미리 정의된 작업이 포함되며 Microsoft의 모범 사례를 따릅니다.

마이그레이션 작업 시작

다음 방법 중 하나로 마이그레이션 작업을 시작합니다.

옵션 1. 평가 보고서에서 실행

이전 단계의 평가 보고서에서 작업 실행 단추를 선택하여 마이그레이션 작업을 시작합니다.

옵션 2. Copilot 채팅에 보내기

채팅에서 마이그레이션 작업 번호(예: 1.1) 또는 해당 이름을 보냅니다.

마이그레이션 작업을 시작하기 위해 Copilot 채팅에서 메시지를 보내는 스크린샷

계획 및 진행률 추적기 생성

  • 마이그레이션을 시작하면 GitHub Copilot는 미리 정의된 프롬프트를 사용하여 에이전트 모드에서 "앱 현대화: "에서 <source technology><target technology>마이그레이션"이라는 세션을 시작합니다.
  • 이 도구는 .appmod/.migration 폴더에 두 개의 파일을 만듭니다.
    • plan.md: 전체 마이그레이션 계획입니다.
    • progress.md: GitHub Copilot가 작업을 완료할 때 업데이트하는 진행률 추적기입니다.
  • 계속하기 전에 이러한 파일을 편집하여 마이그레이션을 사용자 지정합니다.

코드 수정 시작

  • 계획 및 진행률 추적기를 만족하는 경우 다음과 같은 마이그레이션 프로세스를 시작하라는 프롬프트를 입력합니다.

    The plan and progress tracker look good to me. Go ahead with the migration.

  • GitHub Copilot는 마이그레이션 프로세스를 시작하고 MCP(모델 컨텍스트 프로토콜) 서버에서 기술 자료 도구를 사용하도록 승인을 요청할 수 있습니다. 메시지가 표시되면 사용 권한을 부여합니다.

  • Copilot는 계획 및 진행률 추적기를 따라 다음을 수행합니다.

    • 종속성을 관리합니다.
    • 구성 변경 내용을 적용합니다.
    • 코드를 변경합니다.
    • 솔루션을 빌드하고, 모든 컴파일 및 구성 오류를 수정하고, 성공적인 빌드를 보장합니다.
    • 보안 취약성을 수정합니다.

기본 채팅 메시지

.NET용 GitHub Copilot 앱 현대화는 워크플로를 간소화하기 위한 기본 채팅 메시지 옵션을 제공합니다.

Copilot 채팅의 기본 채팅 메시지 옵션을 보여 주는 스크린샷.

미리 정의된 옵션 중 하나를 선택하고 채팅에서 보냅니다.

  • 현대화 평가 실행: 마이그레이션 준비 문제 및 Azure 호환성 문제를 식별하기 위해 애플리케이션에 대한 새 평가를 시작합니다.
  • 평가 보고서 보기: 이전 평가 보고서를 열고 결과에 따라 마이그레이션 작업의 요약을 표시합니다. 이전 평가가 없는 경우 먼저 새 평가를 실행합니다.
  • 상위 마이그레이션 작업 찾아보기: 특정 평가 결과에 관계없이 권장되는 마이그레이션 작업 및 일반적인 현대화 시나리오를 보여 줍니다.

Tip

이러한 기본 메시지를 사용하면 사용자 지정 프롬프트를 입력하지 않고도 일반적인 워크플로를 빠르게 탐색할 수 있습니다. 특정 질문이나 요구 사항에 대해 코필로트와 상호 작용하기 위해 사용자 고유의 메시지를 입력할 수도 있습니다.

다음 단계

Prerequisites

앱 준비 상태 평가

.NET 평가를 위한 GitHub Copilot 앱 현대화는 앱 준비 문제를 찾고, 영향을 알아보고, 권장되는 마이그레이션 작업을 확인하는 데 도움이 됩니다. 각 마이그레이션 작업에는 Azure 리소스를 설정하고, 구성을 추가하고, 코드를 변경하는 참조가 포함됩니다. 마이그레이션을 시작하려면 다음 단계를 수행합니다.

  1. .NET 마이그레이션 코파일럿 샘플 리포지토리를 컴퓨터에 복제합니다.

  2. Visual Studio Code의 샘플 리포지토리에서 Contoso University 솔루션을 엽니다.

  3. GitHub Copilot 앱 현대화 확장을 엽니다.

  4. 빠른 시작 섹션에서 평가 시작을 선택합니다. 평가 보고서 페이지가 열립니다.

  5. 페이지의 오른쪽 위 모서리에서 평가 실행을 선택합니다.

    마이그레이션 작업을 시작하기 위한 작업 섹션의 작업 실행 스크린샷

  6. 평가는 자동으로 시작되고 마이그레이션 준비 상태를 위해 프로젝트를 분석합니다.

    마이그레이션 준비 상태를 위해 프로젝트를 분석하는 작업 실행 스크린샷.

  7. 평가가 완료되면 포괄적인 평가 보고서 UI 페이지와 채팅 창에 마이그레이션 작업 목록이 표시됩니다.

    평가 보고서 UI 페이지 및 마이그레이션 작업 목록 실행 스크린샷

앱 마이그레이션

.NET용 GitHub Copilot 앱 현대화에는 일반적인 마이그레이션 시나리오에 대한 미리 정의된 작업이 포함되며 Microsoft의 모범 사례를 따릅니다.

채팅 기반 마이그레이션은 마이그레이션을 시작하는 데 권장되는 방법입니다. AppModernization-DotNet 사용자 지정 에이전트는 애플리케이션 현대화 작업에 최적화되어 있습니다. 이 에이전트를 사용하면 간단한 자연어 프롬프트를 사용하여 복잡한 마이그레이션 시나리오를 수행할 수 있습니다.

다음 단계를 완료하여 사용자 지정 에이전트를 선택하고 마이그레이션을 시작합니다.

  1. Visual Studio Code에서 .NET 프로젝트가 열려 있는지 확인합니다.

  2. 활동 모음에서 채팅 아이콘을 선택하여 코필로트 채팅 창을 엽니다.

  3. 채팅 창에서 채팅 입력 상자 맨 위에 있는 에이전트 선택기 드롭다운 메뉴를 찾습니다. 목록에서 AppModernization-DotNet 을 선택합니다. 이 사용자 지정 에이전트는 .NET 애플리케이션 현대화 및 마이그레이션 시나리오용으로 설계되었습니다.

    채팅 창에서 .NET 사용자 지정 에이전트를 선택하는 스크린샷

  4. 채팅 창에서 형식 migrate from <source> to <target> 을 사용하여 프롬프트를 입력합니다. 다음은 그 예입니다.

    migrate from rabbitmq to Azure service bus

  5. 에이전트는 코드를 분석하고, 마이그레이션 계획을 만들고, 코드를 변경하고, 유효성 검사를 실행하고, 요약을 생성합니다. 각 단계를 계속 진행하려면 [계속 ]을 선택하고 계속 을 선택하여 변경 내용을 적용합니다.

UI에서 마이그레이션 작업 시작

UI에서 마이그레이션 작업을 시작할 수도 있습니다.

옵션 1. 평가 보고서에서 실행

이전 단계의 평가 보고서에서 작업 실행 단추를 선택하여 마이그레이션 작업을 시작합니다.

옵션 2. 미리 정의된 작업 적용

TASKS - .NET 섹션에서 특정 작업을 실행합니다. 예를 들어 데이터베이스 작업에서 Azure Database for PostgreSQL로 데이터베이스 마이그레이션 태스크는 Azure Database for PostgreSQL을 사용하도록 데이터베이스 연결, 구성, 종속성 및 데이터 액세스 코드를 업데이트합니다.

미리 정의된 특정 작업을 실행하는 스크린샷

계획 및 진행률 추적기 생성

마이그레이션을 시작하면 GitHub Copilot가 에이전트 모드에서 세션을 시작합니다.

이 도구는 .github/appmod/code-migration/<target-branch-name> 폴더에 두 개의 파일을 만듭니다.

  • plan.md: 전체 마이그레이션 계획입니다.
  • progress.md: GitHub Copilot가 작업을 완료할 때 업데이트하는 진행률 추적기입니다.

계속하기 전에 이러한 파일을 편집하여 마이그레이션을 사용자 지정합니다.

마이그레이션 작업 중 계획 생성 스크린샷

코드 수정 시작

계획 및 진행률 추적기가 만족되면 계속 입력하여 마이그레이션을 시작합니다.

GitHub Copilot는 마이그레이션 프로세스를 시작하고 MCP(모델 컨텍스트 프로토콜) 서버에서 기술 자료 도구를 사용하도록 승인을 요청할 수 있습니다. 메시지가 표시되면 사용 권한을 부여합니다.

Copilot는 계획 및 진행률 추적기를 따라 다음을 수행합니다.

  • 종속성을 관리합니다.
  • 구성 변경 내용을 적용합니다.
  • 코드를 변경합니다.
  • 프로젝트를 빌드하고, 모든 컴파일 및 구성 오류를 수정하고, 성공적인 빌드를 보장합니다.
  • 보안 취약성을 수정합니다.

계속 을 반복적으로 선택하거나 입력하여 도구 또는 명령의 사용을 확인하고 코드 변경이 완료되기를 기다립니다.

비고

Visual Studio Code에서 앱 현대화는 Azure로 마이그레이션하도록 .NET 코드를 업데이트할 때 최상의 결과를 위해 기본적으로 Claude Sonnet 4.5의 사용자 지정 에이전트를 사용합니다 AppModernization-DotNet . Sonnet 4.5를 사용할 수 없는 경우 'auto' 모델로 돌아갑니다. 에이전트 메뉴에서 사용자 지정 에이전트 구성을 선택하여 '모델' 설정을 수정하도록 사용자 지정 에이전트를 구성할 수 있습니다. 또는 채팅 창에서 언어 모델 선택기를 사용하여 현재 채팅 세션에 대한 모델을 전환할 수 있습니다.

유효성 검사 반복

코드 변경이 완료되면 마이그레이션 도구가 유효성 검사를 시작하고 반복 루프를 수정합니다. 이 루프에는 다음 5단계가 포함됩니다.

  1. 현재 종속성에서 CVE(일반 취약성 및 노출)를 검색하고 수정합니다.
  2. 프로젝트를 빌드하고 빌드 오류를 해결합니다.
  3. 기능 일관성을 위해 코드를 분석합니다.
  4. 단위 테스트 실패에 대한 프로젝트를 분석하고 테스트가 통과될 때까지 문제를 해결하는 계획을 자동으로 생성합니다.
  5. 초기 코드 마이그레이션에서 누락된 마이그레이션 항목에 대한 코드를 분석하고 수정합니다.

모든 프로세스가 완료되면 마이그레이션 도구에서 요약을 생성합니다. 코드 변경 내용을 검토하고 유지를 선택하여 확인합니다.

다음 단계

  • Last updated on