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:

○ How would you like to modernize your app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

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 domeny oceny, takie jak Java upgrade i Cloud Readiness i naciśnij Enter.
  4. 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.
  5. 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.
  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. Wybierz 1. Zachowaj plan lokalnie, aby wygenerować plan na swoim komputerze, lub wybierz 2. Prześlij do agenta w chmurze, aby agent w chmurze go wygenerował. Opcja 2 jest eksperymentalna.
  3. Nowo utworzony raport oceny jest domyślnie wybierany do wygenerowania planu. Wybierz pozycję 1. Brak raportu , jeśli zamiast tego chcesz opisać określone wymagania.
  4. Wprowadź nazwę planu lub naciśnij klawisz Enter, aby użyć nazwy domyślnej.
  5. Wprowadź cel modernizacji jako podpowiedź. Domyślnie monit Based on the assessment report, upgrade the project and migrate to Azure 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
  6. Naciśnij klawisz Enter, aby wygenerować plan.
  7. Agent analizuje bazę kodu i prosi o wyjaśnienie żądania. Możesz wybrać sugerowaną odpowiedź lub wpisać własną.

Agent agreguje wszystkie informacje i generuje:

  • Plik planu (.github/modernize/{plan-name}/plan.md): szczegółowa strategia i podejście.

Wskazówka

Możesz ręcznie edytować plan.md , aby dodać wyjaśnienia lub dostosować szczegóły.

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 pomaga ulepszyć agenta modernizacji. Aby wysłać informacje zwrotne z interfejsu Modernize TUI, naciśnij klawisz F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Możesz również utworzyć zgłoszenie w repozytorium github-copilot-appmod lub użyć formularza opinii dotyczących modernizacji w usłudze GitHub Copilot.

  • Last updated on