Gewusst wie: Bereitstellen von Änderungen mit Team Foundation Build

Článek
09/03/2008

Aktualisiert: November 2007

Sie können die Datenbank in Visual Studio mit MSBuild oder Team Foundation Build erstellen und bereitstellen. Wenn Sie das Datenbankprojekt in einer Build Lab-Umgebung erstellen und bereitstellen möchten, verwenden Sie Team Foundation Build. Für die Verwendung von Team Foundation Build müssen Sie über einen Computer verfügen, auf dem die Anwendung installiert ist. Weitere Informationen finden Sie unter Übersicht über Team Foundation Build.

Änderungen werden mit Team Foundation Build auf folgende Weise bereitgestellt:

Erstellen Sie eine Builddefinition.
Ändern Sie die Buildprojektdatei manuell, um das AfterDropBuild-Standardziel zu überschreiben.
Ändern Sie die Datenbankprojektdatei manuell, um die Zieldatenbank und -verbindung anzugeben.
Checken Sie die aktualisierten Dateien ein.
Verwenden Sie die neue Builddefinition, um das Datenbankprojekt bereitzustellen.

Bevor Sie Änderungen mit Team Foundation Build bereitstellen können, müssen folgende Voraussetzungen erfüllt sein:

Sie müssen über ein Datenbankprojekt mit festgelegten Eigenschaften verfügen.
Sie müssen das Datenbankprojekt in die Versionskontrolle einchecken.

Hinweis:
Bevor Sie ein Datenbankprojekt erstellen können, müssen Sie die Instanz der Datenbank für die Entwurfszeitvalidierung für das Dienstkonto auf dem Computer konfigurieren, auf dem Sie Team Foundation Build ausführen. Sie können die Instanz konfigurieren, indem Sie auf dem Buildcomputer Visual Studio als Dienstkonto ausführen. Alternativ können Sie auch mit der folgenden Befehlszeile den erforderlichen Registrierungseintrag erstellen. Dabei müssen Sie die Platzhalter mit den entsprechenden Namen für die Konfiguration ersetzen. Runas /user:[DOMAIN\BuildServiceUserName] "REG ADD HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\9.0\DBPro\DialogPage\Microsoft.VisualStudio.TeamSystem.Data.DBProject.Settings.DataConnectionOptionsSettings /v SqlServerName /d [LocalInstanceName]"

Bevor Sie ein Datenbankprojekt erstellen können, müssen Sie die Instanz der Datenbank für die Entwurfszeitvalidierung für das Dienstkonto auf dem Computer konfigurieren, auf dem Sie Team Foundation Build ausführen. Sie können die Instanz konfigurieren, indem Sie auf dem Buildcomputer Visual Studio als Dienstkonto ausführen. Alternativ können Sie auch mit der folgenden Befehlszeile den erforderlichen Registrierungseintrag erstellen. Dabei müssen Sie die Platzhalter mit den entsprechenden Namen für die Konfiguration ersetzen.

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

Erstellen einer Builddefinition

So erstellen Sie eine Builddefinition

Öffnen Sie Visual Studio mit Team Explorer.
Öffnen Sie die Projektmappe, die das bereitzustellende Datenbankprojekt enthält.
Erstellen Sie eine Builddefinition. Weitere Informationen hierzu finden Sie unter Gewusst wie: Erstellen einer Builddefinition. Wenn Sie die Builddefinition erstellen, geben Sie die aktuelle Projektmappe an, die erstellt werden soll. Wenn Sie keine benutzerdefinierte Projektkonfiguration erstellt haben, klicken Sie auf die Standardkonfiguration.

Anschließend ändern Sie die Datei BuildDefinition.proj.

Ändern der Buildprojektdatei

Um das Datenbankprojekt bereitzustellen, müssen Sie das Ziel AfterDropBuild mit der Task SqlDeploy überschreiben.

So ändern Sie die Buildprojektdatei

Checken Sie die Datei BuildDefinition.proj aus der Versionskontrolle aus. Wenn Sie Team Foundation-Versionskontrolle verwenden, öffnen Sie den Quellcodeverwaltungs-Explorer, erweitern Sie das Teamprojekt, und erweitern Sie den Ordner TeamBuildTypes, um die Buildprojektdateien zu suchen.
Öffnen Sie die Datei BuildDefinition.proj in einem Editor Ihrer Wahl.
Fügen Sie am Dateiende zwischen dem </ItemGroup>-Element und dem </Project>-Element Folgendes ein:
```
<Target Name="AfterDropBuild">
  <MSBuild Projects="$(SolutionRoot)\SolutionName\ProjectName\ProjectName.dbproj" Properties="Configuration=Default;OutDir=$(SolutionRoot)\..\binaries\Default\" Targets="Deploy" />
</Target>
```
Ersetzen Sie Projektmappenname durch den Namen der Projektmappe, die das Datenbankprojekt enthält, und ersetzen Sie Projektname durch den Namen des Datenbankprojekts. Wenn Sie nicht die Standardkonfiguration für das Datenbankprojekt verwenden, ersetzen Sie in Configuration und in OutDir den Eintrag Default durch den Namen der entsprechenden Projektkonfiguration.

