Comment : déployer des modifications à l'aide de Team Foundation Build

Article
08/21/2008

Mise à jour : novembre 2007

Vous pouvez générer et déployer votre base de données dans Visual Studio à l'aide de MSBuild ou de Team Foundation Build. Si vous souhaitez générer et déployer votre projet de base de données dans un environnement de laboratoire de génération, vous utilisez Team Foundation Build. Pour utiliser Team Foundation Build, vous devez avoir un ordinateur sur lequel vous l'avez installé. Pour plus d'informations, consultez Vue d'ensemble de Team Foundation Build.

Le processus de déploiement des modifications à l'aide de Team Foundation Build est le suivant :

Créez une définition de build.
Modifiez le fichier projet de build manuellement pour substituer la cible AfterDropBuild standard.
Modifiez le fichier projet de base de données manuellement pour indiquer la connexion et la base de données cibles.
Archivez les fichiers mis à jour.
Utilisez la nouvelle définition de build pour déployer votre projet de base de données.

Avant de pouvoir déployer les modifications à l'aide de Team Foundation Build, vous devez :

disposer d'un projet de base de données avec des propriétés définies ;
archiver le projet de base de données dans le contrôle de version.

Remarque :
Avant de pouvoir générer un projet de base de données, vous devez configurer l'instance de la base de données de validation au moment du design pour le compte de service sur l'ordinateur sur lequel vous exécutez Team Foundation Build. Vous pouvez configurer l'instance en exécutant Visual Studio comme compte de service sur l'ordinateur de build. Vous pouvez également utiliser la ligne de commande suivante pour créer l'entrée du Registre nécessaire, en remplaçant les espaces réservés par les noms de votre configuration: Runas /user:[DOMAIN\NomUtilisateurServiceBuild] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v NomServerSql /d [NomInstanceLocale]"

Avant de pouvoir générer un projet de base de données, vous devez configurer l'instance de la base de données de validation au moment du design pour le compte de service sur l'ordinateur sur lequel vous exécutez Team Foundation Build. Vous pouvez configurer l'instance en exécutant Visual Studio comme compte de service sur l'ordinateur de build. Vous pouvez également utiliser la ligne de commande suivante pour créer l'entrée du Registre nécessaire, en remplaçant les espaces réservés par les noms de votre configuration:

Runas /user:[DOMAIN\NomUtilisateurServiceBuild] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v NomServerSql /d [NomInstanceLocale]"

Créer une définition de build

Pour créer une définition de build

Ouvrez Visual Studio avec Team Explorer.
Ouvrez la solution qui contient le projet de base de données que vous voulez déployer.
Créez une définition de build. Pour plus d'informations, consultez Comment : créer une définition de build. Lorsque vous créez la définition de build, indiquez la solution en cours à générer. Si vous n'avez pas créé de configuration de projet personnalisée, cliquez sur la configuration par défaut.

Vous modifiez ensuite le fichier BuildDefinition.proj.

Modifier le fichier projet de build

Pour déployer le projet de base de données, vous devez remplacer la cible AfterDropBuild par la tâche SqlDeploy.

Pour modifier le fichier projet de build

Extrayez le fichier BuildDefinition.proj à partir du contrôle de version. Si vous utilisez le contrôle de version Team Foundation, ouvrez l'Explorateur du contrôle de code source, développez le projet d'équipe, puis le dossier TeamBuildTypes pour rechercher les fichiers projet de build.
Ouvrez le fichier BuildDefinition.proj dans l'éditeur de votre choix.
En bas du fichier, entre l'élément </ItemGroup> et l'élément </Project>, ajoutez le code suivant :
```
<Target Name="AfterDropBuild">
  <MSBuild Projects="$(SolutionRoot)\SolutionName\ProjectName\ProjectName.dbproj" Properties="Configuration=Default;OutDir=$(SolutionRoot)\..\binaries\Default\" Targets="Deploy" />
</Target>
```
Remplacez NomSolution par le nom de la solution qui contient le projet de base de données et remplacez NomProjet par le nom du projet de base de données. Si vous n'utilisez pas la configuration par défaut pour votre projet de base de données, remplacez-la par le nom de la configuration de projet appropriée à la fois dans Configuration et dans OutDir.

