Migrujte aplikace .NET do Azure pomocí funkce GitHub Copilot modernization v nástroji Copilot CLI

Přehled

Zjistěte, jak migrovat .NET aplikace do Azure pomocí modulu plug-in GitHub Copilot modernizace v Copilot CLI.

Modul plug-in poskytuje autonomní pracovní postup s více agenty, který vyhodnocuje vaši .NET aplikaci, generuje spustitelný plán modernizace a provádí migraci – to vše z terminálu. Podporuje migrace do Azure, opravy zranitelností CVE a přepracování architektury aplikací.

Poznámka:

GitHub Copilot CLI je k dispozici v plánech GitHub Copilot Pro, GitHub Copilot Pro+, GitHub Copilot Business a GitHub Copilot Enterprise. Pokud obdržíte Copilot prostřednictvím organizace, musí správce povolit politiku CLI Copilot v nastavení organizace.

Co můžete dělat

Schopnost Description
.NET migrace na Azure Posouzení a migrace aplikací .NET do služeb Azure (Service Bus, Azure SQL, Redis, Key Vault, Application Insights, spravovaná identita), včetně auditů zabezpečení NuGet a migrací ASP.NET na Azure
CVE a oprava zranitelností Vyhledejte a opravte zranitelnosti CVE v závislostech NuGetu
Změna architektury aplikace Strukturální přepracování, jako je dekompozice monolitu na mikroslužby, modernizace zastaralého uživatelského rozhraní a vyčlenění modulů

Požadavky

Instalace modulu plug-in

  1. Spuštěním příkazu copilot v terminálu spusťte rozhraní příkazového řádku Copilot.

    copilot

  2. Přidejte marketplace a nainstalujte modul plug-in:

    copilot plugin marketplace add microsoft/github-copilot-modernization
copilot plugin install github-copilot-modernization@github-copilot-modernization

  3. Ověřte, že je modul plug-in nainstalovaný, výpisem nainstalovaných modulů plug-in:

    /plugin list

    Měl by se zobrazit github-copilot-modernization:modernize v seznamu.

Aktualizace modulu plug-in

Pokud chcete modul plug-in aktualizovat, když je k dispozici nová verze, spusťte:

copilot plugin update github-copilot-modernization@github-copilot-modernization

Zahájení úlohy modernizace

Možnost 1: Začněte přímo s agentem

Přejděte do složky projektu .NET a spusťte Copilot CLI pomocí agenta modernizace:

cd /path/to/your/dotnet-project
copilot --agent=github-copilot-modernization:modernize

Možnost 2: Výběr agenta z rozhraní příkazového řádku Copilot

Pokud už jste v relaci Copilot CLI, pomocí příkazu /agent přepněte na agenta pro modernizaci:

/agent

Vyberte github-copilot-modernization:modernize ze seznamu.

Important

Před spuštěním jakýchkoli výzev k modernizaci musíte vybrat agenta github-copilot-modernization:modernize. Bez výběru tohoto agenta používá Copilot CLI výchozího agenta, který nemůže používat úplnou orchestraci s více agenty, podporu podnikového playbooku a specializované možnosti migrace, které modul plug-in poskytuje.

Spusťte pokyn k modernizaci

Jakmile je agent aktivní, popište, co chcete v přirozeném jazyce:

copilot> modernize my application

Nebo být konkrétnější:

copilot> modernize my .NET application for Azure
copilot> migrate this app from local SQL Server to Azure SQL Database
copilot> fix CVE vulnerabilities in my project

Pro bezobslužné spuštění použijte --allow-all příznak:

copilot --agent=github-copilot-modernization:modernize --allow-all

Jak pracovní postup funguje

Modul plug-in používá třífázový pracovní postup, který se spouští automaticky. Každou fázi nemusíte ručně volat – orchestrátor zpracovává směrování na základě vašeho požadavku.

Fáze 1: Posouzení

  • Detekuje .NET strukturu projektu a používá příslušné analytické nástroje.
  • Analyzuje závislosti, architektury a verze.
  • Identifikuje příležitosti a rizika modernizace.
  • Uloží výsledky do .github/modernize/assessment/souboru .

Fáze 2: Plánování

  • Načte výsledky posouzení a omezení podnikového playbooku (pokud jsou k dispozici).
  • Vygeneruje spustitelný plán úlohy.
  • Uloží plán do .github/modernize/<app>/plan.md a tasks.json.

Fáze 3: Provádění

  • Směruje úlohy do specializovaných exekutorů na základě typu úlohy.
  • Každý vykonavatel vyhledává ve znalostní bázi migrační vzory.
  • Sleduje průběh s automatickým opakováním pokusu v případě selhání.
  • Vytvoří podrobné potvrzení jednotlivých úkolů pro kontrolu.

Orchestrátor podporuje více vstupních bodů v závislosti na vašem záměru:

Workflow Když se aktivuje Co se stane
Obecný záměr "modernizace aplikace" Kompletní proces posouzení → plánování → provedení
Konkrétní úkol Migrace z SQL Server na Azure SQL Přeskočí posouzení, přejde rovnou k plánování → provedení.
Spustit existující plán "execute the plan" (spustit plán) Přeskočí posouzení a plánování, spustí existující plán.
Bezobslužný Bezobslužné spuštění s využitím --allow-all Stejné jako u obecného záměru, ale bez uživatelských promptů

Definování zásad modernizace podniku

Organizace můžou vložit svůj záměr modernizace – cílové architektury, standardy upgradu a zásady dodržování předpisů – přímo do pracovního postupu prostřednictvím playbooku. Tento přístup zajišťuje, že každý vygenerovaný plán odpovídá podnikovým standardům bez ruční kontroly každého rozhodnutí.

Nastavte postup

Umístěte soubory Markdownu do .github/modernize/playbook/ adresáře projektu. Fáze plánování automaticky přečte všechny .md soubory v této složce a před vygenerování plánu úkolů je sloučí s výsledky posouzení.

Important

Omezení playbooku mají přednost před doporučeními pro posouzení. Pokud playbook určuje "použít Azure Service Bus pro zasílání zpráv", má tato volba přednost bez ohledu na to, co posouzení zjistí.

Co můžete definovat v příručce

Typ zásady Examples
Cílové architektury Výpočetní služby (App Service, AKS, Container Apps), volby databáze (Azure SQL, Cosmos DB), platformy pro zasílání zpráv (Service Bus, Event Hubs)
Standardy aktualizace Cílové .NET verze, cesty migrace architektury
Ochranné zábrany Zakázané technologie, požadavky na zabezpečení, omezení dodržování předpisů, standardy ověřování
Standardy kódování Zásady vytváření názvů, vzory ověřování, protokolovací architektury
Strategie migrace Hranice rozsahu, předvolby klasifikace 6R (změna hostitele vs. refaktoring vs. změna architektury), strategie phasingu

Ukázková příručka

Vytvořte soubor na adrese .github/modernize/playbook/enterprise-standards.md:

# Enterprise Modernization Standards

## Target Architecture
- Use Azure Container Apps for microservices deployments
- Use Azure Service Bus for all asynchronous messaging
- Use Azure SQL Database for relational data
- Use Azure Blob Storage for file storage

## Security & Compliance
- All services must authenticate using Managed Identity — no connection strings or passwords in code
- All public endpoints must be behind Azure Front Door

## Guardrails
- Do not use Azure Functions for long-running processes
- All infrastructure must be defined in Bicep

Není vyžadováno žádné pevné pojmenování nebo struktura – orchestrátor odvodí účel každého souboru z jeho obsahu.

Předdefinované výchozí hodnoty

Bez playbooku plugin použije smysluplné výchozí hodnoty:

  • Azure: Spravovaná identita pro ověřování; spravované databázové služby pro relační data.
  • Zasílání zpráv: místní infrastruktura → Azure Service Bus.
  • Infrastructure: Bicep ve výchozím nastavení.

Obvyklé scénáře

migrace do Azure

copilot --agent=github-copilot-modernization:modernize
copilot> modernize my .NET application for Azure

Migrace z místního SQL Server na Azure SQL

copilot --agent=github-copilot-modernization:modernize
copilot> migrate this app from local SQL Server to Azure SQL Database with managed identity

Migrujte ze vstupně-výstupních operací se soubory do Azure Blob Storage

copilot --agent=github-copilot-modernization:modernize
copilot> migrate this app from local file I/O to Azure Blob Storage

CVE a oprava zabezpečení

copilot --agent=github-copilot-modernization:modernize
copilot> fix CVE vulnerabilities in my project

Změna architektury aplikace

copilot --agent=github-copilot-modernization:modernize
copilot> rearchitect my monolithic application into microservices

Úplná modernizace

copilot --agent=github-copilot-modernization:modernize
copilot> modernize my application

Řešení problémů

Modul plug-in nebyl nalezen.

# Verify marketplace is added
copilot plugin marketplace list

# Re-add marketplace if needed
copilot plugin marketplace add microsoft/github-copilot-modernization

# Reinstall
copilot plugin install github-copilot-modernization@github-copilot-modernization

Posouzení selže: Nebyla nalezena žádná aplikace.

  • Ověřte, že kořenový adresář projektu obsahuje .csproj soubor nebo .sln soubor.
  • Než spustíte Copilot CLI, ujistěte se, že jste ve správném adresáři.

Problémy se serverem MCP

Modul plug-in používá server MCP definovaný v jeho konfiguraci. Pokud narazíte na problémy, přeinstalujte modul plug-in a resetujte konfiguraci MCP.

Poskytnutí zpětné vazby

Podělte se o zpětnou vazbu ke GitHub Copilot CLI pomocí formuláře pro zpětnou vazbu k GitHub Copilot CLI.

Odkazy

  • Last updated on