Team Foundation Build kopiert Dateien an einen Ablagespeicherort, bei dem es sich normalerweise um eine Netzwerkfreigabe handelt. Wenn Sie die Datenbank anstatt vom Buildcomputer von diesem Speicherort bereitstellen möchten, fügen Sie stattdessen Folgendes ein:
```
<Target Name="AfterDropBuild">
  <MSBuild Projects="$(SolutionRoot)\SolutionName\ProjectName\ ProjectName.dbproj" Properties="Configuration=Release;OutDir=$(DropLocation)\$(BuildNumber)\Release\" Targets="Deploy"/>
</Target>
```
Speichern Sie die Änderungen von BuildDefinition.proj.

Ändern der Datenbankprojektdatei

Die Zielverbindung und die Zieldatenbank werden in der Datei Projektname.dbproj.user gespeichert, die benutzerspezifisch ist und i. d. R. nicht in die Versionskontrolle eingecheckt wird. Diese Einstellungen benötigen Sie zum Bereitstellen der Datenbank. Darum müssen Sie die Datei Projektname.dbproj manuell ändern, um die Zielverbindung und die Zieldatenbank anzugeben.

So ändern Sie die Datenbankprojektdatei

Checken Sie die Datei Projektname.dbproj aus dem Versionskontrollsystem aus.
Klicken Sie im Menü Datei auf Projektmappe schließen. Dieser Schritt ist erforderlich, weil Sie Projektdateien nicht ändern können, die sich in einer geöffneten Projektmappe befinden.
Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie auf Datei.
Navigieren Sie zu dem Ordner, der die Datenbankprojektdatei (Projektname.dbproj) enthält, und doppelklicken Sie auf Projektname.dbproj.user.
Kopieren Sie die Zeilen, die die Definitionen für die TargetDatabase -Eigenschaft und die TargetConnectionString-Eigenschaft enthalten, aus dem Abschnitt in der Datei Projektname.dbproj.user für die zu erstellende Konfiguration. Die Zeilen sollten den folgenden entsprechen:
```
<TargetDatabase>MyTargetDatabaseName</TargetDatabase>
<TargetConnectionString>Data Source=ServerName\InstanceName;Integrated Security=True;Pooling=False</TargetConnectionString>
```
Hinweis:

Der Name des Datenbankprojekts wird verwendet, wenn Sie keinen Namen einer Zieldatenbank angeben.
Kopieren Sie diese beiden Einträge in die Zwischenablage.
Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie auf Datei.
Navigieren Sie zu dem Ordner, der die Datenbankprojektdatei (Projektname.dbproj) enthält, und doppelklicken Sie auf Projektname.dbproj.
Führen Sie einen Bildlauf nach unten zu der PropertyGroup für die Konfiguration durch, die Sie mit Team Foundation Build bereitstellen möchten.
Fügen Sie die Einträge, die Sie in die Zwischenablage kopiert haben, in die Projektdatei ein. Wenn TargetDatabase und TargetConnectionString bereits leere Elemente enthalten, überschreiben Sie diese Einträge.
Klicken Sie im Menü Datei auf Projektname.dbprojspeichern.

Hinweis:
Der Name des Datenbankprojekts wird verwendet, wenn Sie keinen Namen einer Zieldatenbank angeben.

Einchecken der aktualisierten Dateien

In Team Foundation Build wird die Version des Datenbankprojekts verwendet, die in die Versionskontrolle eingecheckt ist. Bevor Sie diese Version zum Bereitstellen der Datenbank verwenden, müssen Sie die Änderungen einchecken, die Sie am Buildprojekt und an der Datenbankprojektdatei vorgenommen haben.

So checken Sie die aktualisierten Dateien ein

Zeigen Sie im Menü Datei auf Quellcodeverwaltung, und klicken Sie auf Ausstehende Änderungen einchecken.
Befolgen Sie die Anweisungen für das von Ihnen verwendete Versionskontrollsystem, um den Eincheckvorgang für das Buildprojekt und die Datenbankprojektdatei abzuschließen.

Bereitstellen der Datenbank

Sie haben jetzt die Builddefinition konfiguriert und das Datenbankprojekt für die Verwendung in Team Foundation Build eingerichtet. Sie können einen Testbuild ausführen, um zu überprüfen, ob die Datenbank erfolgreich bereitgestellt wird.

So stellen Sie die Datenbank bereit

Erweitern Sie im Team Explorer den Ordner Teambuilds, klicken Sie mit der rechten Maustaste auf die Builddefinition, die Sie zum Bereitstellen des Datenbankprojekts erstellt haben, und klicken Sie auf Build zur Warteschlange hinzufügen TeamProjektname.

Das Dialogfeld Erstellen wird angezeigt.
Bestätigen Sie die Werte in den Feldern Builddefinition, Buildagent und Ablageordner für diesen Build, und klicken Sie dann auf Warteschlange.

Die Registerkarte In Warteschlange gestellt von Build Explorer wird angezeigt. Weitere Informationen hierzu finden Sie unter Informationen zum Team Foundation Build Explorer.

Siehe auch

Sdílet prostřednictvím