GitHub Copilot Code-inzichten toevoegen aan web-app-evaluaties (preview)

In dit artikel wordt beschreven hoe u web-app-evaluaties kunt verbeteren door codescaninzichten toe te voegen met behulp van GitHub Copilot-evaluatie bij het moderniseren van toepassingen voor Azure Kubernetes Service (AKS) of Azure App Service. Door code-inzichten toe te voegen, kunt u de gereedheid van de migratie beter beoordelen en aanbevelingen krijgen voor migratiestrategieën op basis van de codewijzigingen die tijdens de scan zijn geïdentificeerd.

In dit artikel leert u het volgende:

• Code-inzichten toevoegen aan web-app-evaluaties
• Genereer een GitHub Copilot-evaluatierapport met behulp van ondersteunde methoden.
• Bekijk bijgewerkte evaluatie samen met code-inzichten.

U kunt code-inzichten toevoegen aan web-app-evaluatie met behulp van een van de volgende twee methoden:

• Uploaden met zip-bestand.
• Rapport aanvragen via GitHub

Codescanrapporten handmatig uploaden met behulp van een ZIP-bestand

Met deze methode moet u het codescanrapport handmatig genereren en uploaden als een Zip-bestand.

Vereiste voorwaarden

• Zorg ervoor dat er een web-app-evaluatie bestaat voor elke vereiste web-app, omdat codescanrapporten alleen kunnen worden toegevoegd aan een bestaande evaluatie.
• Zorg ervoor dat het GitHub Copilot-evaluatierapport gereed is voor web-apps die u wilt bijwerken.

GitHub Copilot-evaluatierapport genereren

Voer de volgende stappen uit om een rapport te genereren:

Opmerking

Als u een evaluatierapport wilt uploaden als een ZIP-bestand, gebruikt u rapporten van AppCAT CLI. Ondersteuning voor GitHub Copilot App Mod-rapporten wordt binnenkort toegevoegd.

1. AppCAT installeren:

   • Voor .NET gebruikt u de onderstaande opdracht dotnet tool install --global Microsoft.AppCAT.Tool voor gedetailleerde instructies . Zie Het globale .NET-hulpprogramma installeren.
   • Zie Een Java-project evalueren met behulp van AppCAT 7 voor hulp bij het beoordelen van Java-projecten.

2. AppCAT-rapporten genereren

   • Nadat u AppCAT hebt geïnstalleerd, genereert u rapporten voor alle geëvalueerde web-apps: Voor .NET-toepassingen gebruikt u de .NET CLI om toepassingen te analyseren. Zie Toepassingen analyseren met de .NET CLI voor meer informatie.
   • Voor Java-toepassingen: Als u AppCAT wilt uitvoeren op een java-voorbeeldproject, raadpleegt u AppCAT uitvoeren op een Voorbeeld-Java-project.

3. Maak een ZIP-bestand voor alle rapporten die u aan de evaluatie wilt toevoegen.

Een ZIP-bestand uploaden

1. Op de pagina Overzicht van Azure Migrate onder Besluiten en Plannen selecteer Evaluaties.
2. Zoek de evaluatie met het filter Workloads en selecteer deze.
3. Selecteer op de pagina Overzicht van de evaluatie onder Code-inzichten toevoegen de optie GitHub Copilot-evaluatie gebruiken.

4. Selecteer Een zip-bestand uploaden op de pagina Code-inzichten toevoegen.

5. Selecteer Bladeren en selecteer de locatie van het ZIP-bestand met rapporten die u wilt importeren en selecteer vervolgens Uploaden. Wacht totdat het uploaden en valideren is voltooid.

6. Bekijk in de lijst met web-apps, onder de vervolgkeuzelijst van het GitHub Copilot-evaluatierapport , de geüploade rapporten onder Geüpload vanuit een ZIP-bestand.

7. Selecteer het juiste rapport om toe te wijzen aan de bijbehorende web-app. Herhaal deze stappen voor alle vereiste web-apps.
8. Nadat de toewijzing is voltooid, selecteert u Toevoegen en wacht u totdat het proces is voltooid.

9. Nadat de mapping is voltooid, wordt de beoordeling gemarkeerd als verouderd. Selecteer Herberekenen om herberekening te starten.
10. Nadat de herberekening is voltooid, controleert u de bijgewerkte code-inzichten.

Rapport aanvragen via GitHub

