So verwenden Sie Artefaktregeln

In diesem Tutorial geht es um Artefaktregeln in TeamCity. Artefaktregeln sind einfach, aber Sie müssen dabei einige Details beachten.

Wenn wir in diesem Build den Mauszeiger auf das Artefaktsymbol bewegen, sehen wir, dass es zwei Artefakte ohne Ordnerstruktur gibt: das Anwendungsprotokoll und eine Selenium-Aufzeichnung im mp4-Format.

Unter Build Configuration settings | Artifact paths können wir sehen, dass beide Artefakte sich in einem Verzeichnis befinden: calculator-service/artifacts/*.

Zum Angeben von Artefaktpfaden stehen Ihnen unterschiedliche Optionen zur Verfügung. Zum Beispiel:

+:**/* => target_directory

-:directory1 => target_directory

weist TeamCity an, alle Dateien mit Ausnahme von directory1 im Verzeichnis target_directory zu veröffentlichen.

In unserem Beispiel weisen wir TeamCity an, alle Inhalte im Calculator-Verzeichnis in den Artefakt-Ordner des jeweiligen Builds zu legen. Dieser Ordner könnte auf Amazon S3 oder bei einem beliebigen anderen Speicheranbieter gespeichert sein.

Diese beiden Zeilen sind gleichwertig:

Geben wir nun einen anderen Artefaktpfad an. Anstatt alles in den Unterordner artifacts zu packen, weisen wir TeamCity an, die Dateien in das Verzeichnis another_directory zu verschieben. Außerdem schließen wir alle .log-Dateien vom Kopiervorgang aus.

Da diese Regeln additiv sind, weisen wir TeamCity an, alle Dateien einzuschließen und sie in ein anderes Verzeichnis zu verschieben. Darüber hinaus weisen wir TeamCity an, .log-Dateien auszuschließen.

Fügen wir zum Schluss noch eine weitere Regel hinzu:

+:calculator-service/**/application.log => hello_world/whatever.log

Mit dieser Regel weisen wir TeamCity an, das Anwendungsprotokoll application.log aus allen Unterverzeichnissen (**) des Verzeichnisses calculator-service in den Ordner hello_world zu legen. Außerdem soll die Datei application.log in whatever.log umbenannt werden.

Wenn wir die Änderungen speichern und den Build ausführen, sehen wir, dass sich die Speicherpfade unserer Artefakte tatsächlich geändert haben. Unsere Artefakte werden jetzt in unterschiedlichen Ordnern und Unterverzeichnissen gespeichert:

Sehen Sie sich auch unsere anderen Tutorials zur Erstellung Ihrer ersten Build-Pipeline und zur Übermittlung von Build-Informationen an externe Plattformen wie Jira an.

Viel Spaß beim Builden!

Weitere Informationen finden Sie in unserer Dokumentation der Artefaktabhängigkeiten in TeamCity.

Erfahren Sie im CI/CD-Leitfaden für TeamCity, was ein Artefakt-Repository ist.