So installieren Sie Jenkins auf Ubuntu 22.04

Jenkins ist ein Open-Source-Automatisierungstool für Continuous Integration/Continuous Delivery (CI/CD). Es ist vollständig in Java geschrieben und unterstützt mehr als 1000 Plugins zum Erstellen, Bereitstellen und Automatisieren Ihres Projekts. Jenkins ist eines der führenden Automatisierungstools, das Ihren Entwicklungsprozess durch Automatisierung beschleunigt. Jenkins integriert Entwicklungslebenszyklusprozesse wie Build, Dokumentation, Test, Paketierung, Staging, Bereitstellung, statische Analyse und vieles mehr.

Jenkins unterstützt mehrere Versionskontrolltools wie Git, Subversion, Mercurial, CVS, Perforce und RTC. Außerdem kann es Apache Ant, Apache Maven, Shell-Skripte und Windows-Batch-Befehle ausführen. Jenkins hat eine starke Community-Unterstützung mit umfangreicher Dokumentation und einem Wiki, was Jenkins zu einem der am häufigsten verwendeten Automatisierungstools für CI/CD macht. Es bietet auch viele verschiedene Tools, Sprachen und Automatisierungsaufgaben, um Ihren Entwicklungs- und Bereitstellungsprozess zu automatisieren.

In diesem Tutorial lernen Sie, wie Sie Jenkins auf dem neuesten Ubuntu 22.04 installieren. Dieses Tutorial behandelt auch, wie Sie Apache2 als Reverse-Proxy für Jenkins mit einer aktivierten SSL-Verbindung einrichten. Am Ende lernen Sie auch, wie Sie das erste Jenkins-Bauprojekt zum Ausführen von Shell-Skripten oder -Befehlen erstellen.

Voraussetzungen

• Ein Ubuntu 20.04-Server
• Ein Nicht-Root-Benutzer mit Administratorrechten.

Java installieren

In diesem ersten Schritt installieren Sie das Java OpenJDK und JRE auf Ihrem Ubuntu-System. Die neueste Version von Jenkins benötigt Java v11, und jetzt werden Sie es auf Ihrem System installieren.

Bevor Sie mit der Installation von Paketen beginnen, führen Sie den folgenden apt-Befehl aus, um Ihr Ubuntu-Repository zu aktualisieren und zu aktualisieren.

sudo apt update

Jetzt installieren Sie das Java OpenJDK 11 mit dem folgenden Befehl.

sudo apt install openjdk-11-jre

Geben Sie Y ein, um zu bestätigen, und drücken Sie ENTER, um die Installation zu starten. Jetzt beginnt die Installation von Java OpenJDK.

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Java-Befehl aus, um die Java-Version zu überprüfen und zu verifizieren.

java --version

Im folgenden Screenshot sehen Sie, dass Java OpenJDK 11 auf der Ubuntu 22.04-Maschine installiert ist.

Jenkins installieren

Sie haben jetzt Java auf Ihrem Ubuntu-System installiert, jetzt werden Sie Jenkins auf der Ubuntu 22.04-Maschine installieren.

Es gibt mehrere Möglichkeiten, Jenkins zu installieren, der einfachste Weg ist die Verwendung des vorgefertigten Jenkins-Pakets, das vom offiziellen Jenkins-Repository bereitgestellt wird. Um dies zu tun, müssen Sie das Jenkins-Repository zu Ihrem Ubuntu-System hinzufügen.

Führen Sie den folgenden Befehl aus, um den GPG-Schlüssel für das Jenkins-Repository hinzuzufügen.

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \  
  /usr/share/keyrings/jenkins-keyring.asc > /dev/null

Fügen Sie danach das Jenkins-Repository mit dem folgenden Befehl zu Ihrem System hinzu.

echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] \  
  https://pkg.jenkins.io/debian-stable binary/ | sudo tee \  
  /etc/apt/sources.list.d/jenkins.list > /dev/null

Führen Sie jetzt den apt-Befehl aus, um alle Ihre System-Repositorys zu aktualisieren und zu aktualisieren.

sudo apt update

Im folgenden Screenshot sehen Sie, dass das Jenkins-Repository hinzugefügt wurde.

Als nächstes können Sie Jenkins mit dem folgenden apt-Befehl installieren.

sudo apt install jenkins

Geben Sie Y ein, um die Installation zu bestätigen, und drücken Sie ENTER, um fortzufahren. Die Jenkins-Installation beginnt jetzt.

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um den Jenkins-Dienst zu starten und zu aktivieren.

sudo systemctl start jenkins  
sudo systemctl enable jenkins

Überprüfen Sie jetzt den Jenkins-Dienst mit dem folgenden Befehl.

