Erkundung der Jenkins-Oberfläche

Einführung

Willkommen zu Ihrer ersten praktischen Erfahrung mit Jenkins. Jenkins ist ein leistungsstarker Open-Source-Automatisierungsserver, der zum Erstellen, Testen und Bereitstellen von Software verwendet wird, eine Praxis, die als Continuous Integration und Continuous Deployment (CI/CD) bekannt ist.

In diesem Lab werden Sie sich mit den grundlegenden Aspekten der Jenkins-Benutzeroberfläche vertraut machen. Wir führen Sie durch das Haupt-Dashboard, zeigen Ihnen, wie Sie Ihr erstes einfaches Projekt erstellen und konfigurieren, einen Build ausführen und die Ergebnisse überprüfen. Der Jenkins-Dienst ist in dieser Umgebung bereits installiert und läuft, sodass Sie sich direkt auf die Erkundung seiner Funktionen konzentrieren können.

Am Ende dieses Labs werden Sie in der Lage sein:

• Das Haupt-Jenkins-Dashboard zu navigieren.
• Ein neues Freestyle-Projekt zu erstellen.
• Einen Build-Job manuell auszuführen.
• Den Build-Verlauf und die Konsolenausgabe anzuzeigen.

Lassen Sie uns beginnen.

Zugriff auf und Erkundung des Jenkins-Dashboards

In diesem Schritt melden Sie sich bei der Jenkins Weboberfläche an und machen sich mit dem Haupt-Dashboard vertraut. Der Jenkins-Dienst läuft bereits in einem Container für Sie.

Greifen Sie zunächst auf die Jenkins Weboberfläche zu. Klicken Sie oben auf Ihrem LabEx-Bildschirm auf die Registerkarte Desktop Interface. Öffnen Sie innerhalb des virtuellen Desktops den Webbrowser Firefox. Der Browser öffnet sich automatisch unter http://localhost:8080, sodass Sie die URL nicht manuell eingeben müssen. Eine Anmeldung ist nicht erforderlich.

Sie sehen nun das Haupt-Jenkins-Dashboard. Nehmen Sie sich einen Moment Zeit, um sich mit seinen Schlüsselkomponenten vertraut zu machen:

• Navigationsleiste (Links): Dies ist Ihr primäres Navigationsmenü. Hier finden Sie wichtige Links wie New Item (zum Erstellen neuer Jobs) und Build History (eine globale Übersicht aller Builds).
• Hauptinhaltsbereich: Dieser Bereich zeigt eine Liste aller von Ihnen erstellten Jobs an. Anfangs wird dieser leer sein.

Nachdem Sie sich nun mit dem Dashboard vertraut gemacht haben, sind Sie bereit, Ihr erstes Projekt zu erstellen.

Erstellen eines Freestyle-Projekts

In diesem Schritt erstellen Sie Ihren ersten Jenkins-Job mit dem Typ „Freestyle-Projekt“. Ein Freestyle-Projekt ist eine sehr flexible und einfach zu bedienende Option, ideal für Anfänger und eine Vielzahl von Automatisierungsaufgaben.

1. Klicken Sie in der Jenkins-Weboberfläche in der linken Navigationsleiste auf New Item (Neues Element).

2. Auf der nächsten Seite müssen Sie einen Namen für Ihr Projekt vergeben und dessen Typ auswählen.

   • Geben Sie in das Feld Enter an item name (Einen Elementnamen eingeben) My-First-Job ein.
   • Wählen Sie Freestyle project aus der Optionsliste aus.
   • Klicken Sie unten auf die Schaltfläche OK.

3. Sie befinden sich nun auf der Konfigurationsseite des Projekts. Hier definieren Sie, was Ihr Job tun soll. Für dieses Lab fügen wir einen einzigen, einfachen Build-Schritt hinzu. Scrollen Sie nach unten zum Abschnitt Build Steps (Build-Schritte).

4. Klicken Sie auf die Dropdown-Schaltfläche Add build step (Build-Schritt hinzufügen) und wählen Sie Execute shell (Shell ausführen). Dies ermöglicht Ihnen, Shell-Befehle als Teil Ihres Builds auszuführen.

5. Ein Befehlsfeld wird angezeigt. Geben Sie in dieses Feld den folgenden Befehl ein:

   echo "Hello from my first Jenkins job!"

6. Scrollen Sie schließlich zum Ende der Seite und klicken Sie auf die Schaltfläche Save (Speichern).

