GitHub Copilot 현대화란?

GitHub Copilot 현대화는 프로젝트를 최신 버전의 .NET 업그레이드하고 .NET 애플리케이션을 빠르고 자신 있게 Azure 마이그레이션하는 데 도움이 되는 GitHub Copilot 에이전트입니다. Visual Studio, Visual Studio Code, GitHub Copilot CLI 및 GitHub.com 평가, 솔루션 권장 사항, 코드 수정 및 유효성 검사를 안내합니다.

이 에이전트를 사용하여 다음을 수행합니다.

  • 최신 버전의 .NET 업그레이드합니다.
  • 기술을 마이그레이션하고 Azure 배포합니다.
  • 특히 .NET Framework에서 업그레이드할 때 .NET 앱을 현대화합니다.
  • 애플리케이션의 코드, 구성 및 종속성을 평가합니다.
  • 올바른 Azure 리소스를 계획하고 설정합니다.
  • 문제를 해결하고 클라우드 마이그레이션에 대한 모범 사례를 적용합니다.
  • 앱이 성공적으로 빌드되고 테스트되었는지 확인합니다.

시나리오

에이전트는 여러 엔드 투 엔드 현대화 작업 흐름을 시나리오라고 제공 합니다. 각 시나리오는 특정 유형의 업그레이드 또는 마이그레이션을 안내하는 관리되는 워크플로입니다.

시나리오 설명 예제 프롬프트
.NET 버전 업그레이드 이전 .NET 버전에서 .NET 8, 9, 10 이상으로 업그레이드합니다. "내 솔루션을 .NET 10"
SDK 스타일 변환 레거시 프로젝트 형식을 SDK 스타일로 변환합니다. "SDK 스타일로 변환"
Newtonsoft.Json 업그레이드 Newtonsoft.Json을 System.Text.Json으로 대체합니다. "Newtonsoft.Json에서 업그레이드"
SqlClient 업그레이드 System.Data.SqlClient에서 Microsoft.Data.SqlClient로 업그레이드합니다. "SqlClient 업데이트"
Azure Functions 업그레이드 Azure Functions in-process에서 격리된 작업자 모델로 업그레이드합니다. "내 Azure Functions 업그레이드"
에이전트에 의미 체계 커널 의미 체계 커널 에이전트를 Microsoft Agent Framework로 업그레이드합니다. "내 SK 에이전트를 업그레이드"

모든 시나리오 및 30개 이상의 기본 제공 업그레이드 기술에 대한 전체 참조는 시나리오 및 기술 참조를 참조하세요.

피드백 제공

Microsoft 피드백의 가치를 높이고 이를 사용하여 에이전트를 개선합니다. 다음 옵션 중 하나를 사용하여 피드백을 남겨 둡니다.

필수 조건

에이전트를 사용하기 전에 개발 환경에서 GitHub Copilot 현대화를 설정합니다. 설치 단계는 GitHub Copilot 현대화 설정을 참조하세요.

.NET 프로젝트 업그레이드

현대화 에이전트는 다음 유형의 C# 및 Visual Basic 프로젝트 업그레이드를 지원합니다.

  • ASP.NET Core(및 MVC, Razor Pages 및 Web API와 같은 관련 기술)
  • Blazor
  • Azure Functions
  • Windows Presentation Foundation(WPF)
  • Windows Forms
  • WinUI
  • .NET MAUI 및 Xamarin
  • 클래스 라이브러리
  • 콘솔 응용 프로그램
  • 테스트 프로젝트(MSTest, NUnit 및 xUnit)

업그레이드를 시작하려면 GitHub Copilot 현대화를 사용하여 .NET 앱 업그레이드 참조하세요.

지원되는 업그레이드 경로

에이전트는 다음 업그레이드 경로를 지원합니다.

출처 목표/타겟
.NET Framework(모든 버전) .NET 8 이상
.NET Core 1.x-3.x .NET 8 이상
.NET 5 이상 .NET 8 이상

.NET 프로젝트를 Azure 마이그레이션

현대화 에이전트는 자동화된 분석, AI 기반 코드 수정, 빌드 및 취약성 검사 및 배포 자동화를 통해 Azure 마이그레이션을 간소화합니다.

  • 분석 및 지능형 권장 사항.

    Azure 마이그레이션에 대한 애플리케이션의 준비 상태를 평가하고 종속성 및 식별된 문제에 따라 맞춤형 지침을 받습니다.

  • AI 기반 코드 수정.

    미리 정의된 모범 사례 코드 패턴을 적용하여 최소한의 수동 작업으로 현대화를 가속화합니다.

  • 자동 빌드 및 CVE 취약점 해결.

    앱을 빌드하고 컴파일 오류 및 취약성을 해결하여 개발을 간소화합니다.

  • 원활한 배포.

    개발에서 프로덕션으로 코드를 더 빠르게 가져와서 Azure 배포합니다.

마이그레이션을 위한 미리 정의된 작업

