Déplacer une collection de projets

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Notes

Azure DevOps Server a été précédemment nommé Visual Studio Team Foundation Server.

Vous pouvez déplacer une collection de projets d’un déploiement de Azure DevOps Server vers un autre. Par exemple :

  • Vous avez plusieurs déploiements de Azure DevOps Server dans votre organisation, et vous souhaitez déplacer un regroupement vers un autre déploiement pour mieux l’adapter aux besoins de votre entreprise.
  • Vous souhaitez déplacer la collection vers un bureau distant qui dispose de son propre déploiement de Azure DevOps Server.
  • Vous souhaitez étendre votre déploiement de Azure DevOps Server en y ajoutant une autre instance de SQL Server et vous souhaitez distribuer des collections existantes entre les instances.
  • Vous devez mettre à niveau de façon incrémentielle votre déploiement en détachant une collection de projets individuels à partir d’un déploiement de Azure DevOps Server exécutant une version antérieure, puis en la déplaçant vers un serveur qui exécute la version actuelle de Azure DevOps Server. (Une raison courante est que certaines équipes peuvent avoir besoin de migrer vers une version plus récente de Azure DevOps Server, tandis que d’autres doivent rester sur une version antérieure pour des raisons d’outils ou de projets.) Dans ce scénario, vous devez également mettre à niveau chaque projet de la collection à l’aide de l’Assistant Configurer les fonctionnalités. Pour plus d’informations, consultez configurer des fonctionnalités après une mise à niveau de Azure DevOps Server. L’Assistant Configurer les fonctionnalités est déconseillé pour Azure DevOps Server 2019. Vous pouvez uniquement exécuter l’Assistant sur TFS 2018 et versions antérieures. Les projets définis sur Azure DevOps Services mise à jour automatiquement à chaque mise à niveau du service.

Les étapes à suivre pour déplacer une collection dépendront de la configuration particulière du déploiement hébergeant la collection et du déploiement vers lequel vous la déplacez. Par exemple, si vous déplacez une collection vers un nouveau domaine, vous devez ajouter les utilisateurs de ce domaine aux groupes appropriés au niveau de la collection et au niveau du projet. De même, si vous déplacez une collection vers un déploiement de Azure DevOps Server qui utilise une application Web SharePoint différente, vous devez déplacer la base de données de collection de sites qui prend en charge la collection vers cette application Web SharePoint, ou ajouter l’application Web SharePoint qui prend en charge la collection au déploiement de Azure DevOps Server vers lequel vous l’avez déplacée.

Notes

L’intégration avec les produits SharePoint est dépréciée pour TFS 2018 et versions ultérieures.

Voici comment déplacer une collection de projets entière. Pour déplacer une partie d’une collection, consultez fractionner une collection de projets.

Prérequis

Avant de commencer votre déplacement, assurez-vous que vous êtes un administrateur sur les serveurs et dans les logiciels utilisés à la fois par le déploiement d'origine et le déploiement de destination. Si vous n’êtes pas administrateur, faites-vous ajouter en tant que tel.

1. détacher la collection

Avant de déplacer une collection, vous devez la détacher du déploiement de Azure DevOps Server sur lequel elle s’exécute. Il est très important de ne pas ignorer cette étape. Lorsque vous détachez une collection, tous les travaux et tous les services sont arrêtés, puis la base de données de collection est arrêtée. En outre, le processus de détachement copie les données spécifiques à la collection à partir de la base de données de configuration et les enregistre dans le cadre de la base de données de la collection de projets. Ces données de configuration permettent à la base de données de collection d’être attachée à un autre déploiement de Azure DevOps Server. Si ces données ne sont pas présentes, vous ne pouvez pas attacher la collection à un déploiement de Azure DevOps Server à l’exception de celui dont elle provient.

Notes

