Surveiller les mises à niveau avec le tableau de bord de mise à niveau

Le tableau de bord de mise à niveau fournit une vue visuelle d’une session de mise à niveau GitHub Copilot. L’interface utilisateur étiquette le panneau Mise à niveau du code. Utilisez le tableau de bord pour :

  • Suivez la progression et les échecs des tâches en temps réel.
  • Passez en revue les résultats de l’évaluation et les problèmes obligatoires.
  • Inspectez la compatibilité des packages NuGet.
  • Vérifiez la stratégie et les paramètres de mise à niveau.
  • Publiez l’évaluation en tant que gist de GitHub privé pour la révision de l’équipe.

Dans le application Copilot GitHub pour le bureau, le tableau de bord s’ouvre en tant que panneau latéral. Dans d’autres environnements, tels que l’interface CLI GitHub Copilot ou un IDE, elle s’ouvre dans votre navigateur.

Ouvrir le tableau de bord

Lorsque vous démarrez une session de mise à niveau, Copilot peut ouvrir automatiquement le tableau de bord. Si le tableau de bord ne s'ouvre pas, demandez Copilot l'afficher dans votre invite initiale ou pendant une session de mise à niveau active.

Exemples de prompts :

  • « Afficher le tableau de bord de mise à niveau ».
  • « Mettez à niveau ma solution vers .NET 10 et affichez le tableau de bord. »

Le tableau de bord s’ouvre dans le volet latéral ou le navigateur, en fonction des GitHub Copilot client que vous utilisez.

Explorer le tableau de bord

Utilisez les huit onglets de la barre de navigation supérieure pour inspecter différentes parties de la mise à niveau. L’en-tête affiche la progression globale des tâches sous chaque onglet.

Tab Purpose
Vue d’ensemble Résume la session de mise à niveau.
Scénario Affiche le scénario actif et ses phases.
Tâches Effectue le suivi du plan de mise à niveau et des tâches individuelles.
Projets Répertorie les projets, les infrastructures cibles et les incidents d’évaluation.
dépendances Package de rapports et compatibilité de référence.
Évaluation Présente les résultats de l’évaluation codebase.
Options Affiche la stratégie et les paramètres de mise à niveau actuels.
Activité Enregistre les modifications de fichier, les validations et les événements de génération.

Onglet Vue d’ensemble

L’onglet Vue d’ensemble s’ouvre par défaut et récapitule la session de mise à niveau. La carte de scénario affiche :

  • Nom du scénario, tel que dotnet-version-upgrade.
  • Les monikers de framework cible actuels et cibles (TFM), tels que net472 et net10.0.
  • Progression globale.
  • Phases terminées et actives.

La section En un clin d’œil affiche les statistiques suivantes :

  • Tâches terminées : tâches terminées, tâches totales et tâches en cours.
  • Projets évalués : nombre de fichiers projet découverts dans le référentiel.
  • Incidents d’évaluation : violations de règles individuelles dans tous les projets.
  • Règles obligatoires : problèmes que l’agent doit résoudre avant de pouvoir terminer la mise à niveau.
  • Packages NuGet : packages distincts dans la solution que l’agent analyse sur l’infrastructure cible.
  • Packages incompatibles : packages qui ne prennent pas en charge l’infrastructure cible.

Capture d’écran de l’onglet Vue d’ensemble du tableau de bord de mise à niveau.

Onglet Scénario

L’onglet Scénario répertorie le scénario actif et tous les scénarios disponibles pour le référentiel. Utilisez les sous-onglets Active et All pour basculer entre ces vues.

Le sous-onglet Actif affiche l’ID de scénario, tel que DOTNET-VERSION-UPGRADE, et la transition TFM, par net472 exemple .net10.0 Il décrit également l’objectif et l’approche du scénario.

Le pipeline de phase affiche l’état de chaque phase de mise à niveau. Une coche identifie une phase terminée, et un point identifie la phase actuelle.

Capture d’écran de l’onglet Scénario de mise à niveau du tableau de bord.

Onglet Tâches

L’onglet Tâches affiche le plan de mise à niveau et chaque tâche dans le scénario actuel. Les vignettes récapitulatives indiquent le nombre total, complet, en cours et le nombre de tâches ayant échoué. Une barre de progression signale le pourcentage d’achèvement et identifie le scénario.

La section Vue d’ensemble explique la stratégie de mise à niveau, y compris l’ordre et la séquence du projet. Sous la vue d’ensemble, une liste hiérarchisée et hiérarchisée utilise des icônes et des styles de texte pour identifier l’état de la tâche :

  • Coche : Terminé. Le tableau de bord coupe l’étiquette de tâche.
  • Spinner : En cours. Le tableau de bord affiche l’étiquette de tâche en gras.
  • Carré : En attente.

Capture d’écran de l’onglet Mettre à niveau les tâches du tableau de bord.

Onglet Projets

L’onglet Projets répertorie chaque .csproj fichier du .fsproj référentiel avec ses données d’évaluation. Les vignettes récapitulatives signalent le nombre total de projets, les tfms mis à niveau et les incidents d’évaluation.

Un incident représente un emplacement de code qui a déclenché une règle d’évaluation. Sélectionnez un nombre d’incidents pour inspecter les problèmes de ce projet.

