Rychlý start: Posouzení a migrace projektu .NET pomocí modernizace GitHub Copilotu pro .NET

V tomto rychlém startu vyhodnotíte a migrujete projekt .NET pomocí modernizace GitHub Copilotu pro .NET. Provedete následující úkoly:

  • Posouzení ukázkového projektu (Univerzita Contoso)
  • Spuštění procesu migrace

Prerequisites

Poznámka:

Tyto požadavky platí pro Visual Studio. Další vývojová prostředí najdete v tématu Instalace modernizace Copilotu GitHubu.

Posouzení připravenosti aplikace

Modernizace GitHub Copilotu pro posouzení .NET vám pomůže najít výzvy připravenosti aplikací, zjistit jejich dopad a podívat se na doporučené úlohy migrace. Každá úloha migrace obsahuje odkazy na nastavení Azure prostředků, přidání konfigurací a provádění změn kódu. Pokud chcete zahájit migraci, postupujte takto:

  1. Naklonujte do počítače úložiště .NET migration copilot samples.

  2. V Visual Studio otevřete řešení Contoso University z úložiště ukázek.

  3. V Solution Explorer klikněte pravým tlačítkem na uzel řešení a vyberte Modernize.

    Snímek obrazovky znázorňující možnost modernizace v místní nabídce

  4. Otevře se okno GitHub Copilot Chat s uvítací zprávou a předdefinovanými možnostmi. Z dostupných možností vyberte Migrovat do Azure a odešlete to Copilotu.

    Snímek obrazovky znázorňující uvítací zprávu s možnostmi migrace

    Tip

    Místo kroků 3 a 4 můžete otevřít GitHub Copilot Chat přímo a odeslat @Modernize Migrate to Azure, aby se spustil tok posouzení a migrace.

  5. Otevře se nová Copilot chatová relace a zobrazí uvítací zprávu. Posouzení se spustí automaticky a analyzuje váš projekt pro připravenost migrace.

    Snímek obrazovky znázorňující probíhající posouzení s indikátory stavu

  6. Po dokončení posouzení se v okně chatu zobrazí stránka s komplexním uživatelským rozhraním sestavy posouzení a seznam úloh migrace.

    Snímek obrazovky znázorňující vygenerovanou sestavu posouzení s podrobnými zjištěními

Migrace aplikací

Modernizace GitHub Copilotu pro .NET zahrnuje předdefinované úlohy pro běžné scénáře migrace a řídí se osvědčenými postupy Microsoftu.

Spusťte úlohu migrace

Spusťte úlohu migrace jedním z následujících způsobů:

Možnost 1. Spustit ze zprávy o hodnocení

Spusťte úlohu migrace výběrem tlačítka Spustit úlohu v sestavě posouzení z předchozího kroku.

Možnost 2. Odeslání v chatu Copilot

Odešle číslo úkolu migrace (například 1,1) nebo jeho název v chatu.

Screenshot zprávy odeslané v chatu Copilot ke spuštění úlohy migrace.

Generování plánu a sledování průběhu

  • Při spuštění migrace začne GitHub Copilot relaci s názvem "Modernizace: migrace z <source technology> do <target technology>" v režimu agenta s předdefinovanými výzvami.
  • Nástroj vytvoří ve .appmod/.migration složce dva soubory:
    • plan.md: Celkový plán migrace.
    • progress.md: Nástroj pro sledování průběhu, který GitHub Copilot aktualizuje při dokončování úkolů.
  • Před pokračováním upravte tyto soubory a upravte migraci.

Spuštění opravy kódu

  • Pokud jste s plánem a sledováním průběhu spokojeni, zadejte výzvu ke spuštění procesu migrace, například:

    The plan and progress tracker look good to me. Go ahead with the migration.

  • GitHub Copilot spustí proces migrace a může požádat o schválení, aby používal nástroje pro práci se znalostní bází na serveru MCP (Model Context Protocol). Po zobrazení výzvy udělte oprávnění.

  • Copilot se řídí plánem a nástrojem pro sledování pokroku:

    • Správa závislostí
    • Použijte změny konfigurace.
    • Proveďte změny kódu.
    • Sestavte řešení, opravte všechny chyby kompilace a konfigurace a zajistěte úspěšné sestavení.
    • Opravte ohrožení zabezpečení.

