Déplacer une collection de projets

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

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

• Vous avez plusieurs déploiements d’Azure DevOps Server dans votre organisation et vous souhaitez déplacer un regroupement vers un autre déploiement pour mieux s’aligner sur vos besoins métier.
• Vous souhaitez déplacer la collection vers un bureau distant disposant de son propre déploiement d’Azure DevOps Server.
• Vous souhaitez développer votre déploiement d’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 manière incrémentielle votre déploiement en détachant une collection de projets individuellement à partir d’un déploiement d’Azure DevOps Server exécutant une version antérieure, puis en la déplaçant vers un serveur exécutant la version actuelle d’Azure DevOps Server. (Une des raisons courantes est que certaines équipes peuvent avoir besoin de migrer vers une version plus récente d’Azure DevOps Server, tandis que d’autres doivent rester sur une version antérieure pour les outils ou les projets pour des raisons.) Dans ce scénario, vous devez également mettre à niveau chaque projet dans 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 d’Azure DevOps Server. L’Assistant Configurer les fonctionnalités a été 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 sont mis à jour automatiquement avec chaque mise à niveau de service.

Les étapes de déplacement d’un regroupement dépendent de la configuration particulière du déploiement qui a hébergé le regroupement et le déploiement vers lequel vous le déplacez. Par exemple, si vous déplacez une collection vers un nouveau domaine, vous devez ajouter des utilisateurs de ce domaine aux groupes appropriés au niveau de la collection et au niveau du projet.

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 administrateur sur les serveurs et dans le logiciel utilisé par le déploiement à partir duquel vous passez et celui vers lequel vous passez. Si vous n’êtes pas administrateur, ajoutez-en un.

1. Détacher la collection

Avant de déplacer une collection, commencez par la détacher du déploiement d’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 services sont arrêtés, puis la base de données de collecte 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 collecte de projets. Ces données de configuration permettent à la base de données de collecte d’être attachée à un autre déploiement d’Azure DevOps Server. Si ces données ne sont pas présentes, vous ne pouvez pas attacher la collection à n’importe quel déploiement d’Azure DevOps Server, à l’exception de celle à partir de laquelle elle provient.

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

2. Sous l’onglet Général, sélectionnez Détacher la collection.

   

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

3. (Facultatif) Dans la page Fournir un message de maintenance pour la page collection de projets, dans Message de maintenance, fournissez un message aux utilisateurs susceptibles de tenter de se connecter à des projets de cette collection.

4. Cliquez sur Suivant.

5. Dans les paramètres de révision qui seront utilisés pour détacher la page de collection de projets, passez en revue les détails.

6. Pour modifier les paramètres, sélectionnez Précédent. S’ils semblent corrects, sélectionnez Vérifier.

7. Une fois toutes les vérifications de préparation terminées, sélectionnez Détacher.

8. Dans la page Surveiller la progression de la collection de projets, lorsque tous les processus sont terminés, sélectionnez Suivant.

   

9. (Facultatif) Dans les informations supplémentaires de révision de cette page de collection de projets, sélectionnez ou notez l’emplacement du fichier journal.

10. Sélectionnez Fermer.

    La collection de projets n’apparaît plus dans la liste des regroupements dans la console d’administration.

    

2. Sauvegarder la base de données de collecte

Une fois que vous avez 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.

• Pour plus d’informations sur cette tâche, 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.

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 d’Azure DevOps Server vers lequel vous déplacez la collection. Vous pouvez sélectionner la méthode que vous préférez pour déplacer la 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, consultez :

• Utiliser l’Assistant Copie de base de données
• Copier des bases de données avec sauvegarde et restauration

4. Attacher la collection

Après avoir restauré la base de données de collecte, vous pouvez attacher la collection au déploiement préféré d’Azure DevOps Server. Si le déploiement que vous déplacez pour utiliser la création de rapports, un dossier de rapports et des rapports par défaut sont générés pour la collection que vous attachez dans le cadre du processus.

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 Regroupements de projets, puis attachez la collection.

   

   L’Assistant Attacher la collection de projets s’ouvre.

3. Dans la page Sélectionner la base de données de collection de projets à joindre , 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.

   

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

5. Dans la page Entrer les informations de collection de projets, indiquez un nom pour la collection dans Name si celle-ci n’est pas déjà présente.

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

7. Cliquez sur Suivant.

8. Dans les paramètres de révision qui seront utilisés pour joindre la page de collecte de projets, passez en revue les informations.

9. Pour modifier les paramètres, sélectionnez Précédent. Si tous les paramètres sont corrects, sélectionnez Vérifier.

