Gewusst wie: Ausführen von SQL Server-Komponententests aus Team Foundation Build
Sie können Team Foundation Build verwenden, um SQL Server-Komponententests im Rahmen eines Buildüberprüfungstests (Build Verification Test, BVT) auszuführen. Komponententests können so konfiguriert werden, dass sie die Datenbank bereitstellen, Testdaten generieren und ausgewählte Tests ausführen. Wenn Sie mit Team Foundation Build nicht vertraut sind, sollten Sie die folgenden Informationen lesen, bevor Sie die Schritte in diesem Thema ausführen:
Bevor Sie diese Schritte ausführen, müssen Sie erst die Arbeitsumgebung anhand der folgenden Aufgaben konfigurieren:
Installieren Sie Team Foundation Build sowie die Team Foundation-Versionskontrolle. Team Foundation Build und Team Foundation-Versionskontrolle müssen u. U. auf unterschiedlichen Computern installiert werden.
Installieren Sie die Microsoft SQL Server Data Tools-Buildhilfsprogramme auf demselben Computer wie Team Foundation Build. Zum Installieren der SQL Server Data Tools-Buildhilfsprogramme führen Sie zunächst einen Administratorinstallationspfad aus. Weitere Informationen zu Administratorinstallationspfaden finden Sie unter Installieren von SQL Server Data Tools. Installieren Sie anschließend SSDTBuildUtilties.msi von dem für den Administratorinstallationspunkt verwendeten Pfad (/location) auf dem Buildserver.
Stellen Sie eine Verbindung mit einer Instanz von Visual Studio Team Foundation Server her.
Nachdem Sie die Arbeitsumgebung konfiguriert haben, müssen Sie die folgenden Schritte ausführen:
Erstellen Sie ein Datenbankprojekt.
Importieren oder erstellen Sie das Schema und die Objekte für das Datenbankprojekt.
Konfigurieren Sie die Eigenschaften des Datenbankprojekts für den Build- und Bereitstellungsprozess.
Erstellen Sie mindestens einen Komponententest.
Fügen Sie der Versionskontrolle die Projektmappe hinzu, in der das Datenbankprojekt und das Komponententestprojekt enthalten sind, und checken Sie alle Dateien ein.
Die Schritte in diesem Thema verdeutlichen, wie Sie eine Builddefinition erstellen, um Komponententests im Rahmen eines automatisierten Testlaufs auszuführen:
Ausführen von SQL Server-Komponententests auf einem Buildcomputer
Wenn Sie Komponententests auf einem Buildcomputer ausführen, sind die Komponententests möglicherweise nicht in der Lage, die Datenbankprojektdateien (.sqlproj) zu finden. Dieses Problem tritt auf, weil die Datei app.config über relative Pfade auf diese Dateien verweist. Darüber hinaus kann bei den Komponententests ein Fehler auftreteten, wenn die Instanz von SQL Server, die zum Ausführen der Komponententests verwendet werden soll, nicht gefunden wird. Dieses Problem kann auftreten, wenn die in der Datei app.config gespeicherten Verbindungszeichenfolgen auf dem Buildcomputer ungültig sind.
Zur Lösung dieser Probleme müssen Sie einen Überschreibungsabschnitt in der Datei app.config angeben, durch den app.config mit einer Konfigurationsdatei überschrieben wird, die spezifisch für die Team Foundation Build-Umgebung ist. Weitere Informationen finden Sie weiter unten in diesem Thema unter Ändern des Testprojekts.
Konfigurieren von Testeinstellungen zum Ausführen von SQL Server-Komponententests unter einem x64-Build-Agent
Bevor Sie Komponententests unter einem x64-Build-Agent ausführen können, müssen Sie die Testeinstellungen konfigurieren, um die Hostprozessplattform zu wechseln.
So geben Sie die Hostprozessplattform an
Öffnen Sie die Projektmappe mit dem Testprojekt, für das Sie Einstellungen konfigurieren möchten.
Doppelklicken Sie im Projektmappen-Explorer im Ordner Projektmappenelemente auf die Datei Local.testsettings.
Das Dialogfeld Testeinstellungen wird angezeigt.
Klicken Sie in der Liste auf Hosts.
Klicken Sie im Detailbereich unter Hostprozessplattform auf MSIL, um die Tests zur Ausführung unter einem x64-Build-Agent zu konfigurieren.
Klicken Sie auf Anwenden.
Zuweisen von Tests zu einer Testkategorie (optional)
Wenn Sie eine Builddefinition zum Ausführen von Komponententests erstellen, geben Sie normalerweise mindestens eine Testkategorie an. Alle Tests in den angegebenen Kategorien werden zusammen mit dem Build ausgeführt.
So weisen Sie einer Testkategorie Tests zu
Öffnen Sie das Fenster Testansicht.
Wählen Sie einen Test aus.
Klicken Sie im Eigenschaftenbereich auf Testkategorien, und klicken Sie auf die Auslassungspunkte (...) in der äußersten rechten Spalte.
Geben Sie im Fenster Testkategorie im Feld Neue Kategorie hinzufügen einen Namen für die neue Testkategorie an.
Klicken Sie auf Hinzufügen, und klicken Sie dann auf OK.
Die neue Testkategorie wird dem Test zugewiesen und den anderen Tests über ihre Eigenschaften zur Verfügung gestellt.
Ändern des Testprojekts
Team Foundation Build erstellt standardmäßig eine Konfigurationsdatei aus der Datei app.config des Projekts, wenn das Komponententestprojekt erstellt wird. Der Pfad zum Datenbankprojekt wird als relativer Pfad in der Datei „app.config“ gespeichert. Die relativen Pfade, die in Visual Studio funktionieren, sind nicht kompatibel, weil Team Foundation Build die erstellten Dateien – je nachdem, wo die Komponententests ausgeführt werden – an verschiedenen Orten ablegt. Zusätzlich enthält die Datei app.config die Verbindungszeichenfolgen, in denen die zu testende Datenbank angegeben ist. Darüber hinaus benötigen Sie eine separate Datei app.config für Team Foundation Build, wenn die Komponententests eine Verbindung mit einer anderen Datenbank als der Datenbank herstellen müssen, die bei der Erstellung des Testprojekts verwendet wurde. Durch die in den folgenden Schritten vorgenommenen Änderungen können Sie das Testprojekt und den Buildserver so einrichten, dass Team Foundation Build eine andere Konfiguration verwendet.
Wichtig
Sie müssen diese Schritte für jedes Testprojekt (.vbproj oder .vsproj) ausführen.
So geben Sie eine Datei "app.config" für Team Foundation Build an
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Datei „app.config“, und klicken Sie auf Kopieren.
Klicken Sie mit der rechten Maustaste auf das Testprojekt, und klicken Sie auf Einfügen.
Klicken Sie mit der rechten Maustaste auf die Datei Kopie von app.config, und klicken Sie auf „Umbenennen“.
Geben Sie BuildComputer.sqlunitttest.config ein, und drücken Sie die EINGABETASTE. Dabei entspricht BuildComputer dem Namen des Computers, auf dem der Build-Agent ausgeführt wird.
Doppelklicken Sie auf „BuildComputer.sqlunitttest.config“.
Die Konfigurationsdatei wird im Editor geöffnet.
Ändern Sie den relativen Pfad zu der Datei mit der Erweiterung .sqlproj, indem Sie eine Ordnerebene für den Ordner Quellen und einen Unterordner mit dem Namen der Projektmappe hinzufügen. Beispiel: Die Konfigurationsdatei enthält anfänglich den folgenden Eintrag:
<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj" Configuration="Debug" />Aktualisieren Sie die Datei wie folgt:
<DatabaseDeployment DatabaseProjectFileName="..\..\..\Database3\Database3.sqlproj" Configuration="Debug" />Wenn Sie fertig sind, sollte die Datei „BuildComputer.sqlunitttest.config“ wie im folgenden Beispiel für Visual Studio 2010 aussehen:
<SqlUnitTesting_VS2010> <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj" Configuration="Debug" /> <DataGeneration ClearDatabase="true" /> <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> </SqlUnitTesting_VS2010>Oder, wenn Sie Visual Studio 2012 verwenden:
<SqlUnitTesting_VS2012> <DatabaseDeployment DatabaseProjectFileName="..\..\..\Database4\Database4.sqlproj" Configuration="Debug" /> <DataGeneration ClearDatabase="true" /> <ExecutionContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> <PrivilegedContext Provider="System.Data.SqlClient" ConnectionString="Data Source=(localdb)\Projects;Initial Catalog=Database4;Integrated Security=True;Pooling=False" CommandTimeout="30" /> </SqlUnitTesting_VS2012>Aktualisieren Sie das ConnectionString-Attribut für ExecutionContext und PrivilegedContext, um Verbindungen mit der Zieldatenbank anzugeben, die zur Bereitstellung verwendet werden soll.
Klicken Sie im Menü Datei auf Alle speichern.
Doppelklicken Sie im Projektmappen-Explorer auf app.config.
Fügen Sie im Editor für jeden <SqlUnitTesting_VSVersion>-Knoten
AllowConfigurationOverride="true"hinzu. Beispiel:-- Update SqlUnitTesting_VS2010 node to: <SqlUnitTesting_VS2010 AllowConfigurationOverride="true"> -- Update SqlUnitTesting_VS2012 node to: <SqlUnitTesting_VS2012 AllowConfigurationOverride="true">Durch diese Änderung ermöglichen Sie Team Foundation Build die Verwendung der von Ihnen erstellten Ersatzkonfigurationsdatei.
Klicken Sie im Menü Datei auf Alle speichern.
Als Nächstes müssen Sie Local.testsettings aktualisieren, um die angepasste Konfigurationsdatei einzuschließen.
So passen Sie Local.testsettings für die Bereitstellung der angepassten Konfigurationsdatei an
Doppelklicken Sie im Projektmappen-Explorer auf Local.testsettings.
Das Dialogfeld Testeinstellungen wird angezeigt.
Klicken Sie in der Liste der Kategorien auf Bereitstellung.
Aktivieren Sie das Kontrollkästchen Bereitstellung aktivieren.
Klicken Sie auf Datei hinzufügen.
Geben Sie im Dialogfeld Bereitstellungsdateien hinzufügen die erstellte Datei „BuildComputer.sqlunitttest.config“ an.
Klicken Sie auf Anwenden.
Klicken Sie auf Schließen.
Klicken Sie im Menü Datei auf Alle speichern.
Als Nächstes checken Sie die Projektmappe in die Versionskontrolle ein.
Einchecken der Projektmappe
In dieser Prozedur checken Sie alle Dateien der Projektmappe ein. Diese Dateien enthalten die Testmetadatendatei der Projektmappe, in der die Testkategoriezuweisungen und -tests enthalten sind. Sobald Sie Testinhalt hinzufügen, löschen, neu anordnen oder ändern, wird die Testmetadatendatei automatisch anhand dieser Änderungen aktualisiert.
Hinweis
In diesem Verfahren werden die Schritte beschrieben, die bei Verwendung der Team Foundation-Versionskontrolle gelten. Wenn Sie eine andere Versionskontrollsoftware verwenden, müssen Sie die für diese Software geltenden Schritte ausführen.
So checken Sie die Projektmappe ein
Stellen Sie eine Verbindung mit einem Computer her, auf dem Team Foundation Server ausgeführt wird.
Weitere Informationen finden Sie unter Verwenden des Quellcodeverwaltungs-Explorers.
Wenn die Projektmappe nicht bereits in der Quellcodeverwaltung enthalten ist, fügen Sie sie der Quellcodeverwaltung hinzu.
Weitere Informationen finden Sie unter Hinzufügen eines Projekts oder einer Projektmappe zur Versionskontrolle.
Klicken Sie auf Ansicht und dann auf Anstehende Eincheckvorgänge.
Checken Sie alle Dateien der Projektmappe ein.
Weitere Informationen finden Sie unter Einchecken ausstehender Änderungen.
Hinweis
Möglicherweise unterliegen die Schritte einem spezifischen Teamprozess, der regelt, wie automatisierte Tests erstellt und verwaltet werden. Beispielsweise kann der Prozess erforderlich machen, dass Sie den Build lokal überprüfen, bevor Sie diesen Code zusammen mit den Tests einchecken, die für den Code ausgeführt werden sollen.
Im Projektmappen-Explorer wird neben jeder Datei ein Vorhängeschloss als Symbol angezeigt, um anzugeben, dass sie eingecheckt ist. Weitere Informationen finden Sie unter Anzeigen der Eigenschaften von Dateien und Ordnern, die der Versionskontrolle unterliegen.
Die Tests stehen Team Foundation Build zur Verfügung. Sie können jetzt eine Builddefinition erstellen, in der die auszuführenden Tests enthalten sind.
Erstellen einer Builddefinition
So erstellen Sie eine Builddefinition
Klicken Sie im Team Explorer auf das Teamprojekt, klicken Sie mit der rechten Maustaste auf den Knoten Builds, und klicken Sie dann auf Neue Builddefinition.
Das Fenster Neue Builddefinition wird angezeigt.
Geben Sie unter Builddefinitionsname den Namen ein, den Sie für die Builddefinition verwenden möchten.
Klicken Sie auf der Navigationsleiste auf Buildstandardwerte.
In Kopieren Sie die Build-Ausgabe in den folgenden Ablageordner (UNC-Pfad, z.B. \\server\share), geben Sie einen Ordner an, der die Build-Ausgabe enthalten soll.
Sie können einen freigegebenen Ordner auf dem lokalen Computer bzw. einen beliebigen Netzwerkpfad angeben, für den der Buildprozess über eine Zugriffsberechtigung verfügt.
Klicken Sie auf der Navigationsleiste auf Verarbeiten.
Klicken Sie in der Gruppe Erforderlich unter Zu erstellende Elemente auf die Schaltfläche zum Durchsuchen (...).
Klicken Sie im Dialogfeld Buildprojektlisten-Editor auf Hinzufügen.
Geben Sie die Projektmappendatei (.sln) an, die Sie der Versionskontrolle weiter oben in dieser exemplarischen Vorgehensweise hinzugefügt haben, und klicken Sie auf OK.
Die Projektmappe wird in der Liste Zu erstellende Projektmappen- oder Projektdateien angezeigt.
Klicken Sie auf OK.
Geben Sie in der Gruppe Standard unter Automatisierte Tests die Tests an, die Sie ausführen möchten. Standardmäßig werden die Tests ausgeführt, die in der Projektmappe in Dateien mit dem Namen *test*.dll enthalten sind.
Klicken Sie im Menü Datei auf Projektname speichern.
Die Builddefinition ist jetzt erstellt. Als Nächstes ändern Sie das Testprojekt.
Ausführen der neuen Builddefinition
So führen Sie den neuen Buildtyp aus
Erweitern Sie im Team-Explorer erst den Teamprojektknoten und dann den Knoten Builds. Klicken Sie mit der rechten Maustaste auf die Builddefinition, die Sie ausführen möchten, und klicken Sie dann auf Neuen Build in Warteschlange.
Das Dialogfeld Build {TeamProjectName} zur Warteschlange hinzufügen wird mit einer Liste aller vorhandenen Buildtypen angezeigt.
Klicken Sie unter Builddefinition ggf. auf die neue Builddefinition.
Überprüfen Sie, ob die Werte in den Feldern Builddefinition, Build-Agent und Ablageordner für diesen Build richtig sind, und klicken Sie auf Warteschlange.
Die Registerkarte In Warteschlange gestellt wird im Build-Explorer angezeigt. Weitere Informationen finden Sie unter Verwalten und Anzeigen abgeschlossener Builds (Visual Studio 2010) oder Verwalten von Builds im Build-Explorer (Visual Studio 2012).
Weitere Informationen
Ausführen von SQL Server-Komponententests
Erstellen oder Bearbeiten einer Builddefinition
Einreihen eines Builds in die Warteschlange
Überwachen des Status eines Builds während der Ausführung