Výchozí zprávy chatu

Modernizace GitHub Copilotu pro .NET poskytuje výchozí možnosti chatovacích zpráv, které vám umožní zjednodušit pracovní postup.

Screenshot, který zobrazuje výchozí možnosti chatu v Copilot Chat.

Zvolte jednu z předdefinovaných možností a odešlete ji v chatu:

  • Spustí posouzení modernizace: Spustí nové posouzení aplikace, které identifikuje problémy s připraveností na migraci a Azure problémy s kompatibilitou.
  • Zobrazit sestavu posouzení: Otevře předchozí sestavu posouzení a zobrazí souhrn úkolů migrace na základě výsledků. Pokud neexistuje žádné předchozí posouzení, spustí se nejprve nové posouzení.
  • Projděte si hlavní úlohy migrace: Zobrazuje doporučené úlohy migrace a běžné scénáře modernizace bez ohledu na konkrétní výsledky posouzení.

Tip

Tyto výchozí zprávy vám pomůžou rychle procházet běžné pracovní postupy bez zadávání vlastních výzev. Můžete také zadat vlastní zprávy pro interakci s Copilot pro konkrétní otázky nebo potřeby.

Další kroky

Prerequisites

Posouzení připravenosti aplikace

Modernizace GitHub Copilotu pro posouzení .NET vám pomůže najít výzvy připravenosti aplikací, zjistit jejich dopad a podívat se na doporučené úlohy migrace. Každá úloha migrace obsahuje odkazy na nastavení Azure prostředků, přidání konfigurací a provádění změn kódu. Pokud chcete zahájit migraci, postupujte takto:

  1. Naklonujte do počítače úložiště .NET migration copilot samples.

  2. V Visual Studio Code otevřete řešení Contoso University z úložiště ukázek.

  3. Otevřete rozšíření GitHub Copilot Modernization.

  4. V části RYCHLÝ START vyberte Spustit posouzení. Otevře se stránka Sestavy posouzení .

  5. V pravém horním rohu stránky vyberte Spustit posouzení .

    Snímek obrazovky se spuštěním úlohy v části Úkoly a spuštěním úlohy migrace

  6. Posouzení se spustí automaticky a analyzuje váš projekt pro připravenost migrace.

    Snímek obrazovky se spuštěním úlohy analyzující projekt pro připravenost migrace

  7. Po dokončení posouzení se v okně chatu zobrazí stránka s komplexním uživatelským rozhraním sestavy posouzení a seznam úloh migrace.

    Snímek obrazovky se stránkou uživatelského rozhraní sestavy posouzení a seznamem úloh migrace

Migrace aplikací

Modernizace GitHub Copilotu pro .NET zahrnuje předdefinované úlohy pro běžné scénáře migrace a řídí se osvědčenými postupy Microsoftu.

Migrace na základě chatu je doporučený způsob, jak zahájit migraci. Vlastní AppModernization-DotNet agent je optimalizovaný pro úlohy modernizace aplikací. Tento agent umožňuje používat jednoduché výzvy přirozeného jazyka k provádění složitých scénářů migrace.

Provedením následujících kroků vyberte vlastního agenta a spusťte migraci:

  1. Ujistěte se, že máte v Visual Studio Code otevřený projekt .NET.

  2. Výběrem ikony chatu v panelu Aktivita otevřete okno chatu Copilot.

  3. V okně chatu vyhledejte rozevírací seznam pro výběr agenta v horní části textového pole chatu. V seznamu vyberte AppModernization-DotNet . Tento vlastní agent je navržený pro scénáře modernizace a migrace aplikací .NET.

    Screenshot výběru vlastního agenta .NET v okně chatu.

  4. Zadejte výzvu pomocí formátu migrate from <source> to <target> v okně chatu. Například:

    migrate from rabbitmq to Azure service bus

  5. Agent analyzuje váš kód, vytvoří plán migrace, provede změny kódu, spustí ověření a vygeneruje souhrn. Zvolte Pokračovat pro projití jednotlivými kroky a Ponechat pro přijetí změn.

