Gewusst wie: Erstellen einer Builddefinition
Aktualisiert: November 2007
In Team Foundation Build werden Builddefinitionen zum Konfigurieren der Bedingungen verwendet, unter denen eine einzelne Projektmappe oder eine Reihe von Projektmappen in einem Teamprojekt erstellt werden. Um einen Buildvorgang auszuführen, müssen Sie entweder eine neue Builddefinition erstellen oder eine bereits vorhandene Builddefinition verwenden.
Wenn Sie Builddefinitionen erstellen, indem Sie das Dialogfeld Builddefinition verwenden, können Sie mehrere Optionen festlegen. Zu diesen Optionen gehören der Buildname, der Arbeitsbereich für die Quellcodeverwaltung der zu erstellenden Dateien, der Speicherort der Projektdatei TFSBuild.proj, der Build-Agent, die Beibehaltungsrichtlinie für den Build und der Buildtrigger. Wenn Sie nicht über eine vorhandene MSBuild-Projektdatei verfügen, können Sie über das Dialogfeld Builddefinition den MSBuild-Projektdateierstellungs-Assistenten aufrufen, um eine neue TFSBuild.proj-Datei für Ihre Builddefinition zu erstellen. Sie können auch das Dialogfeld Eigenschaften von Build-Agent starten, um einen neuen Build-Agent zu erstellen.
Nachdem Sie eine neue Builddefinition erstellt haben, können Sie diese Optionen ändern. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten einer Builddefinition.
Sie können Ihre Builddefinitionen noch weiter anpassen. Bearbeiten Sie dazu die Datei TFSBuild.proj, die im MSBuild-Format geschrieben ist. Weitere Informationen finden Sie unter Anpassen von Team Foundation Build.
Builddefinitionen werden entfernt, indem zuerst die Builds gelöscht werden, die der Builddefinition zugeordnet sind. Dann kann die Builddefinition selbst gelöscht werden. Weitere Informationen finden Sie unter Gewusst wie: Löschen eines abgeschlossenen Builds.
Erforderliche Berechtigungen
Zum Ausführen dieser Schritte muss die Build verwalten-Berechtigung auf Zulassen festgelegt sein. Zusätzlich werden für das Dienstkonto auf Anwendungsebene und das Team Foundation Build-Dienstkonto Lese-/Schreibberechtigungen für den Ablagespeicherort des Builds benötigt. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
So erstellen Sie eine neue Builddefinition
Wählen Sie in Team Explorer das Projekt aus, für das Sie eine neue Builddefinition erstellen möchten.
Klicken Sie im Menü Erstellen auf Neue Builddefinition.
Das Dialogfeld Builddefinition wird mit der ausgewählten Registerkarte Allgemein angezeigt.
.gif "Tipp")
Tipp:Auf den Registerkarten, neben deren Namen ein Warnsymbol angezeigt wird, müssen Daten eingegeben werden.
Geben Sie im Textfeld Builddefinitionsname den Namen an, der der Builddefinition zugeordnet werden soll.
Der Name, den Sie eingeben, muss ein eindeutiger und gültiger Windows-Dateiname sein.
Fügen Sie im Textfeld Beschreibung eine entsprechende Beschreibung hinzu.
Diese Beschreibung wird im Dialogfeld Build <Teamprojektname> zu Warteschlange hinzufügen angezeigt. Weitere Informationen finden Sie unter Gewusst wie: Starten oder Hinzufügen einer Builddefinition zur Warteschlange.
Klicken Sie auf die Registerkarte Arbeitsbereich.
Die Tabelle Arbeitsordner enthält standardmäßig den Quellcodeverwaltungsordner für das Teamprojekt, für das Sie die neuen Builddefinitionen erstellen, und einen lokalen Ordner im Build-Agent. Der lokale Ordner im Build-Agent wird in der Spalte Lokaler Ordner aufgelistet. Alle Arbeitsbereichspfade im Build-Agent werden relativ zum angezeigten Standardstammverzeichnis zugeordnet.
Um einen vorhandenen Arbeitsbereich in die Liste der Arbeitsordner zu kopieren, klicken Sie auf die Schaltfläche Vorhandenen Arbeitsbereich kopieren, um das Dialogfeld Arbeitsbereich für das Kopieren auswählen zu öffnen.
Der Arbeitsbereich, den Sie auswählen, wird ein untergeordnetes Element des allgemeinen Stammverzeichnisses auf dem Build-Agent.
Sie können auch in Quellcodeverwaltungsordner in eine leere Tabellenzelle und dann auf die Schaltfläche mit den Auslassungspunkten (…) klicken, um zu einem Quellcodeverwaltungsordner zu wechseln, der als Arbeitsordner hinzugefügt werden soll. Der von Ihnen ausgewählte Quellverwaltungsordner wird ebenfalls auf das allgemeine Stammverzeichnis auf dem Build-Agent normalisiert.
Klicken Sie auf die Registerkarte Projektdatei. Im Bereich Projektdatei können Sie entweder zu einer vorhandenen TFSBuild.proj-Projektdatei wechseln, oder den MSBuild-Projektdateierstellungs-Assistenten aufrufen, um eine neue TFSBuild.proj-Datei zu erstellen.
Um zu einer vorhandenen TFSBuild.proj-Datei zu wechseln, klicken Sie auf Durchsuchen. Wählen Sie im Dialogfeld Ordner suchen aus dem Ordner TeamBuildTypes eine vorhandene Builddefinition aus, und klicken Sie dann auf OK.
Die Datei TFSBuild.proj wird jetzt von der vorhandenen und der neuen Builddefinition gemeinsam verwendet.
Wenn eine TFSBuild.proj-Datei gefunden wurde, wird im Bereich Projektdatei der Text MSBuild-Projektdatei gefunden: TFSBuild.proj angezeigt. Wenn keine Projektdatei gefunden wurde, werden im Bereich Projektdatei ein Warntext und der Hinweis angezeigt, eine neue MSBuild-Projektdatei zu erstellen.
.gif "Wichtiger Hinweis")
Wichtiger Hinweis:Mit allen Änderungen, die Sie an einer gemeinsam genutzten TFSBuild.proj-Datei vornehmen, passen Sie alle Builddefinitionen an, denen die Datei zugeordnet ist. Weitere Informationen finden Sie unter Anpassen von Team Foundation Build.
Um eine neue Projektdatei für die Builddefinition zu erstellen, klicken Sie auf Erstellen. Der MSBuild-Projektdateierstellungs-Assistent wird angezeigt.
Wählen Sie auf der Seite Zu erstellende Projektmappen auswählen und sortieren die zu erstellenden Projektmappen aus. Um die Projektmappen zu sortieren, wählen Sie eine einzelne Projektmappe aus, und verwenden Sie die Pfeiltasten rechts neben der Liste, um ihre Anordnung in der Buildreihenfolge zu ändern.
Vorsicht:Beachten Sie die Abhängigkeiten zwischen den Projektmappen, wenn Sie die Reihenfolge bestimmen, in der sie erstellt werden. Falls Projektmappe2 z. B. von Projektmappe1 abhängig ist, legen Sie fest, dass Projektmappe1 vor Projektmappe2 erstellt wird.
Klicken Sie auf Next.
Die Seite 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 die Builddefinitionen aufgenommen werden sollen. Die Buildkonfiguration gibt die Konfiguration und die Plattform an (z. B. Release und AnyCPU).
Hinweis:Wenn Sie eine Builddefinition für Webprojekte erstellen, wählen Sie Gemischte Plattformen im Dropdownmenü Plattform aus.
Klicken Sie auf Next.
Die Seite Buildoptionen auswählen wird angezeigt.
Geben Sie die gewünschten Buildoptionen an, indem Sie die Kontrollkästchen Test ausführen(z.B. BVTs usw. ausführen) und Codeanalyse ausführen aktivieren. Wenn das Kontrollkästchen Test ausführen (z.B. BVTs usw. ausführen) aktiviert ist, können Sie mithilfe der Dropdownoptionen die entsprechende Testmetadatendatei und die Auszuführende Testliste angeben.
Weitere Informationen finden Sie unter Verwenden von Testlisten und Verfassen von qualitativ hochwertigem Quellcode.
Wichtiger Hinweis:Um Tests auszuführen, muss Team Edition for Testers auf dem Build-Agent installiert sein. Um die Codeanalyse auszuführen, muss Team Edition for Developers auf dem Build-Agent installiert sein.
Klicken Sie auf Fertig stellen.
Der Bereich Projektdatei des Dialogfelds Builddefinition wird angezeigt. Die Datei TFSBuild.proj, die Sie erstellt haben, wird unter $<Team Project>\TeamBuild Types\<Build Definition Name>\TFSBuild.proj in der Quellcodeverwaltung gespeichert.
Klicken Sie auf die Registerkarte Beibehaltungsrichtlinie. In der Liste Geben Sie an, wie Builds beibehalten werden sollen können Sie die Beibehaltungsrichtlinie für fehlgeschlagene, angehaltene, teilweise erfolgreiche oder komplett erfolgreiche Builds auswählen. Wählen Sie in der Dropdownliste eine Beibehaltungsrichtlinie aus. Wenn Sie <Geben Sie die beizubehaltende Anzahl an> auswählen, wird das Dialogfeld Buildanzahl angezeigt. Geben Sie im Textfeld Anzahl beizubehaltender Builds an, wie viele Builds Sie für die angegebene Buildausgabe beibehalten möchten.
Klicken Sie auf die Registerkarte Build-Standardwerte. Im Bereich Build-Standardwerte können Sie einen vorhandenen Build-Agent aus der Dropdownliste Build-Agent auswählen. Wenn kein Build-Agent vorhanden ist oder Sie einen neuen erstellen möchten, klicken Sie auf Neu. Das Dialogfeld Eigenschaften von Build-Agent wird angezeigt. Geben Sie in den Textfeldern Anzeigename, Beschreibung und Computername Daten ein, und klicken Sie auf OK. Weitere Informationen finden Sie unter Gewusst wie: Erstellen und Verwalten von Build-Agents.
Geben Sie im Textfeld Builds werden auf der folgenden Freigabe bereitgestellt (z. B. \\Server\Freigabe) den UNC-Speicherort (\\Server\Freigabe) ein. Nach Abschluss des Builds befinden sich die erstellten Binärdateien und Protokolldateien in diesem Ordner.
Hinweis:Bevor Sie diesen Schritt abschließen, müssen Sie einen öffentlichen Ordner auf dem Build-Agent-Computer erstellt haben, auf dem das TFSService-Konto umfassende Rechte besitzt. Weitere Informationen über Team Foundation-Dienstkonten finden Sie unter Gewusst wie: Anzeigen von Team Foundation Server-Diensten.
Klicken Sie auf die Registerkarte Trigger.
Wählen Sie im Bereich Trigger die Option Eincheckvorgänge führen nicht zu einem neuen Build aus, um nur bei Bedarf Builds zu erstellen.
Wählen Sie Build für jeden Eincheckvorgang (mehr Builds) aus, um fortlaufend immer dann Builds zu erstellen, wenn Änderungen in die Dateien eingecheckt werden, die durch Ihre Builddefinition erstellt werden.
Wählen Sie Eincheckvorgänge sammeln, bis der vorherige Build abgeschlossen ist (weniger Builds) aus, um rollende Builds zu erstellen. Wenn das Kontrollkästchen Eincheckvorgänge sammeln, bis der vorherige Build abgeschlossen ist (weniger Builds) aktiviert ist, können Sie angeben, wie oft Builds stattfinden. Aktivieren Sie dazu das Kontrollkästchen Nicht häufiger erstellen als alle, und geben Sie im Textfeld Minuten eine Zahl ein.
Der gültige Bereich für das Textfeld Minuten ist 0 bis 2147483647 (Int32 MaxValue).
Hinweis:Wenn Sie Visual Studio Team System 2008 Team Foundation Server mit Service Pack 1 verwenden, können Sie das Intervall für fortlaufende Builds zwischen 120 und 240 Minuten festlegen. Wenn Sie Visual Studio Team System 2008 Team Foundation Server ohne Service Pack 1 verwenden, ignoriert Team Foundation Build jeden Wert in diesem Bereich.
Wählen Sie Build jede Woche an folgenden Tagen aus, um geplante Builds zu erstellen. Wählen Sie mit den Kontrollkästchen für die einzelnen Wochentage die Tage aus, an denen Sie Builds erstellen möchten. Geben Sie im Textfeld Build zu Warteschlange des Standard-Build-Agents hinzufügen um die Buildzeit ein.
Hinweis:Geplante Builds finden nicht statt, wenn seit dem vorherigen Build keine Änderungen eingecheckt wurden.
Klicken Sie auf OK, um die Builddefinition zu erstellen, sobald Sie alle erforderlichen Informationen eingegeben haben.
Die erstellte Builddefinition wird im Ordner Builds in Team Explorer angezeigt. Um die Informationen zu prüfen, die auf dem Server für Ihre Builddefinition gespeichert sind, klicken Sie in Team Explorer mit der rechten Maustaste darauf, und klicken Sie auf Builddefinition bearbeiten. Das Dialogfeld Builddefinition wird mit den von Ihnen eingegebenen Informationen angezeigt. Sie haben auch die Möglichkeit, die eingegebenen Informationen zu ändern. Weitere Informationen finden Sie unter Gewusst wie: Bearbeiten einer Builddefinition.
Wichtiger Hinweis:Wenn Ihre Builddefinition und ein anderer Build gemeinsam eine TFSBuild.proj-Datei nutzen, werden Ihre Builddefinition und die zugehörigen Dateien nicht im Quellcodeverwaltungs-Explorer im Ordner TeamBuildTypes angezeigt. Nur die ursprüngliche Builddefinition wird aufgelistet.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Erstellen einer Builddefinition in Team Foundation Build
Gewusst wie: Einrichten von Berechtigungen für Team Foundation Build-Agents
Gewusst wie: Einrichten und Installieren von Team Foundation Build
Konzepte
Übersicht über Team Foundation Build