Nach dem Speichern leitet Sie Jenkins zur Hauptseite Ihres neu erstellten Projekts, My-First-Job, weiter.

Ausführen des Build-Jobs

In diesem Schritt führen Sie den gerade erstellten Job aus, oder "bauen" ihn. Das Ausführen eines Jobs bedeutet, die für ihn konfigurierten Schritte zu exekutieren.

Sie sollten sich derzeit auf der Projektseite für My-First-Job befinden. Falls Sie navigiert haben, können Sie dorthin zurückkehren, indem Sie auf dessen Namen im Haupt-Dashboard von Jenkins klicken.

1. Suchen Sie auf der Projektseite für My-First-Job in der Navigationsleiste auf der linken Seite. Sie sehen dort die Option Build Now (Jetzt bauen).

2. Klicken Sie auf Build Now, um den Build-Prozess zu starten.

Sobald Sie darauf klicken, wird ein neuer Build eingeplant. Sie werden ihn im Abschnitt Build History (Build-Verlauf) unten links erscheinen sehen. Dem Build wird eine Nummer zugewiesen, beginnend mit #1.

Neben der Build-Nummer erscheint ein kleines Status-Icon. Ein blinkendes grünes Icon bedeutet, dass der Build gerade ausgeführt wird (in progress). Ein durchgehend grüner Kreis bedeutet, dass der Build erfolgreich war (successful). Da unser Job sehr einfach ist, wird er in nur ein oder zwei Sekunden abgeschlossen sein.

Sie haben nun erfolgreich Ihren ersten Build ausgelöst.

Anzeigen der Konsolenausgabe

In diesem Schritt lernen Sie, wie Sie die Ergebnisse Ihres Builds überprüfen können. Die Überprüfung der Ausgabe ist ein entscheidender Teil jedes Automatisierungsprozesses, da sie Ihnen genau mitteilt, was passiert ist und ob es erfolgreich war.

1. Suchen Sie auf der Projektseite von My-First-Job den Abschnitt Build History (Build-Verlauf) in der unteren linken Ecke. Sie sollten Ihren ersten Build mit der Bezeichnung #1 sehen, der durch einen grünen Kreis als erfolgreich gekennzeichnet ist.

2. Klicken Sie auf die Build-Nummer #1, um zur Detailseite für diesen spezifischen Build zu gelangen.

3. Auf der Build-Seite sehen Sie verschiedene Details zum Build, wie z. B. wann er ausgeführt wurde. Der wichtigste Link hier zum Debuggen ist Console Output (Konsolenausgabe). Klicken Sie in der linken Seitenleiste auf Console Output.

4. Die Seite Console Output zeigt ein detailliertes Protokoll aller Aktionen, die Jenkins während des Builds durchgeführt hat. Sie werden sehen, dass Jenkins den Build gestartet, Ihren Shell-Befehl ausgeführt und den Build anschließend als abgeschlossen markiert hat.

Die Ausgabe sollte in etwa wie folgt aussehen:

Started by user admin
Running as SYSTEM
Building in workspace /var/jenkins_home/workspace/My-First-Job
[My-First-Job] $ /bin/sh -xe /tmp/jenkins12345.sh
+ echo 'Hello from my first Jenkins job!'
Hello from my first Jenkins job!
Finished: SUCCESS

Wie Sie sehen können, enthält das Protokoll den von uns konfigurierten echo-Befehl und dessen Ausgabe: Hello from my first Jenkins job!. Der abschließende Status Finished: SUCCESS bestätigt, dass der Job ohne Fehler ausgeführt wurde.

Zusammenfassung

Herzlichen Glückwunsch zum Abschluss dieses Einführungslabors. Sie haben erfolgreich Ihre ersten Schritte in der Welt von Jenkins unternommen.

In diesem Labor haben Sie gelernt, wie Sie:

• Auf das Jenkins-Dashboard zugreifen und seine Hauptkomponenten identifizieren.
• Ein neues Freestyle-Projekt von Grund auf neu erstellen.
• Einen einfachen Build-Schritt "Execute shell" konfigurieren.
• Einen Build für Ihr Projekt manuell auslösen.
• Die Build-Historie und die detaillierte Konsolenausgabe finden und überprüfen, um das Ergebnis zu verifizieren.

Diese grundlegenden Fähigkeiten sind die Bausteine für die Erstellung komplexerer und leistungsfähigerer Automatisierungspipelines. Sie sind nun gut darauf vorbereitet, fortgeschrittenere Jenkins-Funktionen zu erkunden.