10. Une fois toutes les vérifications de préparation terminées, sélectionnez Attacher.

11. Dans la page Surveiller la progression de la collection de projets, lorsque tous les processus sont terminés, sélectionnez Suivant.

12. (Facultatif) Dans les informations supplémentaires de révision de cette page de collection de projets, sélectionnez ou notez l’emplacement du fichier journal.

13. Sélectionnez Fermer.

    La collection de projets apparaît dans la liste des regroupements dans la console d’administration.

    

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 envisagez d’utiliser la même application web 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 d’Azure DevOps Server.

Une fois que vous avez déplacé une collection, mettez à jour l’application web et les groupes d’autorisations pour cette collection 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 pour qu’ils correspondent aux emplacements des ressources sur le serveur Azure DevOps actuel. Cela est particulièrement important pour les ressources de création de rapports. Si vous voyez des erreurs, vérifiez que votre compte dispose des autorisations requises pour les administrateurs de regroupements de projets et que d’autres administrateurs de regroupements 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 regroupements 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 d’Azure DevOps Server.

Après avoir configuré les administrateurs pour le regroupement déplacé, vous ou ces 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 Reporting Services.

Ajouter des utilisateurs aux projets

• Pour plus d’informations sur cette tâche, consultez Ajouter des utilisateurs à des projets.

Ajouter des ressources aux projets déplacés

• Pour plus d’informations sur cette tâche, consultez Configurer des ressources pour prendre en charge des projets.

Questions & réponses

Q : Mon déploiement Azure DevOps Server utilise la création de rapports. Comment faire déplacer des rapports avec le déplacement d’une collection ?

R : Tout d’abord, vous devez enregistrer ou exporter les rapports que vous souhaitez déplacer à partir du serveur de rapports qui a pris en charge la collection dans son déploiement d’origine. Vous devrez ensuite charger manuellement chaque rapport sur le serveur de rapports qui prendra en charge la collection déplacée, ce qui peut être un processus long. Déterminez si vous souhaitez charger tous les rapports ou si un sous-ensemble de rapports répond aux besoins de votre entreprise. Vous n’avez pas besoin de charger tous les rapports ou tous les rapports, mais seuls les rapports que vous chargez seront disponibles une fois le processus de déplacement terminé.

Vous devez également reconstruire le cube de l’entrepôt et des services d’analyse sur le déploiement d’origine après avoir déplacé la collection. Par conséquent, le déploiement d’origine n’essaie pas de générer des rapports pour une collection qui n’y figure plus.

Déplacer des rapports

1. Exportez ou enregistrez les rapports que vous souhaitez déplacer à partir du serveur de rapports qui a pris en charge la collection dans son déploiement d’origine. Pour plus d’informations, consultez Exporter des rapports et enregistrer des rapports.

2. Chargez chaque rapport que vous souhaitez déplacer vers le dossier approprié sur le serveur de rapports qui prend 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 modifier la source de données vers le nouveau serveur de rapports.

Reconstruire 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 Création de rapports.

3. Dans Création de rapports, sélectionnez Démarrer la reconstruction.

4. Dans la boîte de dialogue Reconstruire les bases de données Warehouse et Analysis Services, sélectionnez OK.

   Remarque

   Les entrepôts terminent la reconstruction et les données se remplissent à nouveau une fois l’action de reconstruction de démarrage terminée. 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 faire déplacer une collection de projets d’équipe qui inclut des pools de déploiement et/ou des groupes de déploiement ?

R : Lorsque vous déplacez le regroupement 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 provisionné dans l’instance cible. Dans le cas d’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 existe une possibilité de création de plusieurs pools de déploiement. Vous pouvez fusionner les pools en double à 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.

Supprimer les ressources 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 la commande TfSConfig Lab /Delete avec l’option /External .

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

1. Configurez la couche Application pour Azure DevOps.

   Pour plus d’informations, consultez Configurer La gestion des laboratoires pour les environnements SCVMM.

2. Recréez les principales machines virtuelles et modèles dans le nouveau SCVMM et importez des machines virtuelles et des modèles dans la collection de projets.

   Pour plus d’informations, consultez Créer et stocker des machines virtuelles 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 de machines virtuelles stockées et de modèles.

Q : Comment faire restreindre l’accès à la sélection de fonctions dans un projet ?

R : Les utilisateurs disposant d’autorisations pour accéder à un projet au sein d’une collection peuvent afficher d’autres projets au sein de 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 à certaines fonctionnalités et fonctions pour créer ou modifier des artefacts sélectionnés, ainsi que les restreindre à l’affichage des projets, en créant spécifiquement des groupes et en configurant des restrictions sur ces groupes.