Sdílet prostřednictvím

Rychlý start: Instalace a použití agenta pro modernizaci GitHub Copilot

Tento rychlý start vás provede instalací agenta modernizace GitHub Copilotu a jeho použitím k modernizaci ukázkové aplikace.

Předpoklady

  • Předplatné GitHub Copilotu: plán Free, Pro, Pro+, Business nebo Enterprise. Podívejte se na plány Copilot.
  • GitHub CLI: Nainstalujte GitHub CLI (gh) pro ověřování, v2.45.0 nebo vyšší. Viz Instalace gh.

Požadavky platformy

  • Windows: x64 nebo ARM64.
  • Linux: x64 nebo ARM64 s glibc verzí 2.27 nebo novější (Ubuntu 18.04 nebo novější, Debian 10 nebo novější, Fedora 29 nebo novější, Azure Linux 2.0 nebo novější).
  • macOS: Apple Silicon nebo Intel.

Nainstalujte agenta modernizace

Pomocí následujících příkazů nainstalujte agenta modernizace nebo aktualizujte na nejnovější verzi.

Použijte jednu z následujících možností:

Možnost 1 – Winget (doporučeno):

winget install GitHub.Copilot.modernization.agent

Bezobslužná instalace bez výzev:

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

Možnost 2 – PowerShell jedním příkazem:

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

Možnost 3 – Instalační program MSI:

Stáhněte a spusťte nejnovější MSI ze stránky vydaných verzí GitHubu.

Poznámka:

Po instalaci otevřete nový terminál, aby byl modernize příkaz dostupný v cestě PATH. Tyto příkazy fungují pro počáteční instalaci i aktualizaci na nejnovější verzi. V budoucí verzi bude k dispozici příkaz aktualizace vyhrazené verze.

Ověřte tuto instalaci:

modernize --version

Získání ukázkové aplikace

Pro účely tohoto rychlého startu použijte ukázkovou aplikaci. Zvolte Javu nebo .NET:

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

Použití interaktivního režimu

Nejjednodušší způsob, jak začít, je použít interaktivní režim. Nejprve se ověřte pomocí rozhraní příkazového řádku GitHubu:

gh auth login

Pak spusťte agenta modernizace:

modernize

Zobrazí se hlavní nabídka:

○ 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: Posouzení aplikace

  1. Vyberte 1. Posouzení aplikace
  2. Podle pokynů nakonfigurujte možnosti posouzení (nebo stisknutím klávesy Enter použijte výchozí hodnoty).
  3. Zkontrolujte výběry a stisknutím klávesy Enter spusťte posouzení.
  4. Počkejte, až se posouzení dokončí.

Výsledky posouzení se uloží do .github\modernize\assessment\ adresáře projektu. Agent analyzuje kód, závislosti a konfiguraci a identifikuje:

  • Zastaralé verze rozhraní
  • Zastaralá rozhraní API
  • Problémy s kompatibilitou cloudu
  • Příležitosti k migraci

Krok 2: Vytvoření plánu modernizace

Po dokončení posouzení vás agent vyzve k vytvoření plánu modernizace na základě zjištěných problémů:

○ 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. Vyberte 1. Vytvoření plánu modernizace
  2. Zadejte název plánu nebo stiskněte Enter a použijte výchozí název.
  3. Zadejte svůj cíl modernizace jako podnět. Ve výchozím nastavení se zobrazí výzva References the assessment summary and creates plan, aby byl vytvořen plán na základě výsledků posouzení. Můžete ho nahradit jakoukoli jinou žádostí o migraci, například:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Stisknutím klávesy Enter vygenerujte plán.

Agent analyzuje základ kódu a vygeneruje:

  • Soubor plánu (.github/modernize/{plan-name}/plan.md): Podrobná strategie a přístup
  • Seznam úkolů (.github/modernize/{plan-name}/tasks.json): Rozpis spustitelných kroků

Návod

Pokud chcete přidat objasnění nebo upravit podrobnosti, můžete je upravit plan.md ručně. Před provedením plánu můžete také upravit tasks.json , změnit pořadí, přidat nebo odebrat úkoly.

Krok 3: Provedení plánu modernizace

Po ověření plánu potvrďte, že chcete plán spustit.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Vyberte 1. Proveďte plán modernizace.
  2. Stisknutím klávesy Enter plán spusťte.
  3. Sledujte průběh, jak agent aplikuje změny.

Agent provede každou úlohu v pořadí:

  • Provede změny kódu podle plánu.
  • Ověřuje softwareová sestavení po každé změně.
  • Vyhledá a řeší CVE.
  • Odsouhlasí změny.

Krok 4: Kontrola výsledků

Po dokončení provádění můžete zkontrolovat všechny změny, které agent provedl před jejich sloučením:

  1. Revize změn: Zkontrolujte změny v aktuální větvi.

    git status
git diff main

  2. Vytvořte pull request: Pokud jste se změnami spokojeni, vytvořte PR pro kontrolu týmu.

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

Další kroky

Poskytnout zpětnou vazbu

Vážíme si vašeho vstupu! Pokud máte zpětnou vazbu k modernizačnímu agentu, vytvořte problém v úložišti github-copilot-appmod nebo použijte formulář pro zpětnou vazbu k modernizaci GitHub Copilot.

  • Last updated on