Deze methode verbindt Azure Migrate met een GitHub-opslagplaats met behulp van de opgegeven verbindingsgegevens en maakt automatisch een probleem in die opslagplaats. Met behulp van de uitbreiding voor modernisering van gitHub Copilot-apps kunt u uw code scannen en rapporten rechtstreeks uploaden naar het gerelateerde GitHub-probleem. Na het bijwerken van het probleem koppelt Azure Migrate automatisch de codescanrapporten aan de bijbehorende webtoepassingen. Met deze aanpak kunnen cloudbeheerders en ontwikkelaars samenwerken terwijl ze de grenzen van de beveiliging van toepassingscode behouden.

Vereiste voorwaarden

• Zorg ervoor dat er een web-app-evaluatie bestaat voor elke web-app, omdat codescanrapporten alleen kunnen worden toegevoegd aan een bestaande evaluatie.
• Geef informatie op over de GitHub-opslagplaats die is vereist voor integratie met Azure Migrate om automatische aanvragen en synchronisatie van codescanrapporten toe te staan.
• Geef gitHub-toepassingsgegevens op met machtigingen voor het maken van problemen en het lezen van opmerkingen in de doelopslagplaats.

Nieuwe GitHub-app maken

Maak een nieuwe GitHub-app door de volgende stappen uit te voeren:

1. Selecteer uw profielfoto in de rechterbovenhoek van de GitHub-pagina.
2. Navigeer naar uw accountinstellingen.
   • Selecteer Instellingen voor een app die eigendom is van een persoonlijk account.
     • Selecteer Uw organisatie en vervolgens Instellingen rechts van de organisatie.
   • Voor een app die eigendom is van een onderneming:
     • Als u Beheerde gebruikers voor ondernemingen gebruikt, selecteert u Uw onderneming om rechtstreeks naar de ondernemingsaccountinstellingen te gaan.
     • Als u persoonlijke accounts gebruikt, selecteert u Uw ondernemingen en selecteert u vervolgens instellingen rechts van de onderneming.
3. Navigeer naar de instellingen van de GitHub-app .
   • Voor een app die eigendom is van een persoonlijk account of organisatie:
     • Selecteer in de linkerzijbalk de instellingen voor ontwikkelaars en selecteer vervolgens GitHub-apps.
   • Voor een app die eigendom is van een onderneming
     • Selecteer in de linkerzijbalk onder Instellingen de optie GitHub-apps en selecteer vervolgens Nieuwe GitHub-app.

4. Geef de volgende gegevens op om uw nieuwe GitHub-app in te stellen:
5. Voer onder de naam van de GitHub-app een naam in voor uw app.
6. Geef onder Startpagina-URL de volledige URL op. Deze URL fungeert als tijdelijke aanduiding en wordt niet gebruikt in dit proces.

7. Zorg ervoor dat verlopen gebruikersautorisatietokens is geselecteerd.
8. Schakel Actief uit onder Webhook

9. Selecteer onder Machtigingenopslagplaatsmachtigingen en selecteer vervolgens de volgende machtigingen voor de app.

Issues	Lezen en schrijven
Metagegevens	Read-only
Webhaak	Lezen en schrijven

10. Selecteer onder Waar kan deze GitHub-app worden geïnstalleerd?, selecteer Alleen voor dit account of Een account.

11. Selecteer GitHub-app maken.

GitHub-app installeren in de opslagplaats

Volg deze stappen om de GitHub-app in uw opslagplaats te installeren:

1. Navigeer naar de GitHub-app die u hebt gemaakt.
2. Selecteer App installeren
3. Selecteer een account om de app te installeren en selecteer vervolgens Installeren. Gebruik het account dat de opslagplaats bevat voor het maken van problemen en het uploaden van codescanrapporten.

4. Selecteer Alleen opslagplaatsen selecteren en vervolgens de juiste opslagplaatsen selecteren in Opslagplaatsen selecteren. U kunt meerdere opslagplaatsen selecteren. Wanneer u klaar bent, selecteert u Installeren.

   

5. Nadat de installatie is voltooid, noteert u de browser-URL die de installatie-id bevat. Bijvoorbeeld: https://github.com/settings/installations/<installationID>

Details van GitHub-app en persoonlijke sleutel voor het maken van een GitHub-verbinding

Verzamel en orden de volgende GitHub App-details en privésleutel om een GitHub-verbinding te maken in Azure Migrate.

1. Navigeer naar de GitHub-app die u hebt gemaakt en selecteer Bewerken.
2. Zoek onder Algemeen>Over naar de App ID en noteer deze.
3. Schuif omlaag naar persoonlijke sleutels en selecteer Een persoonlijke sleutel genereren.

