Upgrades bewaken met het upgradedashboard

Het upgradedashboard biedt een visuele weergave van een GitHub Copilot upgradesessie. De gebruikersinterface labelt het deelvenster Code Upgrade. Gebruik het dashboard voor het volgende:

  • De voortgang en fouten van taken in realtime bijhouden.
  • Beoordelingsresultaten en verplichte problemen.
  • Controleer de compatibiliteit van NuGet-pakketten.
  • Controleer de upgradestrategie en -instellingen.
  • Publiceer de evaluatie als een privé-GitHub voor teambeoordeling.

In de GitHub-Copilot-app voor bureaublad wordt het dashboard geopend als een zijpaneel. In andere omgevingen, zoals de GitHub Copilot CLI of een IDE, wordt deze in uw browser geopend.

Het dashboard openen

Wanneer u een upgradesessie start, kan Copilot het dashboard automatisch openen. Als het dashboard niet wordt geopend, vraagt u Copilot om het weer te geven in uw eerste prompt of tijdens een actieve upgradesessie.

Voorbeeldprompts:

  • 'Het upgradedashboard weergeven'.
  • 'Upgrade mijn oplossing naar .NET 10 en geef het dashboard weer.'

Het dashboard wordt geopend in het zijpaneel of de browser, afhankelijk van de GitHub Copilot client die u gebruikt.

Het dashboard verkennen

Gebruik de acht tabbladen in de bovenste navigatiebalk om verschillende onderdelen van de upgrade te controleren. In de koptekst wordt de algehele taakvoortgang op elk tabblad weergegeven.

Tab Purpose
Overzicht Geeft een overzicht van de upgradesessie.
Scenario Toont het actieve scenario en de bijbehorende fasen.
Taken Houdt het upgradeplan en afzonderlijke taken bij.
Projecten Toont projecten, doelframeworks en evaluatie-incidenten.
afhankelijkheden Rapportenpakket en referentiecompatibiliteit.
Beoordeling Geeft resultaten van evaluatie op basis van code weer.
Opties Toont de huidige upgradestrategie en -instellingen.
Activiteit Registreert bestandswijzigingen, doorvoeringen en build-gebeurtenissen.

tabblad Overzicht

