다음을 통해 공유

빠른 시작: GitHub Copilot 현대화 에이전트 설치 및 사용

이 빠른 시작에서는 GitHub Copilot 현대화 에이전트를 설치하고 이를 사용하여 샘플 애플리케이션을 현대화하는 방법을 안내합니다.

사전 요구 사항

  • GitHub Copilot 구독: 무료, Pro, Pro+, Business 또는 Enterprise 요금제입니다. Copilot 플랜을 참조하세요.
  • GitHub CLI: 오어보브 이상 인증 gh 을 위해 GitHub CLI(v2.45.0)를 설치합니다. gh 설치를 참조하세요.

플랫폼 요구 사항

  • Windows: x64 또는 ARM64.
  • Linux: 2.27 이상인 x64 또는 ARM64 glibc (Ubuntu 18.04 이상, Debian 10 이상, Fedora 29 이상, Azure Linux 2.0 이상).
  • macOS: Apple Silicon 또는 Intel.

현대화 에이전트 설치

다음 명령을 사용하여 현대화 에이전트를 설치하거나 최신 버전으로 업데이트합니다.

다음 옵션 중 하나를 사용합니다.

옵션 1 - Winget(권장):

winget install GitHub.Copilot.modernization.agent

프롬프트 없이 자동 설치의 경우:

winget install GitHub.Copilot.modernization.agent --silent

옵션 2 - PowerShell 한 줄:

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

옵션 3 - MSI 설치 관리자:

GitHub 릴리스 페이지에서 최신 MSI를 다운로드하고 실행합니다.

메모

설치 후 PATH에서 명령을 사용할 수 있도록 새 터미널 modernize 을 엽니다. 이러한 명령은 초기 설치 및 최신 버전으로 업데이트하는 데 모두 작동합니다. 전용 버전 업데이트 명령은 이후 릴리스에서 사용할 수 있습니다.

설치를 확인합니다.

modernize --version

샘플 애플리케이션 가져오기

이 빠른 시작에서는 샘플 애플리케이션을 사용합니다. Java 또는 .NET을 선택합니다.

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

대화형 모드 사용

가장 쉬운 시작 방법은 대화형 모드를 사용하는 것입니다. 먼저 GitHub CLI를 사용하여 인증합니다.

gh auth login

그런 다음, 현대화 에이전트를 실행합니다.

modernize

주 메뉴가 나타납니다.

○ How would you like to modernize your Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

1단계: 애플리케이션 평가

  1. 1을 선택합니다. 애플리케이션을 평가합니다.
  2. 프롬프트에 따라 평가 옵션을 구성하거나 Enter 키를 눌러 기본값을 사용합니다.
  3. 선택 항목을 검토하고 Enter 키를 눌러 평가를 시작합니다.
  4. 평가가 완료되기를 기다립니다.

평가 결과는 프로젝트 디렉터리에 저장 .github\modernize\assessment\ 됩니다. 에이전트는 코드, 종속성 및 구성을 분석하여 다음을 식별합니다.

  • 오래된 프레임워크 버전
  • 사용되지 않는 API
  • 클라우드 호환성 문제
  • 마이그레이션 기회

2단계: 현대화 계획 만들기

평가가 완료되면 에이전트는 식별된 문제에 따라 현대화 계획을 만들라는 메시지를 표시합니다.

○ How would you like to continue?

  > 1. Create modernization plan
       Generate a plan.md file according to the identified issues
    2. Return to main menu
  1. 1을 선택합니다. 현대화 계획을 만듭니다.
  2. 계획 이름을 입력하거나 Enter 키를 눌러 기본 이름을 사용합니다.
  3. 프롬프트로 현대화 목표를 입력합니다. 기본적으로 프롬프트는 References the assessment summary and creates plan 평가 결과에 따라 계획을 만드는 것입니다. 예를 들어 다른 마이그레이션 요청으로 바꿀 수 있습니다.
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Enter 키를 눌러 계획을 생성합니다.

에이전트는 코드베이스를 분석하고 다음을 생성합니다.

  • 계획 파일 (.github/modernize/{plan-name}/plan.md): 자세한 전략 및 접근 방식
  • 작업 목록 (.github/modernize/{plan-name}/tasks.json): 실행 단계의 분석입니다.

팁 (조언)

수동으로 편집 plan.md 하여 설명을 추가하거나 세부 정보를 조정할 수 있습니다. 계획을 실행하기 전에 작업을 수정, 순서 변경, 추가 또는 제거하도록 업데이트 tasks.json 할 수도 있습니다.

3단계: 현대화 계획 실행

계획을 확인한 후 계획을 실행할지 확인합니다.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. 1을 선택합니다. 현대화 계획을 실행합니다.
  2. Enter 키를 눌러 계획을 실행합니다.
  3. 에이전트가 변경 내용을 적용할 때 진행률을 모니터링합니다.

에이전트는 각 작업을 순서대로 실행합니다.

  • 계획에 따라 코드를 변경합니다.
  • 각 변경 후 빌드의 유효성을 검사합니다.
  • CVE를 검색하고 해결합니다.
  • 변경 내용을 커밋합니다.

4단계: 결과 검토

실행이 완료되면 에이전트가 병합하기 전에 수행한 모든 변경 내용을 검토할 수 있습니다.

  1. 변경 사항 검토: 현재 브랜치의 수정 내용을 확인합니다.

    git status
git diff main

  2. 끌어오기 요청 만들기: 변경 내용에 만족하는 경우 팀 검토를 위한 PR을 만듭니다.

    gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"

다음 단계

피드백 제공하기

우리는 당신의 입력을 소중히! 현대화 에이전트에 대한 피드백이 있는 경우 github-copilot-appmod 리포지토리에서 문제를 만들 거나 GitHub Copilot 현대화 피드백 양식을 사용합니다.

  • Last updated on