Szybki start: instalowanie i używanie agenta modernizacji GitHub Copilot

Ten przewodnik szybkiego startu przeprowadzi Cię przez instalację agenta modernizacji GitHub Copilot i jego użycie do modernizacji przykładowej aplikacji.

Wymagania wstępne

  • Subskrypcja GitHub Copilot: Bezpłatna, Pro, Pro+, Business lub Enterprise. Zobacz Copilot plans.
  • GitHub interfejs wiersza polecenia: zainstaluj interfejs wiersza polecenia GitHub (gh) na potrzeby uwierzytelniania, wersja v2.45.0 lub nowsza. Zobacz Instalowanie gh.

Wymagania dotyczące platformy

  • Windows: x64 lub ARM64.
  • Linux: x64 lub ARM64 z glibc 2.27 lub nowszym (Ubuntu 18.04 lub nowszy, Debian 10 lub nowszy, Fedora 29 lub nowszy, Azure Linux 2.0 lub nowszy).
  • macOS: Apple Silicon lub Intel.

Instalowanie agenta modernizacji

Użyj następujących poleceń, aby zainstalować agenta modernizacji lub zaktualizować go do najnowszej wersji.

Użyj jednej z następujących opcji:

Opcja 1 — Winget (zalecane):

winget install GitHub.Copilot.modernization.agent

W przypadku instalacji dyskretnej bez monitów:

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

Opcja 2 — jednolinijkowe polecenie PowerShell:

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

Opcja 3 — Instalator MSI:

Pobierz i uruchom najnowszą wersję MSI ze strony GitHub releases.

Uwaga / Notatka

Po zakończeniu instalacji otwórz nowy terminal, aby komenda modernize była dostępna w ścieżce PATH. Te polecenia działają zarówno w przypadku początkowej instalacji, jak i aktualizacji do najnowszej wersji. Dedykowane polecenie aktualizacji wersji będzie dostępne w przyszłych wydaniach.

Zweryfikuj instalację:

modernize --version

Pobieranie przykładowej aplikacji

W tym szybkim starcie użyj przykładowej aplikacji. Wybierz Java lub .NET:

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

Korzystanie z trybu interaktywnego

Najprostszym sposobem rozpoczęcia pracy jest użycie trybu interaktywnego. Najpierw uwierzytelnij się przy użyciu interfejsu wiersza polecenia GitHub:

gh auth login

Następnie uruchom agenta modernizacji:

modernize

Zostanie wyświetlone menu główne:

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

Krok 1. Ocena aplikacji

  1. Wybierz pozycję Oceń z menu głównego.
  2. Wybierz sposób określania repozytoriów docelowych. Możesz wybrać Bieżący folder, aby użyć aktualnego katalogu, Ręczne wprowadzanie, aby wpisać lokalne ścieżki lub zdalne adresy URL Git, lub Z pliku konfiguracyjnego do załadowania repozytoriów z pliku JSON konfiguracji. Aby rozpocząć, wybierz pozycję Bieżący folder.
  3. Wybierz tryb wykonywania. Wybierz pozycję Oceń lokalnie , aby uruchomić ocenę na maszynie lub Deleguj do agentów w chmurze , aby umożliwić agentom w chmurze równoległe uruchamianie oceny. Na potrzeby tego przewodnika szybkiego startu wybierz pozycję Oceń lokalnie.
  4. Wybierz domeny oceny, takie jak Java upgrade i Cloud Readiness i naciśnij Enter.
  5. Przejrzyj opcje konfiguracji oceny, takie jak pokrycie analiz i środowisko uruchomieniowe docelowe. Naciśnij klawisz Enter w pozycji Kontynuuj , aby zaakceptować zalecane ustawienia domyślne lub dostosować poszczególne ustawienia zgodnie z potrzebami.
  6. Zaakceptuj domyślną ścieżkę wyjściową lub wprowadź niestandardową, a następnie naciśnij klawisz Enter , aby rozpocząć ocenę.
  7. Poczekaj na zakończenie oceny.

Wyniki oceny są zapisywane do .github\modernize\assessment\ w katalogu projektu. Agent analizuje kod, zależności i konfigurację, aby zidentyfikować:

  • Nieaktualne wersje platformy
  • Przestarzałe interfejsy API
  • Problemy ze zgodnością z chmurą
  • Możliwości migracji

Krok 2. Tworzenie planu modernizacji

Po zakończeniu oceny agent wyświetli monit o utworzenie planu modernizacji na podstawie zidentyfikowanych problemów:

○ 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. Wybierz pozycję 1. Utwórz plan modernizacji.
  2. Wprowadź nazwę planu lub naciśnij klawisz Enter, aby użyć nazwy domyślnej.
  3. Wprowadź cel modernizacji jako podpowiedź. Domyślnie monit References the assessment summary and creates plan służy do utworzenia planu na podstawie wyników oceny. Możesz zastąpić go dowolnym innym żądaniem migracji, na przykład:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Naciśnij klawisz Enter, aby wygenerować plan.

Agent analizuje kod źródłowy i generuje:

  • Plik planu (.github/modernize/{plan-name}/plan.md): szczegółowa strategia i podejście.
  • Lista zadań (.github/modernize/{plan-name}/tasks.json): podział kroków wykonywalnych.

Wskazówka

Możesz ręcznie edytować plan.md , aby dodać wyjaśnienia lub dostosować szczegóły. Przed wykonaniem planu można również zaktualizować tasks.json , zmienić kolejność, dodać lub usunąć zadania.

Krok 3. Wykonanie planu modernizacji

Po zweryfikowaniu planu upewnij się, że chcesz wykonać plan.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Wybierz pozycję 1. Wykonaj plan modernizacji.
  2. Naciśnij klawisz Enter, aby wykonać plan.
  3. Monitoruj postęp w miarę wprowadzania zmian przez agenta.

Agent wykonuje każde zadanie w następującej kolejności:

  • Wprowadza zmiany kodu zgodnie z planem.
  • Weryfikuje kompilacje po każdej zmianie.
  • Skanuje i rozwiązuje CVE-ów.
  • Zatwierdza zmiany.

Krok 4. Przeglądanie wyników

Po zakończeniu wykonania można przejrzeć wszystkie zmiany, które agent wprowadził przed ich scaleniem.

  1. Przejrzyj zmiany: Sprawdź modyfikacje w bieżącej gałęzi.

    git status
git diff main

  2. Utwórz pull request: Jeśli jesteś zadowolony ze zmian, utwórz pull request do przeglądu zespołu.

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

Następne kroki

Prześlij opinię

Twoja opinia jest ważna! Jeśli masz jakiekolwiek opinie dotyczące agenta modernizacji, zgłoś problem w repozytorium github-copilot-appmod lub użyj formularza opinii dotyczącego modernizacji GitHub Copilot.

  • Last updated on