Het tabblad Overzicht wordt standaard geopend en geeft een overzicht van de upgradesessie. De scenariokaart toont:

  • De scenarionaam, zoals dotnet-version-upgrade.
  • De huidige en doeldoelframework monikers (TFM's), zoals net472 en net10.0.
  • Algemene voortgang.
  • Voltooide en actieve fasen.

In de sectie In één oogopslag worden deze statistieken weergegeven:

  • Voltooide taken: Voltooide taken, totaal aantal taken en actieve taken.
  • Geëvalueerde projecten: het aantal projectbestanden dat in de opslagplaats is gedetecteerd.
  • Beoordelingsincidenten: schendingen van afzonderlijke regels voor alle projecten.
  • Verplichte regels: problemen die de agent moet oplossen voordat de upgrade kan worden voltooid.
  • NuGet-pakketten: Afzonderlijke pakketten in de oplossing die de agent analyseert op basis van het doelframework.
  • Incompatibele pakketten: pakketten die het doelframework niet ondersteunen.

Schermopname van het tabblad Overzicht van het upgradedashboard.

Tabblad Scenario

Het tabblad Scenario bevat het actieve scenario en alle scenario's die beschikbaar zijn voor de opslagplaats. Gebruik de subtabbladen Actief en Alle om tussen deze weergaven te schakelen.

In het subtabblad Actief ziet u de scenario-id, zoals DOTNET-VERSION-UPGRADE, en de TFM-overgang, bijvoorbeeld net472net10.0. Ook wordt het doel en de benadering van het scenario beschreven.

De fasepijplijn toont de status van elke upgradefase. Een vinkje identificeert een voltooide fase en een punt identificeert de huidige fase.

Schermopname van het tabblad Scenario upgradedashboard.

Tabblad Taken

Op het tabblad Taken ziet u het upgradeplan en elke taak in het huidige scenario. Overzichttegels rapporteren totaal, voltooid, in uitvoering en mislukte taakaantallen. Een voortgangsbalk rapporteert het voltooiingspercentage en identificeert het scenario.

In de sectie Overzicht wordt de upgradestrategie uitgelegd, inclusief projectvolgorde en -volgorde. Onder het overzicht gebruikt een genummerde, hiërarchische lijst pictogrammen en tekststijlen om de taakstatus te identificeren:

  • Vinkje: Voltooid. Het dashboard snijdt het taaklabel door.
  • Spinner: Wordt uitgevoerd. In het dashboard wordt het taaklabel vet weergegeven.
  • Vierkant: In behandeling.

Schermopname van het tabblad Dashboardtaken bijwerken.

Tabblad Projecten

Het tabblad Projecten bevat elk .csproj bestand en .fsproj bestand in de opslagplaats met de bijbehorende evaluatiegegevens. Overzichttegels rapporteren de totale projecten, bijgewerkte TFM's en evaluatie-incidenten.

Een incident vertegenwoordigt één codelocatie die een evaluatieregel heeft geactiveerd. Selecteer een aantal incidenten om de problemen voor dat project te controleren.

Gebruik Tabel of Grafiek om de weergave te wijzigen. De tabel bevat de volgende kolommen:

  • Project: de naam en het bestandspad van de project.
  • Framework: Het huidige doelframework.
  • Soort: Het projecttype, zoals ClassicWinForms of ClassicClassLibrary.
  • Incidenten: het aantal incidenten.

In de grafiek worden projecten weergegeven als knooppunten en projectverwijzingen als verbindingen.

Schermopname van het tabblad Dashboardprojecten bijwerken.

Tabblad Afhankelijkheden

Het tabblad Afhankelijkheden rapporteert of de NuGet-pakketten en verwijzingen van de oplossing ondersteuning bieden voor het doelframework. De kaart Afhankelijkheidsanalysedoel identificeert de DOEL TFM en het aantal geanalyseerde projecten.

Overzichttegels rapporteren deze afhankelijkheidstypen en -voorwaarden:

  • NuGet-pakketten: Afzonderlijke NuGet-pakketten in de oplossing.
  • Versiedrift: Pakketten die verschillende versies in projecten gebruiken.
  • Assemblyverwijzingen: directe verwijzingen, zoals GAC-assembly's (Global Assembly Cache) of afzonderlijke DLL-bestanden.
  • Project verwijzingen: <ProjectReference> relaties tussen projecten.
  • Frameworkverwijzingen: <FrameworkReference> vermeldingen in SDK-projecten, zoals Microsoft.AspNetCore.App.

Een compatibiliteitsbalk groepeert pakketten als Geldig, Gedeeltelijk, Incompatibel of Onbekend. In het dashboard wordt het bronpad dependencies-health.json onder de balk weergegeven.

De pakkettabel bevat pakketnamen, projecten, geïnstalleerde versies, aanbevolen versies en compatibiliteit. Voor een incompatibel pakket selecteert u Uitleg om de agent te vragen om details in de chat.

Schermopname van het tabblad Dashboardafhankelijkheden bijwerken.

Tabblad Evaluatie

Het tabblad Evaluatie rapporteert codebasiscompatibiliteit met het doelframework. Overzichtstegels bevatten project-, probleem-, incident-, verplicht probleem- en inspanningtotalen. Categorietegels identificeren de drie grootste incidentgroepen.

Twee staafdiagrammen groeperen incidenten:

  • Op ernst: groepen incidenten als verplicht, optioneel, potentieel of informatief.
  • Op categorie: Groepen incidenten op gebieden zoals API, NuGet en projectconfiguratie.

Gebruik de subtabbladen Samenvatting, Problemen en Onderdelen om het detailniveau te wijzigen. Samenvatting bevat een verhaalrapport over project-, pakket- en API-compatibiliteit. Problemen en functies bieden afzonderlijke uitsplitsingen.

Als u de evaluatiedatum en -versie wilt bekijken, selecteert u het infopictogram. Als u de evaluatie wilt publiceren als een persoonlijke GitHub gist, selecteert u het pictogram Delen.

Schermopname van het tabblad Evaluatie van dashboard upgraden.

Tabblad Opties

Op het tabblad Opties ziet u de huidige upgradeconfiguratie. De meeste instellingen zijn alleen-lezen, maar het tabblad biedt een besturingselement om de stroommodus te wijzigen. Als u andere ondersteunde voorkeuren wilt wijzigen, vraagt u de agent in de chat.

Het tabblad bevat drie secties:

  • Strategie toont de geselecteerde strategie, zoals Bottom-Up (Dependency-First). Ook wordt uitgelegd waarom de agent die strategie voor de oplossing heeft gekozen.
  • Uitvoeringsbeperkingen bevatten regels zoals laagvolgorde, validatie tussen lagen en andere uitvoeringsvereisten.
  • Voorkeuren bevatten het doelframework, de stroommodus, de doorvoerstrategie en het tempo.

Voor de stroommodus selecteert u Overschakelen naar Begeleide modus of overschakelen naar Automatisch. Het dashboard verzendt de aanvraag naar de agent.

Het doelframework kan een platformachtervoegsel bevatten. Een WPF toepassing kan bijvoorbeeld worden gericht net10.0-windows in plaats van net10.0.

Schermopname van het tabblad Opties voor upgradedashboard.

Tabblad Activiteit

Het tabblad Activiteit bevat een tijdstempellogboek van agentacties. Tijdens een actieve sessie worden de logboekupdates in realtime bijgewerkt en worden bovenaan nieuwe gebeurtenissen geplaatst. In het deelvenster wordt ook het bronpad activity.jsonl weergegeven.

Gebruik de subtabbladen Logboek, Doorvoeringen en Op bestand om de activiteit te controleren. Elke logboekvermelding omvat:

  • Tijdstempel: de datum en tijd waarop de gebeurtenis heeft plaatsgevonden.
  • Gebeurtenistype: De actie, zoals een bestandswijziging, doorvoer of voltooide buildsessie.
  • Details: het bijbehorende bestandspad of doorvoerbericht.
  • Regelverschil: het aantal regels dat is toegevoegd of verwijderd in een bestandsevenement.

Schermopname van het tabblad Dashboardactiviteit upgraden.

Limitations

  • Open het dashboard alleen via de GitHub Copilot-app voor bureaublad of de GitHub Copilot CLI.
  • Wijzig ondersteunde voorkeuren via de chat of besturingselementen van de agent op het tabblad Opties . Het dashboard biedt geen directe toegang tot andere sessie-instellingen.
  • Start een upgradesessie voordat u verwacht dat het dashboard gegevens weergeeft. Een opslagplaats zonder upgradeartefacten geeft een lege status weer.
  • Houd de agent actief voor live-updates op het tabblad Activiteit . In een voltooide of gestopte sessie worden alleen historische gebeurtenissen weergegeven.