.NET 대한 GitHub Copilot 현대화는 업계 모범 사례를 캡처하고 일반적인 마이그레이션 시나리오를 다루는 미리 정의된 작업을 제공합니다.

  • Azure SQL DB, Azure SQL MI 및 Azure PostgreSQL

    온-프레미스 또는 레거시 데이터베이스(예: DB2, Oracle DB 또는 SQL Server)에서 Azure SQL DB, Azure SQL Managed Instance 또는 Azure PostgreSQL로 마이그레이션하여 데이터 계층을 현대화합니다. 보안 관리 ID 인증을 사용합니다.

  • Azure 파일 스토리지로 마이그레이션하십시오

    확장 가능한 클라우드 기반 파일 관리를 위해 파일 I/O 작업을 로컬 파일 시스템에서 Azure File Storage로 이동합니다.

  • Azure Blob Storage로 마이그레이션합니다

    온프레미스 또는 크로스 클라우드 개체 스토리지와 로컬 파일 시스템 파일 I/O를 구조화되지 않은 데이터를 위해 Azure Blob Storage로 대체합니다.

  • Microsoft Entra ID로 마이그레이션

    최신 ID 관리를 위해 인증 및 권한 부여를 Windows Active Directory Microsoft Entra ID(이전 Azure AD)로 전환합니다.

  • 관리 ID 및 Azure Key Vault을 사용하여 보안 자격 증명으로 마이그레이션합니다

    구성 또는 코드에서 일반 텍스트 자격 증명을 보안 관리 ID 및 Azure Key Vault를 사용하여 대체하여 비밀을 관리합니다.

  • Azure Service Bus로 마이그레이션

    레거시 또는 타사 메시지 큐(예: MSMQ 또는 RabbitMQ) 또는 Amazon SQS(AWS Simple Queue Service)에서 신뢰할 수 있는 클라우드 기반 메시징을 위해 Azure Service Bus로 이동하십시오.

  • Azure Communication Service 전자 메일로 이동

    확장 가능하고 안전한 전자 메일 배달을 위해 직접 SMTP 전자 메일을 Azure Communication Service로 대체합니다.

  • Apache Kafka용 Confluent Cloud/Azure 이벤트 허브로 이동합니다

    Confluent Cloud 또는 Azure Event Hubs 사용하여 로컬 또는 온-프레미스 Kafka에서 관리되는 이벤트 스트리밍으로 전환합니다.

  • Azure에서 OpenTelemetry로 마이그레이션하기

    log4net, Serilog 및 Windows 이벤트 로그와 같은 로컬 로깅 프레임워크에서 Azure OpenTelemetry로 전환합니다.

  • 관리 ID를 사용하여 Azure Cache for Redis로 마이그레이션합니다

    메모리 내 또는 로컬 Redis 캐시 구현을 고가용성, 확장성 및 엔터프라이즈급 보안을 위해 Azure Cache for Redis 대체합니다.

작동 방식

업그레이드 또는 마이그레이션 프로세스를 시작하려면 다음을 참조하세요.

  1. 개발 환경에서 .NET 프로젝트 또는 솔루션을 엽니다.

  2. 다음 방법 중 하나를 사용하여 에이전트를 시작합니다.

    • Visual Studio: 솔루션 탐색기 솔루션 또는 프로젝트를 마우스 오른쪽 단추로 클릭하고 Modernize 선택합니다. 또는 GitHub Copilot Chat 창을 열고 @Modernize 입력합니다.
    • Visual Studio Code: GitHub Copilot Chat 패널을 열고 @modernize-dotnet 입력합니다.
    • GitHub Copilot CLI: 업그레이드 또는 마이그레이션 요청 뒤에 @modernize-dotnet 입력합니다.
    • GitHub.com: 리포지토리에서 modernize-dotnet 코딩 에이전트를 사용합니다.

  3. 에이전트에 업그레이드 또는 마이그레이션할 내용을 알릴 수 있습니다.

현대화 에이전트에 앱을 업그레이드하도록 요청하면 Copilot 먼저 Git 리포지토리에서 작업하는 경우 새 분기를 만들라는 메시지를 표시합니다. 그런 다음 Copilot 프로젝트를 평가하고 3단계 워크플로를 실행합니다. 각 단계에서는 리포지토리 아래에 .github/upgrades/{scenarioId} Markdown 파일을 생성하므로 계속하기 전에 다음에 나오는 항목을 검토할 수 있습니다. 이전 시도에서 .github/upgrades/{scenarioId} 이미 있는 경우 Copilot 계속하거나 새로 시작할지 묻습니다.

Copilot 먼저 프로젝트 구조, 종속성 및 코드 패턴을 검사하여 포괄적인 평가를 작성합니다. 파일은 assessment.md 변경 사항으로 인한 비호환성, API 호환성 문제, 더 이상 사용되지 않는 패턴 및 업그레이드 범위를 나열합니다.

