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:

○ 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: 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. Vyberte domény posouzení, například Java upgrade a Cloud Readiness a stiskněte Enter.
  4. 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í.
  5. 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ě.
  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. Vyberte 1. Ponechte plán místní , aby se plán vygeneroval na vašem počítači, nebo zvolte 2. Odešlete do cloudového agenta , aby ho mohl vygenerovat cloudový agent. Možnost 2 je experimentální.
  3. Nově vytvořená zpráva o posouzení je ve výchozím nastavení vybrána pro generování plánu. Vyberte 1. Žádná sestava, pokud chcete místo toho popsat své konkrétní požadavky.
  4. Zadejte název plánu nebo stiskněte Enter a použijte výchozí název.
  5. Zadejte svůj cíl modernizace jako podnět. Ve výchozím nastavení se zobrazí výzva Based on the assessment report, upgrade the project and migrate to Azure, 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
  6. Stisknutím klávesy Enter vygenerujte plán.
  7. Agent analyzuje základ kódu a požádá vás o objasnění požadavku. Můžete vybrat navrženou odpověď nebo zadat vlastní.

Agent agreguje všechny informace a generuje:

  • Soubor plánu (.github/modernize/{plan-name}/plan.md): Podrobná strategie a přístup

Návod

Pokud chcete přidat objasnění nebo upravit podrobnosti, můžete je upravit plan.md ručně.

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

Vaše zpětná vazba pomáhá vylepšit agenta modernizace. Pokud chcete poslat zpětnou vazbu od Moderne TUI, stiskněte klávesu 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

Můžete také vytvořit issue v repozitáři github-copilot-appmod nebo použít formulář zpětné vazby k modernizaci GitHub Copilot.

  • Last updated on