Partager via


Supprimer un projet

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

Si un projet devient obsolète, vous pouvez le supprimer de votre organisation ou collection dans Azure DevOps. De même, si vous migrez d’un serveur Azure DevOps local vers Azure DevOps Services, il peut être nécessaire de supprimer le projet. La suppression de projets peut également améliorer la navigation en la limitant uniquement aux projets actuellement en cours d’utilisation.

Attention

  • Les projets supprimés de manière réversible du portail web sont définitivement supprimés s’ils ne sont pas restaurés dans les 28 jours.
  • Dans de rares cas, notre processus de suppression peut prendre jusqu’à 70 jours en raison de nouvelles tentatives back-end et de la nécessité de supprimer des données de plusieurs sources.
  • Les projets supprimés en dur de la console d’administration Azure DevOps locale ne peuvent pas être restaurés. Pour plus d’informations, consultez Restaurer un projet et enregistrer des données de projet.

Prérequis

  • Autorisations :
    • Être membre du groupe Administrateurs de collection de projets. Les propriétaires d’organisation sont automatiquement membres de ce groupe.
    • Disposer de l’autorisation Supprimer le projet d’équipe définie sur Autoriser. Pour plus d’informations, consultez Afficher les autorisations au niveau du projet.
  • Facultatif : Enregistrez les données du projet avant de supprimer un projet si vous souhaitez accéder aux données du projet sans la restaurer.
  • Autorisations : définissez l’autorisation Supprimer le projet d’équipe sur Autoriser. Pour plus d’informations, consultez Afficher les autorisations.
  • Facultatif : Enregistrer les données du projet, car la suppression d’un projet entraîne une perte de données irréversible.

Enregistrer les données de projet

Utilisez les procédures suivantes pour enregistrer les données dont les utilisateurs se soucient le plus, comme le code source, les données de génération et les éléments de travail. Cette procédure est facultative et vous pouvez envisager quelque chose avant de supprimer un projet.

  • Code source et modèles de build personnalisés : téléchargez vos fichiers en tant que fichier zip. Sélectionnez Actions de référentiel le référentiel, le fichier ou le dossier, puis sélectionnez Télécharger en tant que zip. Vous pouvez également sélectionner Télécharger pour télécharger tous les fichiers du dossier actuellement sélectionné ou le fichier actuellement sélectionné.

    Capture d’écran du téléchargement du code.

    Ce processus n’enregistre aucun historique des modifications ni des liens vers d’autres artefacts. Si vous utilisez Git, clonez vos référentiels pour conserver l’historique complet du projet et toutes les branches.

  • Données de build : pour enregistrer les journaux et les données dans vos dossiers de build de suppression, consultez Afficher les résultats de build.

  • Données de suivi des éléments de travail : créez une requête d’élément de travail et ouvrez-la à l’aide d’Excel. Enregistrez la feuille de calcul Excel.

    Ce processus n’enregistre aucune pièce jointe, historique des modifications ou liens vers d’autres artefacts.

Pour plus d’informations, consultez notre vue d’ensemble de la protection des données.

Supprimer le projet

Utilisez votre navigateur web pour effectuer une suppression réversible. Après 28 jours, les projets sont définitivement supprimés s’ils ne sont pas restaurés dans ce délai.

  1. Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).

  2. Sélectionnez Icône d’engrenage Paramètres de l’organisation.

    Capture d’écran de la sélection, paramètres de l’organisation.

  3. Sélectionnez Projets, cochez un ou plusieurs projets à supprimer, puis sélectionnez Supprimer.

    Capture d’écran des projets sélectionnés de séquence, vérifiez chaque projet et supprimez.

  4. Confirmez la suppression en entrant le nom du projet, puis sélectionnez Supprimer dans l’écran contextuel.

    Capture d’écran de l’écran de suppression de projet de confirmation contextuelle.

Votre projet est supprimé et peut être restauré jusqu’à 28 jours par la suite. Votre projet supprimé est supprimé de votre liste de projets.

Supprimer des rapports qui restent après la suppression d’un projet

Si votre projet a utilisé la création de rapports SQL Server et que vous n’avez pas supprimé d’artefacts externes, vous pouvez supprimer les rapports à l’aide du Gestionnaire de rapports SQL Server. Dans la page de collection de projets, supprimez le dossier correspondant au projet supprimé.

Capture d’écran du menu contextuel avec la commande Delete.

Restaurer un projet supprimé

