Exemplarische Vorgehensweise: Erstellen eines Buildtyps im Team Foundation-Build
In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie ein Buildtyp für Team Foundation Build konfiguriert wird. Bevor Sie mit dieser exemplarischen Vorgehensweise beginnen, müssen Sie Grundkenntnisse über Team Foundation Build besitzen. Weitere Informationen finden Sie unter Verwalten von Builds mit Team Foundation Build.
In dieser exemplarischen Vorgehensweise gehen Sie schrittweise vor und konfigurieren einen Buildtyp mit dem Assistenten zum Erstellen neuer Teambuildtypen. Außerdem richten Sie die Berechtigungen ein, die für den Buildcomputer und die Benutzer erforderlich sind, die die erstellten Buildtypen ausführen. Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:
Erstellen eines neuen Buildtyps.
Auswählen der zu erstellenden Projektmappen.
Auswählen eines Buildcomputers und eines Ablagespeicherortes.
Auswählen der Buildschritte.
Auswählen einer Konfiguration und der Plattformen für den Build.
Einrichten von Berechtigungen auf dem Buildcomputer.
Einrichten von Berechtigungen für angegebene Benutzer, sodass diese den erstellten Buildtyp ausführen können.
Vorbereitungsmaßnahmen
Visual Studio 2005 Team System.
Eine Verbindung mit Team Foundation Server und mindestens ein vorhandenes Teamprojekt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Herstellen einer Verknüpfung mit einem Teamprojekt und Gewusst wie: Erstellen eines Teamprojekts.
Ein Arbeitsbereich auf dem Quellcodeverwaltungsserver, der mindestens eine zu erstellende Projektmappe enthält. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Arbeitsbereichs.
So erstellen Sie einen neuen Buildtyp
Wählen Sie im Menü Erstellen die Option Neuer Teambuildtyp aus. Der Assistent zum Erstellen neuer Teambuildtypen wird angezeigt.
Geben Sie im Assistenten zum Erstellen neuer Teambuildtypen im Textfeld Welchen Namen soll dieser Teambuildtyp erhalten den Namen an, der dem Buildtyp zugeordnet werden soll.
Hinweis
Sie müssen über die Team Foundation Server-Sicherheitsberechtigung Build verwalten verfügen, um einen Buildtyp erstellen zu können. Weitere Informationen finden Sie unter Sicherheitsrechte und Berechtigungen für Team Foundation Build.
Hinweis
Mit einer Validierung wird überprüft, ob der eingegebene Name bereits für einen eingerichteten Buildtyp vorhanden ist. Wenn der Name vorhanden ist, werden Sie aufgefordert, einen eindeutigen Namen einzugeben. Der Buildtypname muss ein gültiger Windows-Dateiname sein und darf nicht $ enthalten.
Fügen Sie im Textfeld Beschreibung eine geeignete Beschreibung hinzu, und klicken Sie zum Fortfahren auf Weiter. Der Schritt Zu erstellende Projektmappen auswählen und sortieren wird angezeigt.
Tipp
Die Schaltfläche Weiter ist nur dann aktiviert, wenn alle erforderlichen Felder ordnungsgemäß ausgefüllt wurden.
Wählen Sie im Dropdown-Listenfeld unter Aus welchem Arbeitsbereich sollen zu erstellende Projektmappen ausgewählt werden den Arbeitsbereich mit den Projektmappen aus, die Sie im Buildtyp einschließen möchten. In der Dropdownoption werden der Arbeitsbereichsname und der Benutzer angezeigt, der diesen erstellt hat.
Markieren Sie in der Auflistung Projektmappen auswählen und sortieren die Projektmappe bzw. Projektmappen, die Sie dem Buildtypen hinzufügen möchten.
Wählen Sie die Projektmappen aus, und ändern Sie deren Position in der Buildreihenfolge mit den Pfeilschaltflächen rechts neben der Liste. Projektmappen werden nacheinander erstellt, wobei am Anfang der Liste begonnen wird.
Tipp
Beachten Sie beim Bestimmen der Reihenfolge, in der die Projektmappen erstellt werden sollen, dass eine Projektmappe Abhängigkeiten mit einer anderen aufweisen kann. Legen Sie beispielsweise fest, dass Projektmappe 1 vor Projektmappe 2 erstellt wird, wenn Projektmappe 2 eine Abhängigkeit mit Projektmappe 1 aufweist.
Wenn Sie die gewünschten Projektmappen ausgewählt und die Reihenfolge ihrer Erstellung angegeben haben, klicken Sie auf Weiter. Der Schritt Zu erstellende Konfigurationen auswählen wird angezeigt.
Wählen Sie in der Tabelle unter Welche Konfigurationen möchten Sie erstellen die gewünschte Konfiguration und die Plattformen aus, die in dem Build eingeschlossen werden sollen. Die Buildkonfiguration gibt die gewünschte Konfiguration und die Plattform an (z. B. Retail und AnyCPU).
Wenn Sie die Buildkonfiguration ausgewählt haben, klicken Sie auf Weiter. Der Schritt Buildspeicherort auswählen wird angezeigt.
Geben Sie im Textfeld für Auf welchem Computer möchten Sie die ausgewählten Projektmappen erstellen? den Computernamen ein, z. B. MachineA_Lab1.
Geben Sie im Textfeld für Buildverzeichnis auf ausgewähltem Computer das Verzeichnis für den Build ein. Hierbei handelt es sich um ein lokales Verzeichnis auf dem Buildcomputer. Beispiel: D:\AdventureWorks\TourPackageServices\.
Hinweis
Achten Sie beim Auswählen des Buildverzeichnisses darauf, dass für den Build genügend Speicherplatz vorhanden ist. Nicht ausreichender Speicher verursacht das Fehlschlagen von Builds.
Geben Sie im Textfeld für Ablagespeicherort den UNC-Speicherort (\\Server\Freigabe) ein. Am Ablagespeicherort befinden sich nach Abschluss des Builds die erstellten Binär- und Protokolldateien.
Warnung
Das Ablageverzeichnis wird standardmäßig nicht als Freigabe erstellt. Daher kann für das Veröffentlichen von Builds und Testergebnissen nicht darauf zugegriffen werden. Sie müssen manuell eine Freigabe einrichten und Schreibberechtigungen für das Windows-Verzeichnis hinzufügen. Zum Ablegen von Builds müssen Sie außerdem Freigabeberechtigungen für das Konto hinzufügen, mit dem der Team Foundation Build-Dienst ausgeführt wird. Zum Veröffentlichen von Testergebnissen müssen Sie Freigabeberechtigungen für das Konto des Testers hinzufügen.
Hinweis
Jeder generierte Build wird in einem separaten Verzeichnis abgelegt. Sie müssen sicherstellen, dass das Konto, mit dem der Buildcomputer konfiguriert wird, über Schreibzugriff auf diesen UNC-Speicherort verfügt.
Wenn Sie die Einstellungen für den Buildspeicherort festgelegt haben, klicken Sie auf Weiter. Der Schritt Buildoptionen auswählen wird angezeigt.
Geben Sie die Buildoptionen an, die Sie aktivieren möchten, indem Sie ggf. die Kontrollkästchen Test ausführen (z.B. BVTs usw. ausführen) oder Codeanalyse durchführen aktivieren. Wenn Sie das Kontrollkästchen Test ausführen (z.B. BVTs usw. ausführen) aktivieren, geben Sie mit den Dropdownoptionen ggf. Testmetadatendatei oder Auszuführende Testliste an. Weitere Informationen finden Sie unter Verwenden von Testlisten und Verfassen von qualitativ hochwertigem Quellcode.
Wenn Sie die Buildschritte ausgeführt haben, klicken Sie auf Weiter. Der Schritt Buildtypauswahlen überprüfen wird angezeigt.
Wenn Sie mit dem Buildtyp einverstanden sind, klicken Sie auf Fertig stellen. Der neue Buildtyp erstellt dann die zugrunde liegenden Dateien. Folgende Dateien werden erstellt:
TfsBuild.proj
WorkspaceMapping.xml
Diese Dateien werden in der Quellcodeverwaltung in Team Foundation unter dem Ordner mit demselben Namen wie "Buildtyp" eingecheckt. Wenn Sie beispielsweise einen Buildtyp namens "meinBuildTyp" in der Quellcodeverwaltung in Team Foundation erstellen, werden die Dateien unter $/[Teamprojektname]/TeamBuildType/meinBuildTyp gespeichert.
Hinweis
Wenn Sie den Buildtyp weiter bearbeiten möchten, müssen Sie die Datei teambuild.proj bearbeiten.
Nachdem Sie die Schritte des Assistenten zum Erstellen neuer Teambuildtypen ausgeführt haben, müssen Sie sicherstellen, dass der Team Foundation Build-Dienst auf dem ausgewählten Buildcomputer über die erforderlichen Berechtigungen zum Erstellen des Teamprojekts verfügt. Außerdem müssen Sie den Benutzern, die den Buildtyp ausführen, entsprechende Berechtigungen erteilen. Das Einrichten dieser Berechtigungen wird im folgenden Verfahren erläutert.
So richten Sie Buildberechtigungen ein
Wenden Sie sich an den Systemadministrator für den zuvor ausgewählten Buildcomputer, um den Namen des Kontos zu ermitteln, unter dem der Team Foundation Build-Dienst ausgeführt wird.
Wählen Sie im Menü Team die Option Teamprojekteinstellungen und dann Gruppenmitgliedschaften aus. Das Dialogfeld Projektgruppen wird angezeigt.
Suchen Sie in Projektgruppen unter der Auflistung Benutzer und Gruppen die Gruppe namens Builddienste, und klicken Sie auf Eigenschaften. Das Dialogfeld Team Foundation Server - Gruppeneigenschaften wird angezeigt.
Wählen Sie die Registerkarte Mitglieder aus. Wenn das im vorangegangenen Schritt ermittelte Konto in der Mitgliederliste vorhanden ist, kann der ausgewählte Buildcomputer den Buildtyp erstellen. Führen Sie andernfalls die folgenden Schritte aus:
Wählen Sie im Abschnitt Mitglied hinzufügen die Option Windows-Benutzer oder -Gruppe aus, und klicken Sie auf Hinzufügen. Das Dialogfeld Benutzer oder Gruppen auswählen wird angezeigt.
Geben Sie im Dialogfeld Benutzer oder Gruppen auswählen das Konto ein, das dem Team Build-Dienst auf dem Buildcomputer zugeordnet ist, der für diesen Buildtyp verwendet wird.
Hinweis
Wenn dieser Buildtyp auf mehreren Buildcomputern erstellt wird, müssen alle Konten des Team Build-Diensts als Mitglieder der Gruppe 'Builddienste' dieses Projekts hinzugefügt werden.
Konfigurieren Sie die Benutzer, die die Buildtypen ausführen sollen, indem Sie diesen die Berechtigung zum Starten/Fortsetzen eines Builds gewähren. Weitere Informationen finden Sie unter Überwachung und Benutzerberechtigungen und Sicherheitsrechte und Berechtigungen für Team Foundation Build.
Sicherheit
Um diese exemplarische Vorgehensweise durchzuführen, benötigen Sie die Team Foundation Server-Berechtigung Build verwalten sowie die Team Foundation Server-Berechtigung Build starten/fortsetzen. Weitere Informationen finden Sie unter Sicherheitsrechte und Berechtigungen für Team Foundation Build.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Ausführen eines Buildtyps im Team Foundation-Build
Gewusst wie: Einrichten eines Buildcomputers
Gewusst wie: Erstellen eines neuen Buildtyps
Gewusst wie: Einrichten von Berechtigungen für Team Foundation-Buildcomputer