Dela via

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

  • En GitHub Copilot-prenumeration: Kostnadsfri, Pro, Pro+, Företag eller Enterprise-plan. Se Copilot-planer.
  • GitHub CLI: Installera GitHub CLI (gh) för autentisering 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:en från GitHub-versionssidan.

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 Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Steg 1: Utvärdera programmet

  1. Välj 1. Utvärdera programmet.
  2. Följ anvisningarna för att konfigurera utvärderingsalternativ (eller tryck på Retur för att använda standardvärden).
  3. Granska dina val och tryck på Retur för att starta utvärderingen.
  4. 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. Ange ett plannamn eller tryck på Retur för att använda standardnamnet.
  3. Ange moderniseringsmålet som en uppmaning. Som standard är References the assessment summary and creates plan 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
  4. Tryck på Retur för att generera planen.

Agenten analyserar din kodbas och genererar:

  • Planfil (.github/modernize/{plan-name}/plan.md): Detaljerad strategi och metod.
  • Uppgiftslista (.github/modernize/{plan-name}/tasks.json): Uppdelning av körbara steg.

Tips/Råd

Du kan redigera plan.md manuellt för att lägga till förtydliganden eller justera information. Du kan också uppdatera tasks.json för att ändra, ordna om, lägga till eller ta bort uppgifter innan du kör planen.

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

Vi värdesätter dina indata! Om du har feedback om moderniseringsagenten skapar du ett problem på github-copilot-appmod-lagringsplatsen eller använder feedbackformuläret för modernisering av GitHub Copilot.

  • Last updated on