sudo systemctl status jenkins

Im folgenden Screenshot ist der Jenkins-Dienst aktiv und läuft. Er läuft auf localhost mit dem Standardport 8080. Außerdem ist Jenkins jetzt aktiviert, was bedeutet, dass er beim Systemstart automatisch ausgeführt wird.

Apache2 als Reverse-Proxy einrichten

An diesem Punkt ist Jenkins unter der Standardadresse localhost mit dem Port 8080 aktiv und läuft. Jetzt werden Sie den Apache2-Webserver als Reverse-Proxy für Jenkins installieren und konfigurieren.

Der Apache2-Webserver wird vor dem Jenkins-Dienst laufen und die Standard-HTTP- und HTTPS-Ports für den Clientzugriff öffnen.

Führen Sie den apt-Befehl aus, um das Apache2-Paket auf Ihrem System zu installieren.

sudo apt install apache2

Geben Sie Y ein, um die Installation zu bestätigen, und drücken Sie ENTER, um fortzufahren.

Nachdem die Installation abgeschlossen ist, führen Sie den folgenden Befehl aus, um einige Apache2-Module zu aktivieren, die für die Konfiguration des Reverse-Proxys erforderlich sind.

sudo a2enmod ssl rewrite headers proxy proxy_http

Jetzt sehen Sie die Ausgabe wie im folgenden Screenshot.

Erstellen Sie als Nächstes eine neue virtuelle Hostkonfiguration /etc/apache2/sites-available/jenkins.conf mit dem Nano-Editor.

sudo nano /etc/apache2/sites-available/jenkins.conf

Fügen Sie die folgende Konfiguration in die Datei ein. Stellen Sie sicher, dass Sie den Domainnamen und den Pfad der SSL-Zertifikate ändern.

  
    ServerAdmin  webmaster@localhost  
    Redirect permanent / https://jenkins.howtoforge.local/  
  
  
  
    SSLEngine On  
    SSLCertificateFile /etc/letsencrypt/live/jenkins.howtoforge.local/fullchain.pem  
    SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.howtoforge.local/privkey.pem  
    ServerAdmin  webmaster@localhost  
    ProxyRequests     Off  
    ProxyPreserveHost On  
    AllowEncodedSlashes NoDecode  
      
        Order deny,allow  
        Allow from all  
      
    ProxyPass         /  http://localhost:8080/ nocanon  
    ProxyPassReverse  /  http://localhost:8080/  
    ProxyPassReverse  /  http://jenkins.howtoforge.local/  
    RequestHeader set X-Forwarded-Proto "https"  
    RequestHeader set X-Forwarded-Port "443"  

Speichern Sie die Datei und schließen Sie sie, wenn Sie fertig sind.

Führen Sie als Nächstes den folgenden Befehl aus, um die virtuelle Hostkonfiguration jenkins.conf zu aktivieren.

sudo a2ensite jenkins.conf

Überprüfen Sie danach alle Ihre Apache2-Konfigurationen mit dem folgenden Befehl.

sudo apachectl configtest

Stellen Sie sicher, dass Sie die Ausgabe wie “ Syntax OK “ erhalten, was bedeutet, dass alle Ihre Apache2-Konfigurationen korrekt sind.

Führen Sie schließlich den folgenden Befehl aus, um den Apache2-Dienst neu zu starten und die neuen Änderungen an Ihrer Apache2-Konfiguration anzuwenden.

sudo systemctl restart apache2

Jetzt ist der Apache2-Webserver mit der Reverse-Proxy-Konfiguration für Jenkins aktiv und läuft.

Jenkins-Installation starten

An diesem Punkt sind Sie bereit, die Jenkins-Installation und -Konfiguration über Ihren Webbrowser zu starten. Bevor Sie jedoch mit der Konfiguration von Jenkins beginnen, müssen Sie das Initialisierungspasswort für Jenkins abrufen.

Das Initialisierungspasswort für Jenkins befindet sich in der Datei /var/lib/jenkins/secrets/initialAdminPassword. Diese Datei enthält das generierte geheime Passwort zur Initialisierung Ihrer Jenkins-Installation.

Führen Sie den folgenden Befehl aus, um das Jenkins-Initialpasswort zu überprüfen und abzurufen.

ls /var/lib/jenkins/secrets/initialAdminPassword  
cat /var/lib/jenkins/secrets/initialAdminPassword

Im folgenden Screenshot sehen Sie eine zufällig von Jenkins generierte Zeichenfolge. Sie haben möglicherweise ein anderes zufälliges Geheimnis.