Détacher une collection empêche les utilisateurs d'accéder aux projets de cette collection.

  1. Ouvrez la console d’administration pour Azure DevOps sur le serveur qui héberge la collection à déplacer, puis dans collections de projets, mettez en surbrillance cette collection.

  2. Sous l’onglet général , sélectionnez détacher la collection.

    Détacher des collections de projets

    Sous l'onglet Général, sélectionnez puis détachez

    L' Assistant détacher la collection de projets s’ouvre.

  3. 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.

  4. Sélectionnez Suivant.

  5. 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.

  6. Pour modifier des paramètres, sélectionnez précédent. S’ils semblent être corrects, sélectionnez vérifier.

  7. Lorsque toutes les vérifications de disponibilité se sont terminées avec succès, sélectionnez détacher.

  8. Dans la page analyser la progression du détachement de la collection de projets , lorsque tous les processus sont terminés, sélectionnez suivant.

    L'Assistant affiche votre progression

  9. Facultatif Dans la page vérifier les informations supplémentaires pour cette collection de projets , sélectionnez ou notez l’emplacement du fichier journal.

  10. Sélectionnez Fermer.

    La collection de projets ne s’affiche plus dans la liste des collections de la console Administration de.

    La console d'administration de TFS ne s'affiche pas quand elle est détachée

2. sauvegarde de la base de données de collection

Après avoir détaché la collection, sauvegardez sa base de données pour la déplacer vers l’autre serveur. Pour effectuer cette tâche, utilisez les outils fournis avec SQL Server.

Capture d’écran du volet connexion montrant les éléments suivants : FABRIKAM2014 > Tfs_TestProjects > tâches > sauvegarder.

Important

Vous pouvez uniquement restaurer une base de données vers la même version de SQL Server ou une version plus récente. Vous ne pouvez pas restaurer une base de données SQL Server à une version antérieure du produit
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 sur un serveur exécutant l'édition Standard, vous devez utiliser un jeu de sauvegarde réalisé avec une compression SQL Server désactivée. À moins que vous ne désactiviez la compression des données, vous ne pourrez pas restaurer les bases de données Enterprise ou Datacenter sur un serveur exécutant l’édition standard. Pour désactiver la compression, suivez les étapes de la section désactiver la compression des données SQL Server dans les bases de données DevOps Azure.

3. déplacer la base de données de collection

Dans le cadre du déplacement de la collection, vous devez restaurer, copier ou déplacer la base de données de collection vers une instance de SQL Server configurée pour prendre en charge le déploiement de Azure DevOps Server vers lequel vous déplacez la collection. Vous pouvez sélectionner la méthode de votre choix pour déplacer la base de données.

Capture d’écran de la page d’accueil de l’Assistant copie de base de données.

Pour plus d'informations sur le déplacement d'une base de données vers une autre instance de SQL Server, voir :

4. Attachez la collection

Après avoir restauré la base de données de collection, vous pouvez attacher le regroupement au déploiement par défaut de Azure DevOps Server. Si le déploiement que vous déplacez vers utilise la création de rapports, un dossier de rapports et des rapports par défaut sont générés pour le regroupement que vous êtes en train de joindre dans le cadre du processus.

Notes

