Arbeiten mit Buildarbeitsbereichen

Wie Sie benötigen Sie Arbeitsbereich auf dem Entwickler-Computer, um die Anwendung zu entwickeln, müssen Sie den Arbeitsbereich angeben, dem der Build-Agent verwendet, um die Anwendung zu erstellen und zu testen.

Was möchten Sie tun?

• Geben Sie einen Arbeitsbereich für die Builddefinition an

• Unter finden Sie ein Beispiel einer Buildarbeitsbereichsdefinition

• Kopieren Sie Daten zwischen Arbeitsbereichen

• Erfahren Sie, wie ein Buildarbeitsbereich funktioniert

Geben Sie einen Arbeitsbereich für die Builddefinition an

Wenn Sie Definieren Sie den Buildprozess, Sie einige bewährten Methoden befolgen sollten, wenn Sie den Arbeitsbereich angeben.

Schließen Sie alle erforderlichen Ordner ein.

Stellen Sie sicher, dass Sie alle Ordner einschließen, die für den Buildprozess erforderliche Dateien enthalten.Wenn Sie eine andere Projektmappe dem Feld Zu erstellende Dokumente auf der Registerkarte Prozess hinzufügen, müssen Sie möglicherweise eine andere Zuordnung dem Arbeitsbereich hinzufügen.

Schließen Sie nur erforderliche Ordner ein.

Zuordnung mit einem Status-Wert von Aktiv nur die Ordner, die für den Buildprozess erfordert.Wenn ein Unterordner eines zugeordneten Ordners Dateien enthält, die der Buildprozess nicht erforderlich, ordnen Sie diesen einem Status-Wert von Verdeckt zu.Beim Erstellen einer Builddefinition wird häufig der Stammordner des Teamprojekts im Arbeitsbereich zugeordnet.Diese Konfiguration führt dazu, dass der Build-Agent alle Dateien in den Versionskontrollordner des Teamprojekts herunterlädt.Wenn dieser Ordner große Datenmengen enthält, kann der Build möglicherweise Systemressourcen verschwendet und der Buildprozess verlangsamen, da umfangreiche Datenmengen heruntergeladen werden, die er nicht erforderlich.

Wenn Sie auf der Registerkarte Prozess Elemente aus dem Feld Zu erstellende Dokumente entfernen, suchen Sie auch nach Zuordnungen, die Sie aus dem Arbeitsbereich entfernen können.

Tipp
Weitere Informationen zum Optimieren eines Arbeitsbereichs, finden Sie unter Optimieren der Arbeitsbereiche.

Verwenden Sie das Token $(SourceDir), um einen Serverordner einem lokalen Unterverzeichnis .. \Sources zuzuordnen.

In den meisten Fällen bildet den optimalen Speicherort für die Quelldateien auf dem Build-Agent das Unterverzeichnis ..\Sources im Arbeitsverzeichnis.Diesen Speicherort können Sie angeben, indem Sie das $(SourceDir)-Token im Feld Ordner für Build-Agent verwenden.

Achten Sie darauf, wie sich der Arbeitsbereich auf eine Builddefinition auswirkt, die durch Eincheckvorgänge ausgelöst wird.

Wenn Sie den Trigger der Builddefinition auf Fortlaufende Integration, Parallele Builds oder Abgegrenzter Eincheckvorgang festgelegt haben, werden die zugeordneten Serverordner an den Buildprozess gebunden.Im Folgenden ein Beispiel.Ein Entwickler überprüft in Änderungen in einen Ordner.Der Ordner wird im Arbeitsbereich einer Builddefinition zugeordnet und diese Builddefinition verfügt über einen Abgegrenzter Eincheckvorgang Trigger.Die Änderungen werden blockiert, bis der Buildprozess abgeschlossen ist.

Builddefinitionsarbeitsbereichsbeispiel

Herr Tamburello, der Build-Manager, hat die Builddefinition Storefront Nightly erstellt.

Mit dieser Builddefinition werden zwei Projektmappen erstellt: $/Core/Controllers/Controllers.sln und $/Core/Viewers/Viewers.sln.Daher müssen die beiden Ordner mit diesen Projektmappen, die darin enthaltenen Projekte sowie alle anderen erforderlichen Dateien zugeordnet werden.

Um die Effizienz des Buildprozesses zu verbessern, schließt Herr Tamburello einen Ordner mit Dokumentationsdateien aus, die für den Buildvorgang nicht erforderlich sind: $/Core/Viewers/Docs.

