Fractionner une collection de projets
Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019
À mesure que votre entreprise évolue, vous pouvez fractionner une collection de projets unique en plusieurs collections de projets. Par exemple :
Vous souhaitez aligner les projets d'une collection avec les divisions de votre organisation (les projets de la collection étant actuellement la propriété de divisions distinctes).
Vous avez effectué une mise à niveau à partir d’une version antérieure de Azure DevOps Server, vous n’avez qu’une seule collection et vous souhaitez organiser vos projets en collections distinctes pour des raisons de sécurité ou d’alignement métier.
Vous souhaitez changer la propriété de certains des projets de la collection en un bureau distant disposant de son propre déploiement de Azure DevOps Server. Dans ce scénario, vous devez d'abord fractionner une collection, puis déplacer l'une des collections résultantes vers le déploiement du bureau distant.
Notes
Les procédures décrites dans cet article prennent uniquement en charge le fractionnement d’une collection de projets. Pour déplacer une collection après l’avoir fractionnée, consultez Déplacer une collection de projet.
Pour fractionner une collection de projets, procédez comme suit :
Préparer le fractionnement de la collection
Fractionner la collection
Configurer les collections fractionnées
Avant de commencer
Assurez-vous que vous êtes administrateur sur les serveurs et dans SQL Server et Azure DevOps Server. Si vous n’êtes pas administrateur, ajoutez-le en tant qu’administrateur.
1-a. Détacher la collection
Commencez par détacher la collection du déploiement de Azure DevOps Server sur laquelle elle s’exécute. Le détachement d’une collection arrête tous les travaux et services, ainsi que la base de données de collection elle-même. En outre, le processus de détachement copie les données spécifiques à la collection de la base de données de configuration et les enregistre dans le cadre de la base de données de collection de projets.
Détacher une collection de projets
Ouvrez la console d’administration pour Azure DevOps sur le serveur qui héberge la collection à fractionner.
Sélectionnez Collections de projet, puis, dans la liste des collections, sélectionnez la collection à fractionner.
Dans cet exemple, l’administrateur choisit TestProjects.
Conseil
Le nom par défaut d’une collection de projets est DefaultCollection. Si vous fractionner cette base de données, veillez à donner un nom différent à la deuxième collection, car il s’agit du choix par défaut lors de la connexion.
Sous l’onglet Général , sélectionnez Arrêter la collection.
La boîte de dialogue Motif de l’état de la collection de projets s’ouvre. Le texte que vous entrez est affiché à l'attention des utilisateurs. Sélectionnez Arrêter, puis attendez que la collection s’arrête. Lorsqu’il est arrêté, son status s’affiche comme hors connexion.
Sous l’onglet Général , sélectionnez Détacher la collection.
L’Assistant Détacher la collection de projets s’ouvre.
(Facultatif) Dans la page Fournir un message de maintenance pour la collection de projets , dans Message de maintenance, fournissez un message pour les utilisateurs qui peuvent essayer de se connecter aux projets de cette collection.
Dans la page Vérifier les paramètres qui seront utilisés pour détacher la collection de projets , passez en revue les détails. Pour modifier les paramètres, sélectionnez Précédent. S’ils sont corrects, sélectionnez Vérifier.
Une fois toutes les vérifications de préparation terminées, sélectionnez Détacher.
Dans la page Surveiller la progression du détachement de la collection de projets , une fois tous les processus terminés, sélectionnez Suivant.
(Facultatif) Dans la page Vérifier les informations supplémentaires de cette collection de projets , sélectionnez ou notez l’emplacement du fichier journal, puis fermez l’Assistant.
La collection de projets n’apparaît plus dans la liste des collections dans la console d’administration.
1-b. Sauvegarder la base de données de collection
Après avoir détaché la collection, vous devez sauvegarder sa base de données avant de pouvoir restaurer une copie sur le serveur avec un nom différent. Cette copie devient alors la base de données pour la partie de la collection d'origine que vous souhaitez fractionner en une autre collection. Pour effectuer cette tâche, utilisez les outils fournis avec SQL Server.
Sauvegarder une base de données de collection
Pour plus d’informations sur la sauvegarde et la restauration manuelles de bases de données individuelles, consultez Sauvegarder et restaurer des bases de données dans SQL Server et Créer une planification et un plan de sauvegarde. Veillez à sélectionner la version de SQL Server qui correspond à votre déploiement.
Important
Si votre déploiement d'origine utilisait les éditions Enterprise ou Datacenter de SQL Server, et que vous pensez que vous serez peut-être amené à restaurer les bases de données que vous souhaitez fractionner sur un serveur exécutant l'édition Standard, vous devez utiliser un jeu de sauvegarde réalisé avec la compression SQL Server désactivée. Sauf si vous désactivez la compression des données, vous ne pourrez pas restaurer correctement les bases de données de l'édition Enterprise ou Datacenter sur un serveur exécutant l'édition Standard. Pour désactiver la compression, suivez les étapes décrites dans Désactiver SQL Server compression des données dans les bases de données Azure DevOps.
2-a. Restaurer la base de données de collection
Lorsque vous fractionnez une collection, vous devez restaurer la sauvegarde de la base de données de collection sur un instance de SQL Server configuré pour prendre en charge le déploiement de Azure DevOps Server. Lorsque vous restaurez la base de données, vous devez lui donner un nom différent de celui de la base de données de collection d'origine.
Conseil
Les étapes ci-dessous donnent une vue d’ensemble de la restauration d’une base de données de collection de projets dans SQL Server 2012 à l’aide de SQL Server Management Studio. Pour plus d’informations sur la sauvegarde et la restauration manuelles de bases de données individuelles, consultez Sauvegarder et restaurer des bases de données dans SQL Server. Veillez à sélectionner la version de SQL Server qui correspond à votre déploiement.
Restaurer la base de données de collection avec un nouveau nom
Ouvrez SQL Server Management Studio et connectez-vous au instance qui héberge la base de données pour le fractionnement de la collection de projets.
Dans Explorateur d'objets, développez Bases de données, ouvrez le sous-menu pour fractionner la base de données, puis sélectionnez Tâches, sélectionnez Restaurer, puis base de données.
La fenêtre Restaurer la base de données s’ouvre dans la page Général .
Dans Source, vérifiez que la base de données de collection de projets est choisie. Dans Destination, indiquez un nom pour la copie de la base de données. Conservez le préfixe Tfs_ et ajoutez un nom distinct. En règle générale, ce nom est le nom de la collection de projets fractionnée. Dans Plan de restauration, assurez-vous que les jeux de sauvegarde à restaurer sont ceux que vous souhaitez restaurer. Pour vous assurer qu’il s’agit d’ensembles valides, sélectionnez Vérifier le support de sauvegarde , puis, dans Sélectionner une page, sélectionnez Options.
Dans Options de restauration, laissez toutes les zones case activée vides. Assurez-vous que l’état de récupération est défini sur RESTORE WITH RECOVERY. Dans Sauvegarde tail-log, désactivez la zone Quitter la base de données source dans l’état de restauration case activée, puis sélectionnez OK.
Conseil
Si l’opération de restauration échoue avec un message d’erreur indiquant que la base de données est en cours d’utilisation et ne peut pas être remplacée, vous devrez peut-être configurer manuellement tous les noms de fichiers logiques pour refléter le nouveau nom de la base de données. Dans Sélectionner une page, sélectionnez Fichiers, sélectionnez le bouton de sélection en regard de chaque fichier en cours de restauration et assurez-vous que les noms des fichiers reflètent le nouveau nom de la base de données, et non l’ancien. Ensuite, recommencez l'opération de restauration.
2-b. Attacher la base de données de collection d'origine
Une fois que vous avez restauré la base de données avec un autre nom, rattachez la base de données de collection d’origine au déploiement de Azure DevOps Server.
Attacher la collection
Ouvrez la console d’administration pour Azure DevOps.
Sélectionnez Collections de projets, puis Attacher une collection.
L’Assistant Attacher une collection de projets s’ouvre.
Dans la page Sélectionner la base de données de collection de projets à attacher, dans SQL Server Instance, indiquez le nom du serveur et le instance qui héberge la base de données de collection, si elle n’est pas déjà répertoriée.
Dans la liste Bases de données , sélectionnez la base de données de collection à attacher.
Dans la page Entrer les informations sur la collection de projets, indiquez un nom pour la collection dans Nom si elle n’en est pas déjà présente. Étant donné qu’il s’agit de la collection d’origine, vous pouvez choisir de conserver le même nom qu’auparavant. Dans Description, fournissez éventuellement une description de la collection.
Dans la page Vérifier les paramètres qui seront utilisés pour joindre la collection de projets , passez en revue les informations.
Pour modifier les paramètres, sélectionnez Précédent. Si tous les paramètres sont corrects, sélectionnez Vérifier.
Une fois toutes les vérifications de préparation effectuées, sélectionnez Attacher.
Dans la page Surveiller la progression de l’attachement à la collection de projets , une fois tous les processus terminés, sélectionnez Suivant.
(Facultatif) Dans la page Vérifier les informations supplémentaires de cette collection de projets , sélectionnez ou notez l’emplacement du fichier journal, puis fermez l’Assistant.
La collection de projets apparaît dans la liste des collections de la console d’administration. Si l’état de la collection est enligne, vous devez l’arrêter avant de continuer. Sélectionnez la collection dans la liste, puis sous l’onglet Général , sélectionnez Arrêter la collection.
2-c. Attacher la base de données de collection renommée
Après avoir attaché la base de données de collection d’origine, vous devez attacher la collection renommée au déploiement de Azure DevOps Server. Lorsque cette collection est attachée, elle reste arrêtée. Pour pouvoir la démarrer, vous devez au préalable supprimer tous les projets en double.
Attacher la base de données de collection renommée
Ouvrez la console d’administration pour Azure DevOps.
Sélectionnez Collections de projets, puis Attacher une collection pour ouvrir l’Assistant.
Dans la page Sélectionner la base de données de collection de projets à attacher, dans SQL Server Instance, indiquez le nom du serveur et le instance qui héberge la base de données de collection renommée, si elle n’est pas déjà répertoriée.
Dans la liste Bases de données , sélectionnez la base de données de collection renommée.
Dans la page Entrer les informations de la collection de projet , entrez un nom pour la collection renommée dans Nom qui diffère du nom d’origine de la collection. Cela doit correspondre au nom que vous avez donné à la base de données renommée, sans le préfixe Tfs_.
(Facultatif) Dans Description, entrez une description de la collection.
Dans la page Vérifier les paramètres qui seront utilisés pour joindre la collection de projets , passez en revue les informations. Pour modifier les paramètres, sélectionnez Précédent. Si tous les paramètres sont corrects, sélectionnez Vérifier.
Une fois toutes les vérifications de préparation effectuées, sélectionnez Attacher.
Dans la page Surveiller la progression de l’attachement à la collection de projets , une fois tous les processus terminés, sélectionnez Suivant.
(Facultatif) Dans la page Vérifier les informations supplémentaires de cette collection de projets , sélectionnez ou notez l’emplacement du fichier journal, puis fermez l’Assistant.
Le nom de la collection s’affiche dans la liste des collections dans la console d’administration, et son status doit s’afficher comme hors connexion.
Pour vous assurer que les deux collections sont attachées avec des ID uniques, dans la console Administration, accédez à Journaux des événements et ouvrez les fichiers journaux pour les deux opérations d'attachement de collection. Les GUID pour CollectionProperties ne doivent pas correspondre.
Dans le cas peu probable où les GUID CollectionProperties correspondent, remplacez l’ID par un ID unique avant de continuer en exécutant la commande TFSConfig Collection sur la deuxième collection avec le paramètre /clone.
2-d. Supprimer les projets des collections fractionnées
Maintenant que vous disposez de deux copies de la collection attachées à Azure DevOps Server, vous devez supprimer chaque projet de la collection d’origine ou de la collection renommée afin qu’aucun projet ne reste dans les deux collections.
Important
Un projet ne peut exister que dans une seule collection. Tant que n'avez pas supprimé tous les projets en double entre les collections fractionnées, vous ne pouvez pas démarrer la collection renommée.
Supprimer des projets des collections
Ouvrez la console d’administration pour Azure DevOps.
Sélectionnez Collections de projets, puis, dans la liste des collections, sélectionnez la collection de projets d’origine que vous avez arrêtée pour la fractionner.
Sous l’onglet Projets , dans la liste des projets, sélectionnez un projet à supprimer de la collection, puis sélectionnez Supprimer.
Conseil
Vous pouvez sélectionner plusieurs projets à supprimer.
Sélectionnez la zone Supprimer les données de l’espace de travail case activée, laissez la zone Supprimer les artefacts externes case activée désactivée, puis sélectionnez Supprimer.
Si la zone Supprimer les artefacts externes case activée n’est pas désactivée et que votre projet est configuré pour utiliser Lab Management, les machines virtuelles et les modèles associés au projet seront supprimés de System Center Virtual Machine Manager. Ils ne seront plus disponibles pour le projet dans la collection renommée. (Notez que Lab Management a été déconseillé pour TFS 2017 et versions ultérieures.)
Une fois que vous avez terminé la suppression des projets que vous ne souhaitez pas héberger dans la collection de projets d’origine, sélectionnez la collection de projets renommée dans la liste des collections. Ensuite, sous l’onglet Projets , supprimez les projets indésirables de la nouvelle collection.
Répétez les étapes de cette section jusqu’à ce que les deux collections contiennent un ensemble de projets uniques.
2-e. Démarrer les collections de projets
Après avoir supprimé des projets, redémarrez les deux collections.
Démarrer une collection de projets
Ouvrez la console d’administration pour Azure DevOps.
Sélectionnez Collections de projet, puis, dans la liste des collections, sélectionnez la collection que vous avez arrêtée pour la fractionner.
Sous l’onglet Général , sélectionnez Démarrer la collection.
Répétez l'étape 2 pour la collection que vous avez attachée avec un nouveau nom.
3-a. Configurer les utilisateurs et les groupes de collections fractionnées
Vous pouvez ignorer cette procédure si les deux collections fractionnées restent dans le même domaine et que vous souhaitez autoriser les administrateurs de la collection d'origine à accéder aux deux collections.
Après avoir fractionné une collection, vous devez mettre à jour les groupes d'autorisation des deux collections avec les utilisateurs et les groupes qui administreront ces collections. Pour plus d’informations, consultez Définir les autorisations d’administrateur pour les collections de projets.
3-b. Configurer les utilisateurs et les groupes de projets
Vous pouvez ignorer cette procédure si les collections fractionnées restent dans le même domaine et que vous souhaitez autoriser les utilisateurs de projets de la collection d'origine à accéder aux deux collections.
Après avoir configuré les administrateurs des deux collections, vous ou les administrateurs devez configurer l'accès des utilisateurs et des groupes aux projets dans chaque collection. En fonction de votre déploiement, vous devrez peut-être également configurer des autorisations pour ces utilisateurs dans Reporting Services. Pour plus d’informations, consultez Ajouter des utilisateurs à des projets ou des équipes.
Questions et réponses
Q : Mon déploiement utilise la création de rapports. Y a-t-il des étapes supplémentaires à effectuer lors du fractionnement des collections ?
Un: Oui, vous devez fractionner les rapports une fois que vous avez terminé la suppression des projets afin que les deux collections aient un ensemble unique de projets. Vous devez aussi régénérer votre entrepôt de données.
Après avoir supprimé des projets, déplacez les rapports que la collection fractionnée utilise dans un autre dossier, puis supprimez-les du dossier d’origine.
Important
Les dossiers de rapports existent dans les deux emplacements. Assurez-vous de déplacer tous les rapports de façon appropriée avant de supprimer des dossiers de rapports.
Fractionner les rapports en dossiers distincts
- Dans le Gestionnaire de rapports, déplacez les rapports qui prennent en charge la collection fractionnée dans les dossiers appropriés de cette collection. Pour plus d’informations, consultez Page Déplacer des éléments.
Une fois que vous avez fractionné les rapports et démarré les deux collections, régénérez l’entrepôt pour Azure DevOps et la base de données pour Analysis Services. Vous devez effectuer cette étape pour vous assurer que les rapports et les tableaux de bord fonctionnent correctement pour le déploiement après le fractionnement de la collection et vérifier qu'il n'y a aucun conflit avec d'autres collections dans le déploiement.
Reconstruire l’entrepôt de données et la base de données Analysis Services
Ouvrez la console d’administration pour Azure DevOps.
Dans la barre de navigation, sélectionnez Création de rapports.
Dans Création de rapports, sélectionnez Démarrer la reconstruction.
Dans la boîte de dialogue Reconstruire les bases de données d’entrepôt et d’Analysis Services , sélectionnez OK.
Notes
La régénération des entrepôts et le remplissage des données se poursuivent au terme de l'action Démarrer la régénération Selon la taille de votre déploiement et la quantité de données, l’ensemble du processus peut prendre plusieurs heures.