Sdílet prostřednictvím


Rychlý start: Posouzení a migrace projektu .NET s využitím modernizace aplikací GitHub Copilot pro .NET

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

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

Prerequisites

Posouzení připravenosti aplikace

Modernizace aplikací GitHub Copilot 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í prostředků Azure, přidání konfigurací a provedení změn kódu. Pokud chcete zahájit migraci, postupujte takto:

  1. Naklonujte repositář ukázek pro migraci .NET na váš počítač.

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

  3. V Průzkumníku řešení klikněte pravým tlačítkem myši na uzel řešení a vyberte Modernizovat.

    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 ji do 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 přímo otevřít GitHub Copilot Chat a odeslat @Modernize Migrate to Azure ho, abyste mohli spustit tok posouzení a migrace.

  5. Otevře se nová chatovací relace Copilot a zobrazí se uvítací zpráva. 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 aplikací GitHub Copilot pro .NET zahrnuje předdefinované úlohy pro běžné scénáře migrace a dodržuje osvědčené 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. Odeslat v chatu Copilot

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

Snímek obrazovky s odesláním zprávy 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 spustí GitHub Copilot relaci s názvem "Modernizace aplikací: 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: 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í použití nástrojů znalostní báze na serveru MCP (Model Context Protocol). Po zobrazení výzvy udělte oprávnění.

  • Copilot se řídí plánem a sledováním 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 aplikace GitHub Copilot pro .NET poskytuje výchozí možnosti chatových zpráv, které zjednoduší váš pracovní postup.

Snímek obrazovky s výchozími možnostmi chatu v chatu Copilot

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

  • Spuštění posouzení modernizace: Spustí nové posouzení vaší aplikace, které identifikuje problémy s připraveností na migraci a problémy s kompatibilitou Azure.
  • 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 Copilotem pro konkrétní otázky nebo potřeby.

Další kroky

Prerequisites

Posouzení připravenosti aplikace

Modernizace aplikací GitHub Copilot 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í prostředků Azure, přidání konfigurací a provedení změn kódu. Pokud chcete zahájit migraci, postupujte takto:

  1. Naklonujte repositář ukázek pro migraci .NET na váš počítač.

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

  3. Otevřete rozšíření GitHub Copilot pro modernizaci aplikací.

  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 aplikací GitHub Copilot pro .NET zahrnuje předdefinované úlohy pro běžné scénáře migrace a dodržuje osvědčené 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 otevřený projekt .NET v editoru Visual Studio Code.

  2. Výběrem ikony chatu na panelu aktivit 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.

    Snímek obrazovky s výběrem 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 úloha Migrace databáze do služby Azure Database for PostgreSQL v části Databázové úlohy aktualizuje připojení k databázi, konfigurace, závislosti a kód pro přístup k datům pro použití služby 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

Při spuštění migrace spustí GitHub Copilot 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: 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í použití nástrojů znalostní báze na serveru MCP (Model Context Protocol). Po zobrazení výzvy udělte oprávnění.

Copilot se řídí plánem a sledováním 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:

Ve Visual Studio Code se při modernizaci aplikací AppModernization-DotNet standardně používá vlastní agent s Claudem Sonnetem verze 4.5 pro dosažení nejlepších výsledků 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