Udostępnij za pośrednictwem

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

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

Wymagania wstępne

  • Subskrypcja Usługi GitHub Copilot: bezpłatna, Pro, Pro+, Business lub Enterprise. Zobacz Plany Copilot.
  • Interfejs wiersza polecenia usługi GitHub: zainstaluj interfejs wiersza polecenia usługi GitHub (gh) na potrzeby uwierzytelniania v2.45.0 lub nowszego. Zobacz Instalowanie gh.

Wymagania dotyczące platformy

  • Windows: x64 lub ARM64.
  • Linux: x64 lub ARM64 z wersją 2.27 lub nowszą glibc (Ubuntu 18.04 lub nowsza, Debian 10 lub nowszy, Fedora 29 lub nowsza, Azure Linux 2.0 lub nowsza).
  • 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 najnowszy plik MSI ze strony wydań na GitHubie.

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 pozycję 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 usługi GitHub:

gh auth login

Następnie uruchom agenta modernizacji:

modernize

Zostanie wyświetlone menu główne:

○ 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

Krok 1. Ocena aplikacji

  1. Wybierz pozycję 1. Ocena aplikacji.
  2. Postępuj zgodnie z monitami, aby skonfigurować opcje oceny (lub naciśnij klawisz Enter, aby użyć wartości domyślnych).
  3. Przejrzyj wybrane opcje i naciśnij klawisz Enter, aby rozpocząć ocenę.
  4. 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 dla nas cenna! Jeśli masz jakiekolwiek opinie na temat agenta modernizacji, utwórz problem w repozytorium github-copilot-appmod lub skorzystaj z formularza opinii o modernizacji narzędzia GitHub Copilot.

  • Last updated on