Des avertissements s’affichent lorsque vous attachez la collection si votre déploiement utilise des produits SharePoint et que le compte de service pour Azure DevOps Server n’est pas membre du groupe administrateurs de batterie, ou si votre déploiement utilise la création de rapports et que vous avez déjà créé un dossier de rapports et un chemin d’accès identique au dossier et au chemin d’accès du déploiement précédent. Ce comportement est attendu et vous pouvez continuer.

  1. Ouvrez la console d’administration pour Azure DevOps sur le serveur qui héberge la couche application pour le déploiement vers lequel vous déplacez le regroupement.

  2. Sélectionnez collections de projets, puis attacher une collection.

    Console d’administration Azure DevOps Server, collections de projets d’équipe

    Console Administration TFS, collections de projets d’équipe

    L' Assistant attacher une collection de projets s’ouvre.

  3. Dans la page Sélectionner la base de données de la collection de projets à attacher , dans SQL Server instance, indiquez le nom du serveur et l’instance qui héberge la base de données de collection, si elle n’est pas déjà répertoriée.

    Assurez-vous que l'instance de SQL Server est correcte

  4. Dans la liste bases de données , sélectionnez la base de données de collection à attacher, puis sélectionnez suivant.

  5. Sur la page entrer les informations de la collection de projets, indiquez un nom pour la collection dans nom , si aucune n’est déjà présente.

  6. Facultatif Dans Description, fournissez une description de la collection.

  7. Sélectionnez Suivant.

  8. Dans la page vérifier les paramètres qui seront utilisés pour joindre la collection de projets , passez en revue les informations.

  9. Pour modifier des paramètres, sélectionnez précédent. Si tous les paramètres sont corrects, sélectionnez vérifier.

  10. Lorsque toutes les vérifications de disponibilité se sont terminées avec succès, sélectionnez attacher.

  11. Dans la page analyser la progression de l’attachement de la collection de projets , lorsque tous les processus sont terminés, sélectionnez suivant.

  12. Facultatif Dans la page vérifier les informations supplémentaires pour cette collection de projets , sélectionnez ou notez l’emplacement du fichier journal.

  13. Sélectionnez Fermer.

    La collection de projets s’affiche dans la liste des collections de la console Administration de. L’application Web SharePoint qui prenait en charge cette collection dans son déploiement d’origine s’affiche dans la liste des applications Web.

    Arrêter la collection si la configuration n'est pas terminée

  14. Facultatif Modifiez ou supprimez l’application Web de la liste des applications Web. Pour plus d’informations, consultez modifier ou supprimer l’accès entre une application Web SharePoint et Azure DevOps Server.

5. configurer la collection de projets déplacée

Vous pouvez ignorer cette procédure si vous avez déplacé la collection dans le même domaine et que vous avez l’intention d’utiliser la même application Web que celle qui a précédemment pris en charge la collection et que vous souhaitez autoriser l’accès pour les administrateurs de cette collection à ce déploiement de Azure DevOps Server.

Après avoir déplacé une collection, mettez à jour l’application Web et les groupes d’autorisations pour ce regroupement avec les paramètres appropriés.

Configurer la collection déplacée

  • Ouvrez chaque onglet de la collection de projets et, si nécessaire, modifiez les paramètres pour refléter les services et les emplacements afin qu’ils correspondent aux emplacements des ressources sur le Azure DevOps Server actuel. Ceci est particulièrement important pour SharePoint et les ressources de création de rapports. Si vous constatez des erreurs, vérifiez que votre compte dispose des autorisations requises pour les administrateurs de collections de projets et que tous les autres administrateurs de la collection de projets ont été ajoutés en fonction des besoins.

    Pour plus d’informations sur cette tâche, consultez modifier une collection de projets et définir des autorisations d’administrateur pour les collections de projets.

6. configurer des projets

Vous pouvez ignorer cette procédure si vous avez déplacé la collection dans le même domaine et que vous souhaitez autoriser l’accès pour les utilisateurs de projets de cette collection à ce déploiement de Azure DevOps Server.

Après avoir configuré les administrateurs de la collection déplacée, vous ou les administrateurs devez ajouter des utilisateurs et des groupes aux projets de cette collection. Selon votre déploiement, vous devrez peut-être également configurer des autorisations pour ces utilisateurs dans les produits et les Reporting Services SharePoint.

Ajouter des utilisateurs aux projets

Ajouter des ressources aux projets déplacés

Questions et réponses

Q : mon Azure DevOps Server déploiement utilise la création de rapports. Comment déplacer ces rapports lors du déplacement d'une collection ?

