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

Tento rychlý průvodce vás provede instalací modernizačního agenta GitHub Copilot a jeho použitím k modernizaci ukázkové aplikace.

Předpoklady

  • Předplatné GitHub Copilot: 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í, verzi v2.45.0 nebo novější. Viz Instalace gh.

Požadavky platformy

  • Windows: x64 nebo ARM64.
  • Linux: x64 nebo ARM64 s glibc 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í GitHub.

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 Java 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í GitHub CLI:

gh auth login

Pak spusťte agenta modernizace:

modernize

Zobrazí se hlavní nabídka:

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

  1. V hlavní nabídce vyberte Vyhodnotit .
  2. Zvolte, jak zadat cílová úložiště. Můžete vybrat Aktuální složku pro použití aktuálního adresáře, Ruční zadání pro zadání místních cest nebo vzdálených Git adres URL, nebo Z konfiguračního souboru pro načtení úložišť z konfiguračního souboru JSON. Pro účely tohoto rychlého startu vyberte Aktuální složka.
  3. Zvolte režim provádění. Výběrem možnosti Posoudit místně spustíte posouzení na vašem počítači, nebo delegujte na cloudové agenty , aby mohli posouzení spustit paralelně. Pro účely tohoto rychlého startu vyberte Posouzení místně.
  4. Vyberte domény posouzení, například Java upgrade a Cloud Readiness a stiskněte Enter.
  5. Projděte si možnosti konfigurace hodnocení, jako je například pokrytí analýzy a cílové prostředí runtime. Stisknutím klávesy Enterpotvrďte doporučené výchozí hodnoty nebo podle potřeby upravte jednotlivá nastavení.
  6. Přijměte výchozí výstupní cestu nebo zadejte vlastní cestu a stisknutím klávesy Enter spusťte posouzení.
  7. 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áš vstup je důležitý! Pokud máte nějaké připomínky k agentovi modernizace, nahlaste problém v úložišti github-copilot-appmod nebo použijte formulář zpětné vazby pro modernizaci GitHub Copilot.

  • Last updated on