Delen via

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

  • Een GitHub Copilot-abonnement: Gratis, Pro, Pro+, Business of Enterprise-abonnement. Zie Copilot-plannen.
  • GitHub CLI: Installeer de GitHub CLI (gh) voor verificatie 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-releasespagina.

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 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

Stap 1: De toepassing evalueren

  1. Kies 1. Evaluatie van toepassing.
  2. Volg de aanwijzingen om evaluatieopties te configureren (of druk op Enter om de standaardinstellingen te gebruiken).
  3. Controleer uw selecties en druk op Enter om de evaluatie te starten.
  4. 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. Voer een plannaam in of druk op Enter om de standaardnaam te gebruiken.
  3. Voer uw moderniseringsdoelstelling in als opdracht. Standaard is References the assessment summary and creates plan 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
  4. Druk op Enter om het plan te genereren.

De agent analyseert uw codebase en genereert:

  • Planbestand (.github/modernize/{plan-name}/plan.md): Gedetailleerde strategie en benadering.
  • Takenlijst (.github/modernize/{plan-name}/tasks.json): Uitsplitsing van uitvoerbare stappen.

Aanbeveling

U kunt handmatig bewerken plan.md om toelichtingen toe te voegen of details aan te passen. U kunt ook bijwerken tasks.json om taken te wijzigen, opnieuw te ordenen, toe te voegen of te verwijderen voordat u het plan uitvoert.

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

We waarderen uw invoer! Als u feedback hebt over de Moderniseringsagent, maakt u een issue aan in de GitHub Copilot AppMod-opslagplaats, of gebruikt u het feedbackformulier voor modernisering van GitHub Copilot.

  • Last updated on