Si vous supprimez par inadvertance un projet dans Azure DevOps, vous pouvez le restaurer dans les 28 jours suivant sa suppression.

  1. Connectez-vous à votre organisation (https://dev.azure.com/{yourorganization}).

  2. Sélectionnez Icône d’engrenage Paramètres de l’organisation.

    Capture d’écran montrant l’icône d’engrenage, paramètres de l’organisation.

  3. Sélectionnez Vue d’ensemble, puis faites défiler jusqu’à « projets récemment supprimés ».

    Capture d’écran montrant les projets récemment supprimés.

  4. Mettez en surbrillance le projet que vous souhaitez restaurer, puis sélectionnez Restaurer.

    Capture d’écran montrant le projet mis en surbrillance et le bouton Restaurer.

  1. Connectez-vous à votre instance (http://{ServerName:8080/tfs/}/{CollectionName}).

  2. Sélectionnez l’icône d’engrenage Paramètres d’administration.

    Capture d’écran montrant le bouton Paramètres d’administration entouré d’une zone rouge.

  3. Sélectionnez Projets, puis faites défiler jusqu’aux projets récemment supprimés.

  4. Mettez en surbrillance le projet que vous souhaitez restaurer, puis sélectionnez Restaurer.

    Capture d’écran montrant comment mettre en surbrillance le projet, puis sélectionner Restaurer pour Azure DevOps Server.

Remarque

L’interface utilisateur ne prend pas en charge la restauration d’un projet d’équipe pour Azure DevOps Server 2019. Utilisez les méthodes REST ou PowerShell suivantes pour restaurer un projet d’équipe supprimé. Pour plus d’informations, consultez l’API REST Projects-Update.

Restaurer un projet avec l’API REST

Avertissement

Pour restaurer un projet portant un nom déjà pris, vous devez renommer le projet avant de pouvoir le restaurer. Pour renommer le projet, entrez le texte suivant dans le corps de la demande : "name":"new name"

  1. Ouvrez une fenêtre de navigateur et entrez une URL qui utilise le formulaire suivant :

    'http://ServerName:8080/tfs/DefaultCollection/ProjectName'

    Par exemple, pour vous connecter au serveur nommé FabrikamPrime, entrez : «http://FabrikamPrime:8080/tfs/ ».

    Le port par défaut est 8080. Spécifiez le numéro de port et le répertoire de votre serveur si les valeurs par défaut ne sont pas utilisées.

  2. Obtenez la liste des projets supprimés à l’aide de la requête suivante :

    GET http://ServerName:8080/tfs/DefaultCollection/_apis/projects?stateFilter=
    deleted&api-version=5.0-preview.3
    
  3. Restaurez un projet supprimé à l’aide de la requête suivante :

    PATCH http://ServerName:8080/tfs/DefaultCollection/_apis/projects/{projectId}?
    api-version=5.0-preview.3
    

    Corps de la demande

    {
     "state" : "wellFormed"
    }
    

Restaurer un projet avec PowerShell

  1. Exécutez le script PowerShell suivant pour obtenir la liste des projets supprimés et veillez à mettre à jour $collectionUrl.

    $collectionUrl = "https://localhost/defaultcollection"
    (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
    deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
    

    Une capture d’écran similaire à la capture d’écran suivante s’affiche : Capture d’écran de l’exemple de retour de script PowerShell pour les projets supprimés.

  2. Utilisez le script suivant pour restaurer un projet. Veillez à mettre à jour $collectionUrl et $projectName.

    $collectionUrl = "https://localhost/defaultcollection"
    $projectName = 'Project1'
    $project = (irm -Uri "$collectionUrl/_apis/projects?stateFilter=
    deleted&api-version=5.0-preview.3" -UseDefaultCredentials).value
     | where {$_.name -eq $projectName}
    irm -Uri ($project.url + "?api-version=5.0-preview.3") 
    -UseDefaultCredentials -Method PATCH -Body '{"state":"wellFormed"}'
     -ContentType 'application/json'
    

Votre projet et vos données associées sont restaurés.

FAQ

Consultez les questions fréquemment posées suivantes sur la suppression de projets dans Azure DevOps.

R : Les éléments de travail sont supprimés dans les 24 heures suivant la suppression de votre projet.

Q : J’ai supprimé un projet dans Azure DevOps, mais dans Visual Studio Team Explorer, qu’est-ce que je fais ?

R : Attendez 28 jours avant la suppression définitive du projet.