Quickstart: De GitHub Copilot moderniseringsagent installeren en gebruiken

In deze quickstart leert u hoe u de GitHub Copilot moderniseringsagent installeert en deze gebruikt om een voorbeeldtoepassing te moderniseren.

Vereiste voorwaarden

  • A GitHub Copilot-abonnement: Gratis, Pro, Pro+, Business of Enterprise-abonnement. Zie Copilot plans.
  • GitHub CLI: installeer de GitHub CLI (gh) voor verificatie, versie v2.45.0 of hoger. Zie Installeren gh.

Platformvereisten

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

De moderniseringsagent installeren

Gebruik de volgende opdrachten om de moderniseringsagent te installeren of bij te werken naar de nieuwste versie.

Gebruik een van de volgende opties:

Optie 1: Winget (aanbevolen):

winget install GitHub.Copilot.modernization.agent

Voor installatie op de achtergrond zonder prompts:

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

Optie 2- PowerShell-one-liner:

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

Optie 3: MSI-installatieprogramma:

Download en voer de nieuwste MSI uit vanaf de GitHub releases-pagina.

Opmerking

Open na de installatie een nieuwe terminal voor de modernize opdracht die beschikbaar is op uw PATH. Deze opdrachten werken zowel voor de eerste installatie als voor het bijwerken naar de nieuwste versie. Een toegewezen versie-updateopdracht is beschikbaar in een toekomstige release.

Controleer de installatie:

modernize --version

Een voorbeeldtoepassing ophalen

Gebruik voor deze quickstart een voorbeeldtoepassing. Kies Java of .NET:

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

De interactieve modus gebruiken

De eenvoudigste manier om aan de slag te gaan is door gebruik te maken van de interactieve modus. Verifieer eerst met behulp van de GitHub CLI:

gh auth login

Voer vervolgens de moderniseringsagent uit:

modernize

Het hoofdmenu wordt weergegeven:

○ 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

Stap 1: De toepassing evalueren

  1. Selecteer Evalueren in het hoofdmenu.
  2. Kies hoe u de doelopslagplaatsen opgeeft. U kunt huidige map selecteren om uw huidige map te gebruiken, handmatige invoer om lokale paden of externe Git-URL's in te voeren, of vanuit een configuratiebestand om opslagplaatsen uit een JSON-configuratiebestand te laden. Voor deze quickstart selecteert u de huidige map.
  3. Selecteer evaluatiedomeinen, zoals Java upgrade en Cloud Readiness en druk op Enter.
  4. Bekijk de configuratieopties voor evaluatie, zoals Analysedekking en Doelruntime. Druk op Enter op Doorgaan om de aanbevolen standaardinstellingen te accepteren of pas de afzonderlijke instellingen indien nodig aan.
  5. Kies de uitvoeringsmodus. Selecteer Lokaal evalueren om de evaluatie uit te voeren op uw computer of Delegeren aan cloudagents om cloudagents de evaluatie parallel te laten uitvoeren. Voor deze quickstart selecteert u Lokaal evalueren.
  6. Accepteer het standaarduitvoerpad of voer een aangepast pad in en druk op Enter om de evaluatie te starten.
  7. Wacht tot de evaluatie is voltooid.

De evaluatieresultaten worden opgeslagen naar .github\modernize\assessment\ in uw projectmap. De agent analyseert uw code, afhankelijkheden en configuratie om het volgende te identificeren:

  • Verouderde frameworkversies
  • Verouderde API's
  • Problemen met cloudcompatibiliteit
  • Migratiekansen

Stap 2: Een moderniseringsplan maken

Nadat de evaluatie is voltooid, wordt u door de agent gevraagd om een moderniseringsplan te maken op basis van de geïdentificeerde 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. Selecteer 1. Maak moderniseringsplan.
  2. Selecteer 1. Houd het plan lokaal om het plan op uw computer te genereren of kies 2. Verzenden naar cloudagent om een cloudagent te laten genereren. Optie 2 is experimenteel.
  3. Het zojuist gemaakte evaluatierapport is standaard geselecteerd om het plan te genereren. Selecteer 1. Geen rapport als u in plaats daarvan uw specifieke vereisten wilt beschrijven.
  4. Voer een plannaam in of druk op Enter om de standaardnaam te gebruiken.
  5. Voer uw moderniseringsdoelstelling in als opdracht. Standaard is Based on the assessment report, upgrade the project and migrate to Azure de prompt om een plan te maken op basis van de evaluatieresultaten. U kunt deze vervangen door een andere migratieaanvraag, bijvoorbeeld:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  6. Druk op Enter om het plan te genereren.
  7. De agent analyseert uw codebasis en vraagt u om de aanvraag te verduidelijken. U kunt een voorgesteld antwoord selecteren of uw eigen antwoord typen.

De agent voegt alle informatie samen en genereert:

  • Planbestand (.github/modernize/{plan-name}/plan.md): Gedetailleerde strategie en benadering.

Aanbeveling

U kunt handmatig bewerken plan.md om toelichtingen toe te voegen of details aan te passen.

Stap 3: Het moderniseringsplan uitvoeren

Nadat u het plan hebt gecontroleerd, bevestigt u dat u het plan wilt uitvoeren.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Selecteer 1. Moderniseringsplan uitvoeren.
  2. Druk op Enter om het plan uit te voeren.
  3. Controleer de voortgang terwijl de agent wijzigingen toepast.

De agent voert elke taak in de volgende volgorde uit:

  • Hiermee worden codewijzigingen aangebracht volgens het plan.
  • Valideert builds na elke wijziging.
  • Scant en verhelpt CVE's.
  • Wijzigingen doorvoeren.

Stap 4: De resultaten bekijken

Nadat de uitvoering is voltooid, kunt u alle wijzigingen bekijken die de agent heeft aangebracht voordat u ze samenvoegt:

  1. Wijzigingen controleren: Controleer de wijzigingen in de huidige vertakking.

    git status
git diff main

  2. Een pull request maken: als u tevreden bent met de wijzigingen, maakt u een pull request aan voor teambeoordeling.

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

Volgende stappen 

Feedback geven

Uw feedback helpt de moderniseringsagent te verbeteren. Druk op F om feedback van de Modernize TUI te sturen.

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

U kunt ook een probleem maken in de github-copilot-appmod-opslagplaats of het GitHub Copilot feedbackformulier voor modernisering gebruiken.

  • Last updated on