Partager via

Renommer un projet dans Azure DevOps

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Renommer un projet dans Azure DevOps met à jour le nom du projet dans les chemins de gestion de version, les éléments de travail, les requêtes et d’autres artefacts du projet. Vous pouvez renommer un projet plusieurs fois et utiliser les anciens noms. Certaines actions peuvent être requises des membres de l’équipe après avoir renommé le projet.

Warning

  • Au moment de renommer un projet, Azure DevOps notifie tous les membres du projet par e-mail si le nombre d’utilisateurs est inférieur à 1 000. Pour les projets avec plus de 1 000 utilisateurs, seuls les administrateurs de la collection de projets reçoivent ces notifications.

  • Renommer un projet rompt les sujets de fédération d'identité de charge de travail dans les connexions de service Azure Resource Manager.

Prerequisites

Catégorie Exigences
Permissions Membre du groupe Administrateurs du projet ou autorisation Renommer le projet d’équipe au niveau du projet définie sur Autoriser. Pour plus d’informations, consultez Modifier les autorisations au niveau du projet.

Renommer un projet

  1. Connectez-vous à votre projet (https://dev.azure.com/{Your_Organization}/{Your_Project}).

  2. Sélectionnez Paramètres du projet>Vue d'ensemble, puis entrez un nouveau nom et sélectionnez Enregistrer.

    Capture d’écran montrant la nouvelle entrée de nom et le bouton Enregistrer mis en surbrillance.

  3. Pour confirmer le renommage, entrez le nouveau nom du projet, cochez la case à côté de « Je comprends les conséquences du changement de nom de ce projet », puis sélectionnez Enregistrer.

    Capture d’écran montrant l’écran de confirmation du nouveau nom avec le bouton Enregistrer.

Résultats du renommage

Les résultats suivants apparaissent après l'opération de renommage.

  • Azure DevOps renomme le projet.

  • Tous les membres du projet reçoivent une notification par e-mail du changement de nom, si moins de 1 000 membres.

  • L’URL continue de fonctionner pour le nouveau nom de l’équipe et l’ancien nom de l’équipe. Cette fonctionnalité est destinée à éviter de rompre les liens.

  • Si le projet dans l’URL est un projet valide dans l’organisation, nous affichons l’ID d’élément de travail fourni. L’exemple suivant montre une organisation avec des projets nommés « Example1 » et « Example2 ».

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - Affiche l’élément de travail 40 https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ - Affiche l’élément de travail 40 https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ - Affiche une erreur 404

  • Les ID d’élément de travail sont uniques dans l’organisation et, par conséquent, les liens n’expirent pas.

  • L’ancien nom du projet peut être utilisé à nouveau.

Actions utilisateur requises pour travailler avec le projet renommé

Chaque utilisateur au sein de votre équipe doit redémarrer ses clients et effectuer certaines des actions suivantes, en fonction des fonctionnalités qu’ils utilisent :

Redémarrer les clients

Les clients ouverts conservent un cache de tous les noms de projet en mémoire, mais ce cache n’est pas automatiquement effacé une fois qu’un projet est renommé. Pour effacer le cache, redémarrez votre client afin qu’il remplisse le nouveau nom du projet. Si vous ne redémarrez pas le client, les opérations qui utilisent le nom du projet mis en cache échouent avec une exception Projet introuvable.

Pour les clients suivants, enregistrez votre travail dans chacun d’eux, puis redémarrez :

Mise à jour des communications à distance de Git

Si votre projet utilise Git, vos références distantes pour chaque référentiel du projet renommé doivent alors être mises à jour. Ces mises à jour sont nécessaires, car l’URL dépôt distant contient le projet et le nom du référentiel. Git utilise des références distantes pour récupérer (fetch) et envoyer (push) les modifications entre votre dépôt local et la version distante stockée sur le serveur. Chaque membre de votre équipe doit mettre à jour ses dépôts Git locaux pour continuer de se connecter à partir de ses machines de développement.

Pour plus d’informations, consultez Mettre à jour les Git distants sur vos machines de développement.

Mettre à jour les espaces de travail du serveur TFVC

Si votre projet utilise TFVC avec des espaces de travail serveur, ces espaces de travail doivent être mis à jour avec le nouveau nom du projet. Pour les clients Visual Studio, exécutez un get ou un check in et le mappage de l'espace de travail sera corrigé pour utiliser le nouveau nom de projet.

Capture d'écran de l'explorateur de contrôle de source, montrant la sélection de la dernière version.

Pour plus d’informations, consultez Renommer la commande (TFVC).

Mettre à jour les espaces de travail locaux TFVC

Si votre équipe utilise TFVC avec des espaces de travail locaux, ces espaces de travail doivent être mis à jour avec le nouveau nom du projet. Pour Visual Studio, exécutez un get ou un check-in et le mappage de l'espace de travail est corrigé pour utiliser le nouveau nom du projet.

Nous vous recommandons de mettre à jour vos clients vers la dernière mise à jour ou la version, si possible. Pour toutes les autres versions de Visual Studio prises en charge, vous devez créer un espace de travail local mappé au nouveau nom du projet.

Les espaces de travail locaux sont gérés localement et non sur le serveur. Les anciens clients qui ne disposent pas de la logique de renommage actualisée ne peuvent pas mettre à jour les espaces de travail locaux avec le nouveau nom du projet.

Mettre à jour les flux OData

Si vous utilisez des flux OData dans Power BI, mettez à jour l’URL du flux pour utiliser le nouveau nom du projet. La mise à jour de l’URL du flux est essentielle pour maintenir les connexions de données et éviter les erreurs dans la création de rapports. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

Mettre à jour les vues Analytics

Si vous avez créé des vues Analytics personnalisées à l’aide de l’ancien nom du projet, vous devez mettre à jour les vues avec le nouveau nom. Pour plus d'informations, voir Vues analytiques.

Contenu connexe

Forum Aux Questions (FAQ)

Q : Pourquoi ma tentative de réutilisation d’un nom de projet a-t-elle échoué en raison d’espaces de travail existants ?

R : Vous ne pouvez pas réutiliser un nom de projet s’il existe toujours des mappages d’espace de travail qui s’y adressent. Cette fonction permet d’éviter le cas d’ambiguïté dans lequel un espace de travail peut être mappé à deux projets. Contactez les utilisateurs qui ont ces mappages, et supprimez-les ou mettez-les à jour) pour utiliser le nouveau nom.