Opmerking

Draai de persoonlijke sleutel elke 90 dagen voor beveiliging. Als u een nieuwe persoonlijke sleutel genereert, moet u de verbinding opnieuw maken omdat het bijwerken van de sleutel momenteel niet wordt ondersteund.

4. Het nieuwe persoonlijke sleutelbestand wordt automatisch naar uw computer gedownload.
5. Als u de installatie-id wilt vinden, gaat u naar App installeren en selecteert u Instellingen naast het account waarop de app is geïnstalleerd.
6. Nadat de installatie is voltooid, noteert u de browser-URL die de installatie-id bevat. Bijvoorbeeld https://github.com/settings/installations/<installationID>

Scanrapport van de code aanvragen voor web-app-evaluatie via GitHub

1. Selecteer Evaluaties op de overzichtspagina van het Azure Migrate-project onder Bepalen en Plannen.
2. Zoek de evaluatie met het filter Workloads en selecteer deze.
3. Op de overzichtspagina van de evaluatie.
4. Selecteer onder Code-inzichten toevoegen de optie GitHub Copilot-evaluatie gebruiken.

5. Selecteer Op de pagina Code-inzichten toevoegen de optie GitHub-verbinding maken .

6. Geef op de pagina Nieuwe GitHub-verbinding maken de volgende details op:

Veld	Bijzonderheden
Verbindingsnaam	Geef een naam op voor de verbinding. Deze naam wordt weergegeven in de lijst wanneer u een rapport toevoegt aan de web-app.
URL van GitHub-opslagplaats	Geef de GitHub-opslagplaats op voor het maken van een probleem om een codescanrapport aan te vragen. Upload het codescanrapport naar dit probleem met behulp van GitHub Copilot. Gebruik deze opslagplaats alleen om GitHub-problemen te maken en codescanrapporten van deze problemen te lezen. U hoeft geen toepassingscode op te nemen in deze opslagplaats.
App-id	Voer de app-id in van de GitHub-app die u hebt gemaakt om Toegang tot Azure Migrate toe te staan.
Persoonlijke sleutel	Kopieer alle inhoud van het persoonlijke sleutelbestand dat u hebt gegenereerd voor uw GitHub-app.
Installatie-id	Voer de installatie-id in van de GitHub-app die is geïnstalleerd in de opslagplaats die u hierboven hebt opgegeven.

7. Nadat u de details hebt toegevoegd, selecteert u Verbinding maken . Wacht totdat de verbinding is gemaakt en selecteer vervolgens Sluiten.
8. Selecteer op de pagina Code-inzicht toevoegen in de web-app, in de lijst, Rapport aanvragen via GitHub.
9. Selecteer in het aanvraagrapport via GitHub de juiste verbindingsnaam en selecteer vervolgens Aanvraag.

10. Azure Migrate maakt een GitHub-probleem in de opslagplaats die is opgegeven in de verbindingsgegevens.
11. Wanneer het codescanrapport wordt geüpload naar het GitHub-probleem, wijst Azure Migrate het rapport automatisch toe aan de web-app.
12. Nadat het rapport in kaart is gebracht, wordt de evaluatie als verouderd gemarkeerd.
13. Bereken de evaluatie opnieuw om verbeterde resultaten weer te geven met code-inzichten.

Codescanrapport genereren met behulp van de uitbreiding voor modernisering van GitHub Copilot-apps

Volg de stappen om een rapport te genereren:

1. Als u een rapport voor .NET wilt genereren, volgt u deze stappen om een .NET-project te evalueren en te migreren met GitHub Copilot voor de modernisering van .NET-apps.
2. Als u een codescanrapport voor Java wilt genereren, volgt u deze stappen om een Java-project te evalueren met behulp van de modernisering van gitHub Copilot-apps.
3. Zodra het rapport beschikbaar is, uploadt u het rapport naar een GitHub-probleem met behulp van de onderstaande prompt in GitHub Copilot.
4. evaluatierapport uploaden naar [URL van gitHub-probleem]

Code-inzichten weergeven na het toevoegen van codescanrapporten

1. Selecteer Evaluaties op de overzichtspagina van het Azure Migrate-project onder Bepalen en Plannen.
2. Zoek de evaluatie met het filter Workloads en selecteer deze.
3. Selecteer op de pagina Overzicht van evaluatie het tabblad Aanbevolen pad of Bekijk details in het aanbevolen padrapport.
   In dit scherm wordt de distributie van web-apps over Azure-doelen weergegeven. Selecteer een item om verder te onderzoeken.