Spuštění úlohy migrace z uživatelského rozhraní

Úlohu migrace můžete spustit také z uživatelského rozhraní:

Možnost 1. Spustit ze zprávy o hodnocení

Spusťte úlohu migrace výběrem tlačítka Spustit úlohu v sestavě posouzení z předchozího kroku.

Možnost 2. Použití předdefinované úlohy

Spusťte konkrétní úlohu v části TASKS – .NET. Například Migrate Database to Azure Database for PostgreSQL task under Database Tasks aktualizuje připojení k databázi, konfigurace, závislosti a kód pro přístup k datům tak, aby používal Azure Database for PostgreSQL.

Snímek obrazovky se spuštěním konkrétní předdefinované úlohy

Generování plánu a sledování průběhu

Když spustíte migraci, GitHub Copilot spustí relaci v režimu agenta.

Nástroj vytvoří ve .github/appmod/code-migration/<target-branch-name> složce dva soubory:

  • plan.md: Celkový plán migrace.
  • progress.md: Nástroj pro sledování průběhu, který GitHub Copilot aktualizuje při dokončování úkolů.

Před pokračováním upravte tyto soubory a upravte migraci.

Snímek obrazovky s generováním plánu během úlohy migrace

Spuštění opravy kódu

Až budete s plánem a sledováním průběhu spokojeni, zadejte pokračovat v zahájení migrace.

GitHub Copilot spustí proces migrace a může požádat o schválení, aby používal nástroje pro práci se znalostní bází na serveru MCP (Model Context Protocol). Po zobrazení výzvy udělte oprávnění.

Copilot se řídí plánem a nástrojem pro sledování pokroku:

  • Správa závislostí
  • Použijte změny konfigurace.
  • Proveďte změny kódu.
  • Sestavte projekt, opravte všechny chyby kompilace a konfigurace a zajistěte úspěšné sestavení.
  • Opravte ohrožení zabezpečení.

Opakovaným výběrem nebo zadáním příkazu Pokračovat potvrďte použití nástrojů nebo příkazů a počkejte, až se změny kódu dokončí.

Poznámka:

V editoru Visual Studio Code používá modernizace ve výchozím nastavení vlastního agenta AppModernization-DotNet s Claude Sonnet 4.5 pro nejlepší výsledky při aktualizaci .NET kódu pro migraci do Azure. Vrátí se do modelu "auto", pokud pro vás není k dispozici Sonnet 4.5. Vlastního agenta můžete nakonfigurovat tak, aby upravil nastavení modelu tak, že v nabídce Agentvyberete Konfigurovat vlastní agenty. Případně můžete pomocí nástroje pro výběr jazykového modelu v okně chatu přepnout modely pro aktuální chatovací relaci.

Iterace ověření

Po dokončení změn kódu nástroj pro migraci spustí iterační smyčku ověřování a oprav. Tato smyčka zahrnuje následující pět kroků:

  1. Detekujte běžné zranitelnosti a expozice (CVE) v aktuálních závislostech a opravte je.
  2. Sestavte projekt a vyřešte případné chyby sestavení.
  3. Analyzujte kód pro funkční konzistenci.
  4. Analyzujte projekt pro selhání testů jednotek a automaticky vygenerujte plán, který je opraví, dokud testy neprojdou.
  5. Analyzujte kód pro položky migrace, které se v počáteční migraci kódu vynechaly, a opravte je.

Po dokončení všech procesů nástroj pro migraci vygeneruje souhrn. Zkontrolujte změny kódu a potvrďte je výběrem možnosti Zachovat.

Další kroky

  • Last updated on