Si l’ordinateur de l’utilisateur contenant l’espace de travail n’est plus disponible, vous pouvez alors supprimer l’espace de travail en exécutant la commande suivante à partir de l’invite de commandes du développeur de Visual Studio : tf workspace /delete [/collection:TeamProjectCollectionUrl] workspacename[;workspaceowner]

Q : Comment le renommage d’un projet affecte-t-il l’expérience de navigation de mon navigateur ?

R : Après avoir renommé un projet, tous les navigateurs avec le projet ouvert peuvent rencontrer des erreurs. Ces erreurs sont dues aux caches conservés par le navigateur, qui incluent l’ancien nom du projet. Actualisez pour faire disparaître ces erreurs, car le cache sera rerempli avec le nouveau nom du projet.

Q : Les autres artefacts du projet sont-ils renommés ?

R : Oui, tous les artefacts qui partagent le même nom sont renommés avec le projet. Les seules exceptions concernent l’équipe et le dépôt par défaut. Le renommage de ces artefacts est effectué dans la mesure du possible. Par exemple, si un projet Foo a été renommé Bar, l’équipe par défaut Foo ne sera pas renommée si une équipe nommée Bar existait déjà dans le projet.

Q : Pourquoi ne puis-je pas ouvrir les requêtes enregistrées sur un disque après un renommage ?

R : Si vous utilisez Visual Studio 2010 et que vous avez des requêtes enregistrées sur le disque, vous ne pouvez pas les ouvrir après avoir renommé un projet. Vous pouvez utiliser Visual Studio 2012 ou une version ultérieure pour les ouvrir.

  • Last updated on