Snabbstart: Installera och använda GitHub Copilot moderniseringsagenten

Den här snabbstarten vägleder dig genom att installera GitHub Copilot moderniseringsagenten och använda den för att modernisera ett exempelprogram.

Förutsättningar

  • A GitHub Copilot prenumeration: Kostnadsfri, Pro, Pro+, Företag eller Enterprise-plan. Se Copilot plan.
  • GitHub CLI: Installera GitHub CLI (gh) för autentisering, version v2.45.0 eller senare. Se Installera gh.

Plattformskrav

  • Windows: x64 eller ARM64.
  • Linux: x64 eller ARM64 med glibc 2.27 eller senare (Ubuntu 18.04 eller senare, Debian 10 eller senare, Fedora 29 eller senare, Azure Linux 2.0 eller senare).
  • macOS: Apple Silicon eller Intel.

Installera moderniseringsagenten

Använd följande kommandon för att installera moderniseringsagenten eller uppdatera till den senaste versionen.

Använd något av följande alternativ:

Alternativ 1 – Winget (rekommenderas):

winget install GitHub.Copilot.modernization.agent

För tyst installation utan frågor:

winget install GitHub.Copilot.modernization.agent --silent

Alternativ 2 – PowerShell one-liner:

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

Alternativ 3 – MSI-installationsprogram:

Ladda ned och kör den senaste MSI-versionen från sidan GitHub.

Anmärkning

Efter installationen öppnar du en ny terminal för modernize att kommandot ska vara tillgängligt på din PATH. Dessa kommandon fungerar för både den första installationen och uppdateringen till den senaste versionen. Ett dedikerat versionsuppdateringskommando kommer att vara tillgängligt i en framtida version.

Kontrollera installationen:

modernize --version

Hämta ett exempelprogram

I den här snabbstarten använder du ett exempelprogram. Välj antingen Java eller .NET:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

Använda interaktivt läge

Det enklaste sättet att komma igång är att använda det interaktiva läget. Autentisera först med hjälp av GitHub CLI:

gh auth login

Kör sedan moderniseringsagenten:

modernize

Huvudmenyn visas:

○ 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

Steg 1: Utvärdera programmet

  1. Välj Utvärdera på huvudmenyn.
  2. Välj hur du vill ange dina mållagringsplatser. Du kan välja Aktuell mapp för att använda din aktuella katalog, Manuell indata för att ange lokala sökvägar eller fjärranslutna Git-URL:er eller Från en konfigurationsfil för att läsa in lagringsplatser från en JSON-konfigurationsfil. För den här snabbstarten väljer du Aktuell mapp.
  3. Välj utvärderingsdomäner, till exempel Java uppgradering och Molnberedskap och tryck på Enter.
  4. Granska konfigurationsalternativen för utvärdering, till exempel analystäckning och målkörtid. Tryck på Retur på Fortsätt för att acceptera de rekommenderade standardinställningarna eller justera enskilda inställningar efter behov.
  5. Välj körningsläge. Välj Utvärdera lokalt för att köra utvärderingen på datorn eller Delegera till molnagenter för att låta molnagenter köra utvärderingen parallellt. För den här snabbstarten väljer du Utvärdera lokalt.
  6. Acceptera standardutdatasökvägen eller ange en anpassad sökväg och tryck sedan på Retur för att starta utvärderingen.
  7. Vänta tills utvärderingen har slutförts.

Utvärderingsresultaten sparas till .github\modernize\assessment\ i projektkatalogen. Agenten analyserar din kod, dina beroenden och din konfiguration för att identifiera:

  • Inaktuella ramverksversioner
  • Inaktuella API:er
  • Problem med molnkompatibilitet
  • Migreringsmöjligheter

Steg 2: Skapa en moderniseringsplan

När utvärderingen är klar uppmanar agenten dig att skapa en moderniseringsplan baserat på de identifierade problemen:

○ 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. Välj 1. Skapa moderniseringsplan.
  2. Välj 1. Håll planen lokal för att generera planen på datorn eller välj 2. Skicka till Cloud Agent för att låta en molnagent generera den. Alternativ 2 är experimentellt.
  3. Den nyligen skapade utvärderingsrapporten väljs som standard för att generera planen. Välj 1. Ingen rapport om du vill beskriva dina specifika krav i stället.
  4. Ange ett plannamn eller tryck på Retur för att använda standardnamnet.
  5. Ange moderniseringsmålet som en uppmaning. Som standard är Based on the assessment report, upgrade the project and migrate to Azure uppmaningen att skapa en plan baserat på utvärderingsresultaten. Du kan ersätta den med andra migreringsbegäranden, till exempel:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  6. Tryck på Retur för att generera planen.
  7. Agenten analyserar din kodbas och ber dig att klargöra begäran. Du kan välja ett föreslaget svar eller skriva ett eget.

Agenten aggregerar all information och genererar:

  • Planfil (.github/modernize/{plan-name}/plan.md): Detaljerad strategi och metod.

Tips/Råd

Du kan redigera plan.md manuellt för att lägga till förtydliganden eller justera information.

Steg 3: Kör moderniseringsplanen

När du har verifierat planen bekräftar du att du vill köra planen.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Välj 1. Kör moderniseringsplanen.
  2. Tryck på Enter för att genomföra planen.
  3. Övervaka förloppet när agenten tillämpar ändringar.

Agenten kör varje uppgift i ordning:

  • Gör kodändringar enligt planen.
  • Validerar byggen efter varje ändring.
  • Söker efter och åtgärdar CVE:er.
  • Genomför ändringar.

Steg 4: Granska resultaten

När utförandet är klart kan du granska alla ändringar som agenten gjorde innan de sammanfogas med huvudversionen:

  1. Granska ändringar: Kontrollera modifieringarna på den nuvarande grenen.

    git status
git diff main

  2. Skapa en pull request: Om du är nöjd med ändringarna, skapa en PR för teamgranskning.

    gh pr create \
    --title "Modernization: migrate the app to azure" \
    --body "Automated modernization by GitHub Copilot agent"

Nästa steg

Lämna feedback

Din feedback hjälper till att förbättra moderniseringsagenten. Om du vill skicka feedback från Modernisera TUI trycker du på 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

Du kan också skapa ett problem på github-copilot-appmod-lagringsplatsen eller använda formuläret GitHub Copilot moderniseringsfeedback.

  • Last updated on