평가 후 Copilot 다음 세 단계를 실행합니다.

  1. Assessment: Copilot 프로젝트 구조, 종속성 및 코드 패턴을 검사한 다음 업그레이드 전략(상향식, 하향식 또는 한 번에 모두), 프로젝트 업그레이드 방법, 기술 현대화 옵션 및 호환성 처리와 같은 검토에 대한 전략 결정을 제공합니다. Copilot은 확인된 결정을 upgrade-options.md에 저장합니다.

  2. Planning: Copilot은 평가 및 확인된 옵션을 기반으로 이를 자세한 사양으로 변환합니다. 이 파일은 plan.md 업그레이드 전략, 리팩터링 방법, 종속성 경로 및 위험 완화를 문서화합니다.

  3. Execution: Copilot tasks.md 유효성 검사 조건을 사용하여 계획을 순차적인 구체적인 작업으로 나눕니다. 각 태스크는 단일 변경 내용과 Copilot 성공 확인 방법을 설명합니다.

앞으로 이동하기 전에 업그레이드 단계를 조정하거나 컨텍스트를 추가하려면 Markdown 파일을 .github/upgrades/{scenarioId} 편집합니다.

업그레이드 전략

평가 단계에서 에이전트는 솔루션을 평가하고 다음 전략 중 하나를 권장합니다.

전략 적합한 대상 설명
상향식 심층 종속성 그래프를 사용하는 대규모 솔루션 리프 프로젝트를 먼저 업그레이드한 다음 상위 단계로 진행합니다.
하향식 주 애플리케이션에 대한 빠른 피드백 먼저 애플리케이션 프로젝트를 업그레이드한 다음 종속성을 수정합니다.
한 번에 모두 작고 간단한 솔루션 모든 프로젝트를 한 번의 패스로 업그레이드합니다.

흐름 모드

에이전트는 사용자의 입력에 따라 일시 중지되는 정도를 제어하는 두 가지 제어 모드를 지원합니다.

  • 자동화: 에이전트는 모든 단계를 거치며 중간에 멈추지 않고, 실제 장애물에서만 중지됩니다. 숙련된 사용자 및 간단한 업그레이드에 가장 적합합니다.
  • 가이드: 에이전트는 각 단계 경계에서 일시 중지되므로 계속하기 전에 평가, 계획 및 작업을 검토할 수 있습니다. 처음 사용자 및 복잡한 솔루션에 가장 적합합니다.

언제든지 "일시 중지"(안내 모드로 전환) 또는 "계속"(자동 모드로 전환)을 말하여 모드 간을 전환합니다.

상태 관리

에이전트는 모든 업그레이드 상태를 저장합니다 .github/upgrades/{scenarioId}/. 폴더에는 다음이 포함됩니다.

파일 Purpose
assessment.md 솔루션 분석
upgrade-options.md 확인된 업그레이드 결정
plan.md 정렬된 작업 계획
tasks.md 라이브 진행률 대시보드
scenario-instructions.md 기본 설정, 의사 결정 및 사용자 지정 지침을 포함한 에이전트의 영구 메모리
execution-log.md 모든 변경 내용에 대한 자세한 감사 내역
tasks/{taskId}/task.md 작업별 범위 및 컨텍스트
tasks/{taskId}/progress-details.md 작업별 실행 노트 및 결과

모든 상태가 이 폴더에 있으므로 IDE를 닫거나, 세션 간을 전환하거나, 개발 환경 간에 전환할 수 있습니다(예: VS Code에서 시작하여 Visual Studio 계속). 에이전트는 중단된 지점에서 다시 시작합니다.

팁 (조언)

.github/upgrades/ 폴더를 브랜치에 커밋합니다. 커밋된 상태는 백업 역할을 하며 팀 구성원이 업그레이드 진행 상황을 볼 수 있도록 합니다.

업그레이드 수행

각 단계가 완료되면 필요에 따라 생성된 파일을 검토 및 수정한 다음 Copilot 다음 단계로 계속 진행하도록 지시합니다.

Execution 단계에 도달하면 Copilot 업그레이드를 시작하도록 지시합니다. Copilot 문제가 발생하면 원인을 식별하고 수정을 적용하려고 시도합니다. Copilot 문제를 해결할 수 없는 경우 도움을 요청합니다. 개입할 때 Copilot 변경 내용을 학습하고 문제가 다시 발생하면 자동으로 적용하려고 시도합니다.

업그레이드 결과

Copilot 각 작업을 실행하면 tasks.md 파일을 .github/upgrades/{scenarioId} 모든 단계의 상태로 업데이트합니다. 이 파일을 검토하여 진행률을 모니터링합니다. Copilot 프로세스의 모든 부분에 대해 Git 커밋을 만들므로 변경 내용을 롤백하거나 변경 내용을 검토할 수 있습니다.

업그레이드가 완료되면 Copilot 채팅 응답에 다음 단계를 표시합니다.

테레메트리

이 도구는 프로젝트 형식, 업그레이드 의도 및 업그레이드 기간에 대한 데이터를 수집합니다. 개발 환경은 데이터를 수집하고 집계하며 사용자 식별 가능한 정보를 포함하지 않습니다. Microsoft 개인 정보 보호 정책에 대한 자세한 내용은 Visual Studio 고객 환경 개선 프로그램 참조하세요.

관련 콘텐츠

  • Last updated on