4. In dit scherm wordt de distributie van de web-apps over de Azure-doelen weergegeven. Selecteer een item om verder te onderzoeken.
5. Selecteer Codewijzigingen weergeven onder Code-inzichten . Controleer de codewijzigingen door het relevante tabblad te selecteren: Problemen, waarschuwingen of informatie. Deze tabbladen bieden een overzicht van codewijzigingen in de web-apps in de evaluatie.
6. Selecteer het nummer in de kolom Codewijzigingen voor de desbetreffende web-app om de wijzigingen ervan weer te geven.

Nadat u codescanrapporten hebt toegevoegd, kan de gereedheids- en migratiestrategie voor de relevante web-app worden gewijzigd op basis van de geïdentificeerde codewijzigingen. Als de vereiste codewijzigingen aanzienlijk zijn, kan de gereedheid van de web-app worden bijgewerkt van Gereed naar Gereed met voorwaarden.

Probleemoplossingsproces

Deze sectie helpt bij het oplossen van problemen met betrekking tot het importeren van paden of het uploaden van zip-bestanden die niet voldoen aan de vereiste beperkingen.

Uploaden met zip-bestand

1. Wanneer het uploaden van rapporten als zip-bestand is mislukt: volg deze richtlijnen om paden te importeren en zip-bestanden zonder fouten te uploaden.

Kan geen zip-bestanden verwerken die voldoen aan deze vereisten:

• Bevat alleen JSON-bestanden.
• Zip-bestand is minder dan 50 MB.
• Het totale aantal bestanden in een ZIP-bestand is kleiner dan 100.
• De maximale grootte van niet-gecomprimeerd zip-bestand is minder dan 500 MB.
• Zip-bestand bevat geen andere geneste zip-bestanden.

Er kunnen fouten optreden als het geüploade ZIP-bestand niet voldoet aan de vereiste beperkingen. Hieronder volgen een aantal voorbeelden:

• Het geüploade blob-inhoudstype '%Value;' wordt niet ondersteund. - Treedt op wanneer het geüploade bestand geen zip-bestand is.
• Zip bevat te veel bestanden (%FileCount;). Limiet is %MaxFileCount;. - Treedt op wanneer het zip-bestand meer dan 100 bestanden bevat.
• Totale niet-gecomprimeerde grootte %UncompressedSize; MB van geüpload zip-bestand overschrijdt de limiet van %MaxUncompressedSize; MB. - Treedt op wanneer de niet-gecomprimeerde grootte van het zip-bestand groter is dan 500 MB.
• Zip-vermelding '%EntryName;' is ongeldig (mogelijke paddoorkruising). - Treedt op wanneer een bestandsnaam in de zip padoverschrijdende tekens bevat, zoals ../../.
• Het geüploade ZIP-bestand is leeg en bevat geen geldige bestanden. - Treedt op wanneer het zip-bestand geen bestanden bevat.

Als u een van deze fouten ziet, verwijdert u de ongeldige of extra bestanden en maakt u het zip-bestand opnieuw voordat u het opnieuw uploadt.

2. Gedeeltelijke bestanden of geen bestanden die zijn geaccepteerd voor het genereren van rapporten: zelfs als het zip-bestand voldoet aan alle richtlijnen en wordt verwerkt, ziet u mogelijk niet de rapporten voor elk bestand in de zip. Dit kan gebeuren vanwege problemen zoals incompatibiliteit van het JSON-schema of niet-ondersteunde doelen in het rapportbestand. Wanneer dit gebeurt, gebruikt Azure Migrate inhoud van geldige bestanden om het rapport te genereren. Bestanden waarvoor validatie mislukt, retourneren fouten zoals:

• De rapportinhoud is ongeldig of niet in de verwachte JSON-indeling. - Treedt op wanneer het JSON-rapportschema ongeldig of niet compatibel is.
• Het rapport bevat geen ondersteunde doelen voor het opgegeven framework. - Vindt plaats wanneer het rapport doelen bevat die niet worden ondersteund door Azure Migrate. AppCAT ondersteunt veel doelen, maar Azure Migrate ondersteunt alleen een subset.

Wanneer u deze fouten tegenkomt, genereert u het rapport opnieuw met de juiste configuratie en uploadt u het opnieuw met behulp van een afzonderlijke importstroom.

Volgende stappen

Meer informatie over het maken van een web-app-evaluatie.