JenkinsFile Archiveartifacts

Jenkins Build Artefacts beziehen.

Einige Beispiele für Build -Artefakte sind kompilierte ausführbare Säle, Bibliotheken und Paketdateien sowie Dokumentation, Testergebnisse und andere Dateien, die im Rahmen des Erstellungsprozesses erstellt wurden. Build -Artefakte werden hauptsächlich in einem Repository- oder Artefaktmanager wie Nexus oder Artefactory gespeichert, wo sie von anderen Build- und Bereitstellungsverfahren zugegriffen und verwendet werden können.

Artenfaktarchivierung in Jenkins kann als Archiving -Build -Artefakte in einem Repository- oder Artefaktmanager definiert werden, der den Zugriff und die Verwendung durch andere Build- und Bereitstellungsprozesse erleichtert.

Sie können die Artefaktdateien angeben, die Sie während des Auftragskonfigurationsprozesses archivieren möchten. Sie definieren auch, wo Sie die archivierten Artefakte aufbewahren möchten.

Sobald der Jenkins -Job abgeschlossen ist, speichert der Server die gespeicherten Artefakte an dem angegebenen Ort, an dem er nach Bedarf zugegriffen und verwendet werden kann.

Die Archivierung von Artefakten in Jenkins hat mehrere Vorteile. Durch die Speicherung von Build -Artefakten in einem zentralen Repository können Sie beispielsweise sicherstellen, dass sie allen Teammitgliedern zur Verfügung stehen, die sie benötigen, und die Geschichte der Artefakte im Laufe der Zeit verfolgen.

Darüber hinaus kann Artefaktarchiving dazu beitragen, Artefakte für Test- und Produktionsumgebungen zu verwalten und bereitzustellen, da Sie das Repository verwenden können, um verschiedene Versionen von Artefakten zu speichern und eine bestimmte Version schnell abzurufen.

Dieses Tutorial behandelt, wie wir arbeiten und den Archiveartifacts -Block im Jenkins -Job verwenden können.

Jenkins Archiveartifacts

Das Folgende zeigt die Syntax des Jenkins Archiveartifacts -Blocks:

Schritte
Archiveartifakte Artefakte: Optionen

Der Block akzeptiert verschiedene Optionen wie gezeigt:

1. Artefakte - Auf diese Weise können Sie die Artefakte angeben, die Sie archivieren möchten. Dies ist ein String -Typ; Sie definieren es als buchstäbliche oder Wildcard. Denken Sie daran, dass dies dem Ant Fileset Wildcard -Format folgt. Daher Sonderzeichen wie Kommas, die als Trennzeichen behandelt werden. Sie können die Dokumentation überprüfen, um mehr zu erfahren.
2. erlaubigyarchive - Diese Boolesche Option bestimmt, ob Jenkins das Archiv erstellen wird, auch wenn keine Artefakte verfügbar sind. Standardmäßig ist dieser Wert auf False festgelegt, was bedeutet, dass der Build fehlschlägt, wenn keine Artefakte verfügbar sind.
3. Fallsensitiv - Eine boolesche Option gibt an, ob der Artefaktarchiver fälschlicherweise sensitiv ist. Standardmäßig wird dieser Wert auf true gesetzt. Daher die Dateidatei.Teer und Datei.Te TAR sind unterschiedliche Dateinamen.
4. DefaultExcludes - Dies ist ein weiterer boolescher Parameter, mit dem Sie Standardartefakte ausschließen können.
5. Ausgeschlossen - Dieser Parameter ist ein String -Typ, mit dem Sie die Dateien definieren können, die Sie aus dem Archiv ausschließen möchten. Sie können auch Wildcard -Zeichen verwenden, wie vom ANT -Dateisatz angegeben.
6. Fingerabdruck - Wenn Jenkins auf True gesetzt wird, erstellt er für jedes Artefakt einen Fingerabdruck, mit dem die Artefakte im Laufe der Zeit unterschieden werden können.
7. folgt - Dadurch kann der Archiver symbolische Links folgen, falls verfügbar.
8. Nur Ifsuccessful - Auf diese Weise können Sie angeben, dass Artefakte nur archiviert werden sollten, wenn der Build erfolgreich ist.

Nachdem wir die Optionen des Archiveartifacts -Blocks in Jenkins aufgebaut haben, lassen Sie uns untersuchen, wie wir sie verwenden können.

Beispiel Verwendung

Das folgende Beispiel zeigt, wie Sie den Archiveartifacts -Block verwenden, um ein Archiv mit ausführbaren Dateien aus einem Rust -Projektbau zu erstellen.

Pipeline
Agent jeder
Stufen
Stage ('Build')
Schritte
sh 'curl --proto "= https" - -tlsv1.2 -SSF https: // sh.Rostup.rs | Sh -S --y '
sh 'echo "Exportpfad = $ home/.Fracht/Bin: $ path ">> $ bash_env '
// das Programm erstellen
Sh 'Frachtbau -Release'


Stage ('Archivartefakte')
Schritte
// die ausführbare Datei archivieren
Archiveartifacts Artefacts: 'Target/Release/Hello_world', Fingerabdruck: True

Die obige Pipeline hat zwei Phasen: eine „Build“ -Piefe und eine „Archivartefakte“.

Die „Build“ -Stufe installiert Rost, fügt ihn zum Pfad hinzu und erstellt das Programm dann mit dem Cargo Build -Befehl.

Die Stufe „Archivartefakte“ archiv.

Wir setzen auch die Fingerabdruckoption auf True ein und ermöglichen Jenkins, einen Fingerabdruck für das Artefakt zu erstellen.

Diese Pipeline setzt das Rust -Projekt und die Fracht über.TOML -Dateien befinden sich im Stammpunkt des Jenkins -Arbeitsbereichs.

Abschluss

Dieses Tutorial hat uns über den Jenkins Archiveartifact -Block, die verschiedenen Optionen, die wir verwenden, und mehr gelehrt, und mehr. Wir haben auch ein praktisches Beispiel geliefert, das zeigt, wie wir den Archiveartifact -Block verwenden können, um ein Archiv von binären Artefakten aus dem Build zu erstellen.