Kopieren Sie das initiale geheime Passwort in Ihre Notizen, dies wird später zur Einrichtung von Jenkins verwendet.

Öffnen Sie Ihren Webbrowser und besuchen Sie die URL-Installation für Ihre Jenkins-Installation (z. B. https://jenkins.howtoforge.local).

Auf der ersten Seite werden Sie aufgefordert, das Initialisierungspasswort für Jenkins einzugeben. Fügen Sie Ihr geheimes Passwort ein, um die Jenkins-Installation und -Konfiguration zu initialisieren, und klicken Sie auf Weiter.

Klicken Sie jetzt auf die Schaltfläche “ Vorgeschlagene Plugins installieren “, um die Jenkins-Konfiguration mit zusätzlichen Plugins zu starten. Diese Option ist gut für Anfänger, da sie automatisch einige Jenkins-Plugins installiert, die möglicherweise für Ihr Projekt benötigt werden.

Jetzt beginnt die Installation der Jenkins-Plugins.

Nachdem der Installationsprozess abgeschlossen ist, werden Sie nun aufgefordert, einen neuen Admin-Benutzer für Jenkins zu erstellen.

Geben Sie den neuen Admin-Benutzer, das Passwort, die E-Mail-Adresse und den vollständigen Namen für Ihre Jenkins-Installation ein und klicken Sie auf die Schaltfläche Speichern und Fortfahren.

Für die Jenkins-Installations-URL geben Sie Ihre Jenkins-Domain ein und klicken Sie auf Speichern und Beenden.

Und jetzt erhalten Sie die folgende Seite. Klicken Sie auf die Schaltfläche Neustart, um den Jenkins-Dienst neu zu starten und die neuen Konfigurationen anzuwenden.

Sobald Jenkins neu gestartet ist, besuchen Sie erneut den Domainnamen Ihrer Jenkins-Installations-URL, und jetzt erhalten Sie die Anmeldeseite von Jenkins.

Geben Sie Ihren Admin-Benutzer und das Passwort für Jenkins ein und klicken Sie auf Anmelden.

Sobald Sie sich angemeldet haben, erhalten Sie das folgende Jenkins-Dashboard.

Sie haben Jenkins erfolgreich auf dem neuesten Ubuntu 22.04 mit Apache2 als Reverse-Proxy für Ihre Bereitstellung installiert und konfiguriert.

Erstellen des ersten Jenkins-Baus

Nachdem Sie Jenkins erfolgreich installiert und konfiguriert haben, werden Sie nun den ersten Jenkins-Bau vom Jenkins-Dashboard aus erstellen.

Klicken Sie im Jenkins-Dashboard auf das Menü Neues Element, um ein neues Jenkins-Bauprojekt zu erstellen.

Geben Sie den Namen des Projekts ein und wählen Sie den Typ des Projekts aus, und klicken Sie dann auf OK. In dieser Demo hat das Projekt den Namen “erster Bau” mit dem Typ “ Freestyle-Projekt “.

Im Abschnitt “ Allgemein “ geben Sie die Beschreibung Ihres Builds ein.

Wechseln Sie nun zum Tab “ Bauen “ und wählen Sie den Build als “ Shell ausführen “ und geben Sie den folgenden Befehl als Build-Befehl ein.

echo "Dies ist ein Test-Bau auf Jenkins"

Dieses Projekt wird nur die Nachricht “Dies ist ein Test-Bau auf Jenkins” in der Jenkins-Bauausgabe anzeigen.

Klicken Sie jetzt auf die Schaltfläche Speichern.

Klicken Sie nun im Detailprojekt “ erster Bau “ auf das Menü “ Jetzt bauen “, um den Jenkins-Bau zu starten und auszuführen.

Nachdem der Prozess abgeschlossen ist, sehen Sie den Abschnitt Bauhistorie im unteren Menü wie im folgenden Screenshot.

Klicken Sie auf die Build-Nummer, um die Details des abgeschlossenen Build-Vorgangs zu erhalten.

Klicken Sie nun auf das Menü “ Konsolenausgabe “, und Sie erhalten die Ausgabe Ihres ersten Jenkins-Baus, nämlich die Nachricht “ Dies ist ein Test-Bau auf Jenkins “. Und der Jenkins-Bau war erfolgreich.

Fazit

Herzlichen Glückwunsch! Sie haben Jenkins erfolgreich auf dem neuesten Ubuntu 22.04-Server mit Apache2 als Reverse-Proxy mit aktivierter HTTPS-Sicherheitsverbindung installiert. Außerdem haben Sie die grundlegende Initialisierung und Einrichtung von Jenkins gelernt und auch das erste einfache Bauprojekt mit Jenkins erstellt.