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:

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

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. 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.
  4. Selecteer evaluatiedomeinen, zoals Java upgrade en Cloud Readiness en druk op Enter.
  5. 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.
  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. 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

Uw input is belangrijk! Als u feedback hebt over de moderniseringsagent, maak dan een probleem op in de opslagplaats github-copilot-appmod of gebruik het GitHub Copilot feedbackformulier voor modernisering.

  • Last updated on