R : Tout d’abord, vous devez enregistrer ou exporter les rapports que vous souhaitez déplacer du serveur de rapports qui a pris en charge la collection dans son déploiement d’origine. Vous devez ensuite télécharger manuellement chaque rapport vers le serveur de rapports qui prendra en charge la collection déplacée, ce qui peut prendre du temps. Déterminez si vous devez télécharger tous les rapports ou si vous pouvez vous limiter à un sous-ensemble des rapports. Vous n'êtes pas obligé de télécharger tous les rapports (vous pouvez même n'en télécharger aucun), mais les rapports que vous téléchargez doivent être disponibles une fois le processus de déplacement terminé.

Vous devez également reconstruire l’entrepôt et le cube Analysis Services sur le déploiement d’origine après avoir déplacé le regroupement, de sorte que le déploiement d’origine ne tente pas de créer des rapports pour un regroupement qui n’existe plus.

Déplacer les rapports

  1. Exportez ou enregistrez les rapports à déplacer du serveur de rapports prenant en charge la collection dans son déploiement d'origine. Pour plus d’informations, consultez exporter des rapports et enregistrer des rapports.

  2. Téléchargez chaque rapport à déplacer vers le dossier approprié sur le serveur de rapports prenant en charge la collection dans son nouvel environnement dans le Gestionnaire de rapports.

    Pour plus d’informations, consultez charger des fichiers dans un dossier.

  3. Dans le Gestionnaire de rapports, modifiez chaque rapport pour spécifier le nouveau serveur de rapport comme source de données.

Régénérer l'entrepôt de données et Analysis Services

  1. Ouvrez la console d’administration pour Azure DevOps.

  2. Dans la barre de navigation, sélectionnez rapports.

  3. Dans rapports, sélectionnez Démarrer la régénération.

  4. Dans la boîte de dialogue reconstruire l’entrepôt et les bases de données de 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. En fonction de la taille de votre déploiement et de la quantité de données, l’ensemble du processus peut prendre plusieurs heures.

Q : Comment déplacer une collection qui utilise des produits SharePoint ?

R : Pour déplacer une collection de projets qui utilise une application Web SharePoint, vous devez déplacer la collection de projets elle-même et la collection de sites SharePoint qui prend en charge la collection de projets. La collection de sites doit être déplacée vers l’application Web qui prendra en charge la collection de projets dans le nouveau déploiement. Plus précisément, vous devez sauvegarder la base de données de collection de sites , puis déplacer la base de données de collection de sites. Une fois que vous avez effectué cela et attaché la collection de projets déplacée à son Azure DevOps Server de destination, vous devez réparer la connexion entre ce Azure DevOps Server et son application Web SharePoint pour vous assurer que la collection jointe se connecte à la collection de sites déplacée. Vous devez également vous assurer que l’onglet SharePoint pour la collection de projets pointe vers cette base de données de collection de sites.

Notes

Si vous déplacez la collection entre des déploiements qui utilisent des produits SharePoint, il est fortement recommandé que le compte de service de Azure DevOps Server être membre du groupe administrateurs de batterie dans les produits SharePoint dans les deux déploiements. Dans le cas contraire, vous risquez de rencontrer des erreurs lorsque vous tentez de détacher ou d’attacher la collection.
Vous pouvez déplacer une collection de projets sans octroyer cette appartenance au compte de service pour Azure DevOps Server. Toutefois, des erreurs se produisent quand vous attachez la collection, et vous devez effectuer des étapes supplémentaires pour reconnecter les projets à leurs portails. Même si vos spécifications opérationnelles limitent généralement l'octroi de cette appartenance au compte de service, songez à ajouter le compte de service au groupe Administrateurs de batterie pour la durée de l'opération de déplacement.

  1. Ouvrez la console d’administration pour Azure DevOps, sélectionnez applications Web SharePoint, puis dans la liste des applications Web, sélectionnez l’application Web qui prend en charge le regroupement que vous venez d’attacher.

    Le bouton réparer la connexion s’affiche lorsque vous sélectionnez une application Web dans la liste.

  2. Sélectionnez réparer la connexion, puis dans la boîte de dialogue réparer la connexion à une application Web SharePoint , sélectionnez réparer.

  3. Dans collections de projets, sélectionnez la collection de projets déplacée, sélectionnez l’onglet produits SharePoint, puis modifiez les paramètres pour qu’ils pointent vers la base de données de collection de sites.