Die Projektmappen sind von einigen Binärdateien in einer Komponentenbibliothek eines anderen Unternehmens abhängig.Diese Binärdateien sind durch einen proprietären Mechanismus geschützt, aufgrund dessen sich diese in einem bestimmten physischen Ordner befinden müssen: c:\adatum\widgets.

Kopieren Sie Daten zwischen Arbeitsbereichen

Sie können Zeit sparen, indem Sie Zuordnungen aus einem Arbeitsbereich in einen anderen kopieren.

So kopieren Sie Zuordnungen aus einem der Arbeitsbereiche

1. Wählen Sie die Option Vorhandenen Arbeitsbereich kopieren aus.

2. Kopieren Sie im Dialogfeld Zu kopierenden Arbeitsbereich auswählen die Zuordnungen aus dem Arbeitsbereich.

So kopieren Sie Zuordnungen aus einem anderen Builddefinitions-Arbeitsbereich oder dem Arbeitsbereich eines anderen Teammitglieds

1. Führen Sie einen der folgenden Schritte aus:

   • Zum Kopieren von Zuordnungen aus einem anderen Builddefinitions-Arbeitsbereich öffnen Sie die Builddefinition, und klicken Sie dann auf die Registerkarte Arbeitsbereich.

   • Um Zuordnungen aus dem Arbeitsbereich eines anderen Teammitglieds zu kopieren, bitten Sie das Teammitglied, in der Menüleiste die Option Datei und dann Quellcodeverwaltung und Arbeitsbereiche auszuwählen.Wählen Sie den Arbeitsbereich aus, und klicken Sie auf die Option Bearbeiten.

2. Öffnen Sie das Kontextmenü für eine Zeile in der Tabelle Arbeitsordner, und wählen Sie dann Alle auswählen aus.

3. Öffnen Sie das Kontextmenü für eine Zeile in der Tabelle Arbeitsordner, und wählen Sie dann Kopieren aus.

4. Erstellen Sie eine Textdatei, fügen Sie den Inhalt der Zwischenablage in die Textdatei ein, und speichern Sie sie dann.

5. Erstellen Sie eine Builddefinition, oder ändern Sie eine vorhandene Builddefinition, die das Ziel der kopierten Zuordnungen bildet.

   Weitere Informationen finden Sie unter Erstellen einer Builddefinition oder Bearbeiten einer Builddefinition.

6. Öffnen Sie auf der Registerkarte Arbeitsbereich in der Tabelle Arbeitsordner das Kontextmenü für eine Zeile, und wählen Sie dann Einfügen aus.

7. Passen Sie ggf. die Zuordnungen für den Build-Agent an.Achten Sie insbesondere darauf, dass im Feld Ordner für Build-Agent der richtige Wert angegeben ist und dieser das ordnungsgemäße $(SourceDir)-Token enthält.

Erfahren Sie, wie ein Buildarbeitsbereich funktioniert

Während des Buildvorgangs kompiliert der Build-Agent die Quelldateien und führt weitere Aufgaben mit diesen aus.Der Build-Agent kann diese Aufgaben erst ausführen, nachdem er die Dateien aus Ordnern auf dem Versionskontrollserver in ein lokales Arbeitsverzeichnis heruntergeladen hat.Um diese Dateien herunterladen zu können, erstellt der Build-Agent einen Versionskontroll-Arbeitsbereich, in dem die Ordner auf dem Server den lokalen Ordnern im Arbeitsverzeichnis für die Build-Agents zugeordnet sind.

Vor Beginn des Buildprozesses

Sie legen das Arbeitsverzeichnis für die einzelnen Build-Agents im Buildsystem fest.Weitere Informationen finden Sie unter Bereitstellen und Konfigurieren eines Build-Agents.

Wenn Sie eine Builddefinition erstellen, geben Sie auf der Registerkarte Arbeitsbereich die Ordner mit den herunterzuladenden Dateien sowie deren Art der Zuordnung zu den lokalen Ordnern im Build-Agent an.

Während des Buildprozesses

Der Buildprozess übergibt die Arbeitsbereichsspezifikationen an die CreateWorkspace-Aktivität-Workflowaktivität, um einen Arbeitsbereich im Arbeitsverzeichnis zu erstellen.

Der Buildprozess verwendet die DownloadFiles-Aktivität-Aktivität, um die Dateien in den Arbeitsbereich herunterzuladen.Nach diesem Schritt kann der Build-Agent mit den Aufgaben für diese Dateien beginnen (z. B. der Kompilierung).