Utilisez la table ou le graphique pour modifier l’affichage. Le tableau comprend les colonnes suivantes :

  • Project : nom de project et chemin d’accès au fichier.
  • Framework : Framework cible actuel.
  • Type : type de projet, tel que ClassicWinForms ou ClassicClassLibrary.
  • Incidents : nombre d’incidents.

Le graphique affiche des projets sous forme de nœuds et de références de projet en tant que connexions.

Capture d’écran de l’onglet Mettre à niveau des projets de tableau de bord.

Onglet Dépendances

L’onglet Dépendances indique si les packages NuGet de la solution et les références prennent en charge l’infrastructure cible. La carte Cible d’analyse des dépendances identifie le TFM cible et le nombre de projets analysés.

Les vignettes récapitulatives signalent ces types de dépendances et conditions :

  • Packages NuGet : packages NuGet distincts dans la solution.
  • Dérive de version : packages qui utilisent différentes versions entre les projets.
  • Références d’assembly : références directes, telles que des assemblys GLOBAL Assembly Cache (GAC) ou des fichiers DLL distincts.
  • Project références : <ProjectReference> relations entre les projets.
  • Références d’infrastructure : <FrameworkReference> entrées dans des projets de style SDK, telles que Microsoft.AspNetCore.App.

Une barre de compatibilité regroupe les packages en tant que packages valides, partiels, incompatibles ou inconnus. Le tableau de bord affiche le chemin source dependencies-health.json sous la barre.

Le tableau de packages répertorie les noms de package, les projets, les versions installées, les versions recommandées et la compatibilité. Pour un package incompatible, sélectionnez Expliquer pour demander à l’agent des détails dans la conversation.

Capture d’écran de l’onglet Mettre à niveau les dépendances du tableau de bord.

Onglet Évaluation

L’onglet Évaluation signale la compatibilité du codebase avec l’infrastructure cible. Les vignettes récapitulatives affichent des totaux de projet, de problème, d’incident, de problème obligatoire et d’effort. Les vignettes de catégorie identifient les trois groupes d’incidents les plus importants.

Deux graphiques à barres regroupent les incidents :

  • Par gravité : regroupe les incidents comme obligatoires, facultatifs, potentiels ou informationnels.
  • Par catégorie : regroupe les incidents par zones telles que l’API, NuGet et la configuration du projet.

Utilisez les sous-onglets Résumé, Problèmes et Fonctionnalités pour modifier le niveau de détail. Le résumé fournit un rapport de narration sur la compatibilité des projets, des packages et des API. Les problèmes et fonctionnalités fournissent des répartitions individuelles.

Pour afficher la date et la version de l’évaluation, sélectionnez l’icône d’informations . Pour publier l’évaluation en tant que gist de GitHub privé, sélectionnez l’icône Partager.

Capture d’écran de l’onglet Mettre à niveau l’évaluation du tableau de bord.

Onglet Options

L’onglet Options affiche la configuration de mise à niveau actuelle. La plupart des paramètres sont en lecture seule, mais l’onglet fournit un contrôle pour modifier le mode de flux. Pour modifier d’autres préférences prises en charge, demandez à l’agent dans la conversation.

L’onglet contient trois sections :

  • La stratégie montre la stratégie sélectionnée, telle que Bottom-Up (Dependency-First). Il explique également pourquoi l’agent a choisi cette stratégie pour la solution.
  • Les contraintes d’exécution répertorient des règles telles que l’ordre de niveau, la validation entre les niveaux et d’autres exigences d’exécution.
  • Les préférences répertorient l’infrastructure cible, le mode flux, la stratégie de validation et le rythme.

Pour le mode Flux, sélectionnez Basculer vers Guidé ou Basculer vers Automatique. Le tableau de bord envoie la demande à l’agent.

Le framework cible peut inclure un suffixe de plateforme. Par exemple, une application WPF peut cibler net10.0-windows au lieu de net10.0.

Capture d’écran de l’onglet Options de mise à niveau du tableau de bord.

Onglet Activité

L’onglet Activité fournit un journal horodaté des actions de l’agent. Pendant une session active, le journal est mis à jour en temps réel et place de nouveaux événements en haut. Le panneau affiche également le chemin d’accès source activity.jsonl .

Utilisez les sous-onglets Journal, Commits et By pour passer en revue l’activité. Chaque entrée de journal inclut les éléments suivants :

  • Horodatage : date et heure auxquelles l’événement s’est produit.
  • Type d’événement : action, telle qu’une modification de fichier, une validation ou une session de génération terminée.
  • Détails : chemin d’accès au fichier associé ou message de validation.
  • Différences de ligne : nombre de lignes ajoutées ou supprimées dans un événement de fichier.

Capture d’écran de l’onglet Mettre à niveau l’activité du tableau de bord.

Limitations

  • Accédez au tableau de bord uniquement via l’application GitHub Copilot pour le bureau ou l’interface CLI GitHub Copilot.
  • Modifiez les préférences prises en charge par le biais de la conversation ou des contrôles de l’agent sous l’onglet Options . Le tableau de bord ne fournit pas d’accès direct à d’autres paramètres de session.
  • Démarrez une session de mise à niveau avant de vous attendre à ce que le tableau de bord affiche les données. Un référentiel sans artefacts de mise à niveau affiche un état vide.
  • Conservez l’agent actif pour les mises à jour actives sous l’onglet Activité . Une session terminée ou arrêtée affiche uniquement les événements historiques.

Contenu connexe

  • Last updated on