So erstellen Sie eine Jenkinsfile

Eine JenkinsFile bezieht sich auf eine ASCII -Textdatei, die Definitionen einer Jenkins -Pipeline enthält. Eine JenkinsFile verwendet entweder eine deklarative Syntax oder ein grooviges Skriptformat. Die JenkinsFile enthält eine Reihe von Stufen und Schritten, aus denen die Jenkins -Pipeline besteht.

Jeder Schritt in der Pipeline wird in einer bestimmten Reihenfolge ausgeführt, und nachfolgende Schritte können die Ergebnisse eines Schritts verwenden. Wir verwenden hauptsächlich die Schritte, die in einer Jenkins -Pipeline definiert sind, um die automatisierten Aufgaben wie Anwendungsbildung, Testen und Bereitstellung auszuführen.

Standardmäßig ist die JenkinsFile im Stammverzeichnis eines Projekts enthalten. Sie können es jedoch in einer einzigartigen JenkinsFile -Bibliothek in Jenkins aufbewahren. Auf diese Weise können Jenkins die Jenkins -Datei verfolgen und alle Änderungen der Pipeline überwachen. Im Falle von Änderungen an der JenkinsFile oder dem Quellcode im Repository erkennt Jenkins automatisch die Änderungen, erstellen das Projekt und führen alle Tests aus, die in der JenkinsFile definiert sind.

Dieses Tutorial deckt die Grundlagen des Erstellens und Schreibens einer grundlegenden Jenkinsfile mit einer deklarativen Syntax ab.

Anatomie einer einfachen Jenkinsfile

Das folgende Beispiel zeigt eine grundlegende Jenkinsfile. Wir verwenden dies, um zu zeigen, wie eine JenkinsFile konfiguriert ist und wie sie verwendet werden:

Pipeline
Agent jeder
Stufen
Stage ('Hallo')
Schritte
Echo 'Hallo Welt'

Eine Jenkinsfile besteht aus den bereitgestellten Bausteinen. Lassen Sie uns aufschlüsseln, was jeder Block mit sich bringt.

1. Pipeline - Der Pipeline -Block gibt Jenkins an, dass jeder in diesem Block definierte Befehl als Teil der Pipeline -Konfiguration und -schritte behandelt wird. Dies ist der oberste Block in der Jenkinsfile. Sie können andere Elemente über dem Pipeline -Block wie Variablen definieren.
2. Agent - Ein Agent ist ein Jenkins -Agentenknoten, mit dem die Schritte in einer Jenkins -Pipeline ausgeführt werden. Ein Agent kann eine physische Maschine, eine virtuelle Maschine oder ein Behälter sein.
3. Bühne - Der Bühnenblock bezieht sich auf eine Gruppe von Schritten in einer Jenkins -Pipeline. Phasen werden verwendet, um die damit verbundenen Schritte zu gruppieren und die Reihenfolge zu steuern, in der sie ausgeführt werden.
4. Schritt - Der nächste Teil ist der Schrittblock. Dies wird verwendet, um eine einzige Aufgabe in einer Jenkins -Pipeline zu definieren. Jeder Schritt in der JenkinsFile wird in der Reihenfolge ausgeführt, in der sie definiert sind.

Im vorherigen Pipeline -Beispiel definieren wir eine einzelne Stufe namens Hello. Wir definieren einen einfachen Schritt in der Bühne, der die String „Hello World“ in die Konsole druckt.

Eine Jenkinsfile laufen

Befolgen Sie die Schritte, die im Folgenden angezeigt werden:

1. Installieren Sie Jenkins auf Ihrem Computer oder erhalten Sie eine Jenkins -Instanz von einem Cloud -Anbieter. Sie können unser Tutorial über die Installation von Jenkins unter Windows oder Linux überprüfen, um mehr zu erfahren.
2. Erstellen Sie ein neues Jenkins -Pipeline.
3. Wählen Sie im Abschnitt "Pipeline" das "Pipeline -Skript" aus.
4. Fügen Sie den Inhalt der Jenkinsfile ein, die im vorherigen Beispiel angegeben sind.
5. Speichern Sie das Projekt, indem Sie auf die Schaltfläche „Speichern“ klicken.
6. Klicken Sie auf die Schaltfläche „Jetzt erstellen“, um die JenkinsFile auszuführen.

Sie können die Ausgabe des JenkinsFile anzeigen, indem Sie auf die Build -Nummer im Abschnitt „Build History“ im Dashboard klicken.

Gehen Sie zum Abschnitt „Konsolenausgabe“, um die Nachricht aus dem Echo -Befehl anzuzeigen.

Es ist gut zu bedenken, dass Sie in einer Jenkinsfile viel mehr definieren können. Einige gängige Blöcke, auf die Sie begegnen könnten, enthalten Folgendes:

1. Umgebung - Der Umgebungsblock wird verwendet, um die Umgebungsvariablen festzulegen, in denen die Schritte in der Jenkinsfile verwendet werden können.
2. Post - Wir können den Postblock verwenden, um die Schritte anzugeben, die nach Abschluss der Hauptpipeline -Schritte ausgeführt werden sollten.
3. Versuchen Sie/Catch - Ein weiterer Standardblock ist der Try/Catch -Block. Dies wird verwendet, um die Ausnahmen zu behandeln, die während der Ausführung der Jenkins -Pipeline auftreten können. Sie können unser Tutorial dazu erkunden, um mehr zu erfahren.
4. Parallele - Der parallele Block ermöglicht es uns, eine Reihe von Schritten zu definieren, die parallel ausgeführt werden.
5. Eingabe - Sie finden auch den Eingangsblock in den meisten JenkinsFile. Dieser Block wird verwendet, um die Jenkins -Pipeline zu pausieren und eine Eingabe vom Benutzer zu fordern.
6. Zeitstempel - Schließlich ist ein weiterer Standardblock innerhalb einer Jenkinsfile der Zeitstempelblock. Dies wird verwendet, um die Zeitstempel zur Ausgabe der Jenkins -Pipeline hinzuzufügen.

Sie können die Dokumentation der Jenkins -deklarativen Syntax untersuchen, um mehr über die verschiedenen Blöcke zu erfahren, die Sie verwenden können.

Abschluss

Wir haben besprochen, wie Sie eine Jenkinsfile erstellen können. Wir haben auch die Anatomie einer Jenkinsfile behandelt, indem wir eine primäre Hello World -Pipeline erkundet haben.