So arbeiten Sie mit Artefakten in TeamCity

Jede Datei, die beim Buildvorgang erzeugt wird, ist ein potenzielles Artefakt – zum Beispiel eine Anwendung, die in einer .jar- oder .zip-Datei verpackt ist. Nachdem der Buildvorgang auf dem Build-Agent abgeschlossen wurde, lädt TeamCity diese Dateien auf den TeamCity-Server hoch, wo Sie über die TeamCity-Oberfläche auf sie zugreifen können.

Weitere Informationen zu Build-Artefakten finden Sie in unserer Dokumentation.

Um die von Ihrem Build erzeugten Daten zu erhalten, gehen Sie zu Edit Configuration.

Auf dem Tab General Settings finden Sie das Eingabefeld Artifact Paths.

Was ist ein Artefaktpfad?

In TeamCity bezeichnet ein Artefaktpfad den Ort, an dem Build-Artefakte nach einem erfolgreichen Buildprozess abgelegt werden. Artefakte sind Ausgabedateien, Binärdateien oder andere wichtige Erzeugnisse, die während des Buildvorgangs generiert werden. Ein Artefaktpfad gibt die Verzeichnis- bzw. Ordnerstruktur innerhalb des TeamCity-Servers an, in der diese Artefakte veröffentlicht werden und zugänglich sind.

Wir wissen, dass beim Buildvorgang in unserem Beispiel ein Unterverzeichnis für Artefakte erstellt wird, und wir möchten alle Dateien aus diesem Unterverzeichnis verfügbar machen. Geben Sie den Artefaktpfad in das Feld ein und klicken Sie dann auf Save.

Wo werden Artefakte gespeichert?

TeamCity hat einen integrierten Artefaktspeicher. Sie können TeamCity aber auch mit einem externen Artefaktspeicher verwenden. Derzeit unterstützt TeamCity Amazon S3, Azure Artifact Storage und Google Cloud Artifact Storage.

Wenn wir nun den Buildvorgang ausführen, können wir einige Änderungen sehen. Zuvor war das Artefaktsymbol ausgegraut. Dies bedeutete, dass keine benutzerseitig identifizierten Artefakte in diesem Build enthalten waren.

Das hellblaue Symbol zeigt an, dass TeamCity Artefakte für diesen Build gefunden und gespeichert hat. Wenn wir auf das blaue Symbol klicken, können wir sehen, dass zwei Dateien als Artefakte gespeichert sind – ein Anwendungsprotokoll und eine Selenium-Aufzeichnung.

Sie können jede Datei einzeln anklicken, um sie zu untersuchen.

Die Daten auf den Build-Agents werden auf den TeamCity-Server – oder genauer gesagt an einen bestimmten Speicherort – übertragen. Dieser Speicherort kann sich in der Cloud, lokal oder an einem beliebigen anderen von Ihnen angegebenen Ort befinden.

Diese Daten stehen nicht nur auf dem TeamCity-Server zur Verfügung, sondern können auch in einer Build-Chain oder in verschiedenen Build-Konfigurationen verwendet werden. Wenn zum Beispiel ein Deployment-Job eine .jar-Datei aus einem vorangegangenen Build-Job benötigt, kann diese Datei als Artefakt übergeben werden.

Wie kann ich Artefakte kopieren?

In TeamCity können Sie Artefakte mit der Funktion „Artifact Dependency“ von einem Build zu einem anderen kopieren. Dazu müssen Sie die Artefaktpfade im Quell-Build und die Artefaktabhängigkeit im Ziel-Build konfigurieren, die Builds ausführen und im Anschluss das Kopieren der Artefakte überprüfen. Durch das Einrichten von Artefaktabhängigkeiten schaffen Sie in TeamCity eine Verbindung zwischen verschiedenen Builds und ermöglichen so den mühelosen Transfer von Artefakten von einem Build zum anderen.

Sind Sie bereit, Ihre Artefakte zu konfigurieren? Lesen Sie unsere Dokumentation und melden Sie sich bei uns, wenn Sie Fragen haben.