Q : Comment faire déplacer une collection de projets d’équipe qui comprend des pools de déploiement et/ou des groupes de déploiement ?

R : Lorsque vous déplacez la collection vers un autre déploiement, pour chaque pool de déploiement dans la source ayant un groupe de déploiement dans le regroupement détaché, un nouveau pool de déploiement est automatiquement approvisionné dans l’instance cible. Dans le cas de Azure DevOps Server 2019 ou version ultérieure, le nom du pool de déploiement automatiquement approvisionné est le même que dans l’instance source. Dans les versions antérieures, le nom du pool de déploiement est au format <project name-deployment-group name> . En cas de conflit, un GUID aléatoire est ajouté au nom du pool de déploiement.

Une fois le déplacement terminé :

  • Il est possible de créer plusieurs pools de déploiement. Vous pouvez fusionner les pools dupliqués à l’aide de la commande TfsConfig. Par exemple : TfsConfig.exe deploymentpool /migrateDeploymentGroups /fromPool:<Source Pool Name> /toPool:<Target Pool Name>
  • Vous devez reconfigurer les agents avec le nouveau pool de déploiement. Voici un exemple de script de reconfiguration de l’agent de déploiement pour votre référence.

Q : Comment faire déplacer une collection de projets qui comprend des Lab Management ?

R : Si vous avez déplacé la collection vers un autre domaine ou que vous envisagez d’utiliser un autre System Center Virtual Machine Manager (SCVMM), vous devez supprimer les ordinateurs virtuels, les modèles, les groupes hôtes de projet et les partages de bibliothèque de projet de la base de données de collection avant de commencer le déplacement, puis les recréer dans Microsoft Test Manager après le déplacement.

Notes

Lab Management est déconseillé pour TFS 2017 et versions ultérieures.

Supprimer les ressources de Lab Management avant de déplacer la collection

  • Pour plus d’informations sur la suppression de tous les hôtes de groupe, partages de bibliothèque et environnements d’une collection de projets spécifiée, consultez commande TfsConfig Lab/Delete avec l’option /External

Configurer Lab Management ressources après le déplacement de la collection

  1. Configurez la couche application pour Azure DevOps.

    Pour plus d’informations, consultez configurer des Lab Management pour les environnements SCVMM.

  2. Recréez les machines virtuelles Golden Master et les modèles dans le nouveau SCVMM, puis importez les ordinateurs virtuels et les modèles dans la collection de projets.

    Pour plus d’informations, consultez Comment : créer et stocker des ordinateurs virtuels et des modèles prêts pour Lab Management.

  3. Recréez les environnements pour chaque projet.

    Pour plus d’informations, consultez créer un environnement SCVMM à l’aide d’ordinateurs virtuels stockés et de modèles.

Q : Comment faire restreindre l’accès pour sélectionner des fonctions dans un projet ?

R : Les utilisateurs qui ont des autorisations d’accès à un projet d’une collection peuvent afficher d’autres projets dans cette collection, même s’ils n’ont pas les autorisations nécessaires pour modifier des éléments de travail ou effectuer d’autres actions dans ce projet. Vous pouvez accorder ou restreindre l’accès à des fonctionnalités et fonctions de sélection pour la création ou la modification d’artefacts sélectionnés, ainsi qu’empêcher l’affichage de projets, en créant spécifiquement des groupes et en configurant des restrictions sur ces groupes.