Team Foundation Build copie des fichiers vers un emplacement cible qui est généralement un partage réseau. Si vous souhaitez déployer la base de données à partir de cet emplacement au lieu de l'ordinateur de build, vous utiliserez à la place les éléments suivants :
```
<Target Name="AfterDropBuild">
  <MSBuild Projects="$(SolutionRoot)\SolutionName\ProjectName\ ProjectName.dbproj" Properties="Configuration=Release;OutDir=$(DropLocation)\$(BuildNumber)\Release\" Targets="Deploy"/>
</Target>
```
Enregistrez les modifications apportées au fichier BuildDefinition.Proj.

Modifier le fichier projet de base de données

La base de données et la connexion cibles sont stockées dans le fichier NomProjet.dbproj.user, qui est spécifique à l'utilisateur et généralement pas archivé dans le contrôle de version. Vous avez besoin de ces paramètres pour déployer votre base de données. Par conséquent, vous devez modifier le fichier NomProjet.dbproj manuellement pour indiquer la base de données et la connexion cibles.

Pour modifier le fichier projet de base de données

Extrayez le fichier NomProjet.dbproj de votre système de contrôle de version.
Dans le menu Fichier, cliquez sur Fermer la solution. Cette étape est nécessaire, car vous ne pouvez pas modifier un fichier projet qui se trouve dans une solution ouverte.
Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Fichier.
Accédez au dossier qui contient le fichier projet de base de données (NomProjet.dbproj) et double-cliquez sur NomProjet.dbproj.user.
Copiez les lignes qui contiennent les définitions des propriétés TargetDatabase et TargetConnectionString à partir de la section du fichier NomProjet.dbproj.user pour la configuration à générer. Ces lignes doivent se présenter comme suit :
```
<TargetDatabase>MyTargetDatabaseName</TargetDatabase>
<TargetConnectionString>Data Source=ServerName\InstanceName;Integrated Security=True;Pooling=False</TargetConnectionString>
```
Remarque :

Le nom du projet de base de données est utilisé si vous ne spécifiez pas le nom d'une base de données cible.
Copiez ces deux entrées dans le Presse-papiers.
Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Fichier.
Accédez au dossier qui contient le fichier projet de base de données (NomProjet.dbproj) et double-cliquez sur NomProjet.dbproj.
Faites défiler jusqu'à PropertyGroup pour obtenir la configuration à déployer à l'aide de Team Foundation Build.
Collez les entrées que vous avez copiées dans le Presse-papiers dans le fichier projet. Si TargetDatabase et TargetConnectionString contiennent déjà des éléments vides, vous devez remplacer ces entrées.
Dans le menu Fichier, cliquez sur Enregistrer NomProjet.dbproj.

Remarque :
Le nom du projet de base de données est utilisé si vous ne spécifiez pas le nom d'une base de données cible.

Archiver les fichiers mis à jour

Team Foundation Build utilise la version du projet de base de données qui est archivée dans le contrôle de version. Avant d'utiliser cette version pour déployer votre base de données, vous devez archiver les modifications que vous avez apportées au projet de build et au fichier projet de base de données.

Pour archiver les fichiers mis à jour

Dans le menu Fichier, pointez sur Contrôle de code source, puis cliquez sur Archiver les modifications en attente.
Suivez les instructions relatives à votre système de contrôle de version pour terminer l'archivage du projet de build et du fichier projet de base de données.

Déployer la base de données

Vous venez de configurer la définition de build et le projet de base de données à utiliser avec Team Foundation Build. Vous pouvez procéder à une génération de test pour vérifier si votre base de données se déploie correctement.

Pour déployer votre base de données

Dans Team Explorer, développez le dossier Builds d'équipe, cliquez avec le bouton droit sur la définition de build que vous avez créée pour déployer le projet de base de données, puis cliquez sur Mettre en file d'attente la build NomProjetÉquipe.

La boîte de dialogue Générer s'affiche.
Confirmez que les valeurs qui figurent dans les champs Définition de build, Agent de build et Dossier cible pour cette build sont toutes appropriées, puis cliquez sur File d'attente.

L'onglet En attente de l'Explorateur de builds s'affiche. Pour plus d'informations, consultez Fonctionnement de l'Explorateur Team Foundation Build.

Voir aussi

Partager via