Inspektion von Jenkins mit Docker

Einführung

In diesem Lab untersuchen Sie, wie Jenkins innerhalb eines Docker-Containers in der LabEx-Jenkins-Umgebung ausgeführt wird. Der Jenkins-Dienst ist bereits installiert, gestartet und unter http://localhost:8080 verfügbar, sodass Sie sich auf das Verständnis des Docker-Bereitstellungsmodells konzentrieren können, anstatt auf eine Neuinstallation warten zu müssen.

Sie werden folgende praktische Fertigkeiten erlernen:

• Überprüfung der Verfügbarkeit von Docker auf dem Host.
• Identifizierung des laufenden Jenkins-Containers und des zugehörigen Images.
• Inspektion der von Jenkins genutzten veröffentlichten Ports.
• Lokalisierung des Jenkins-Home-Verzeichnisses innerhalb des Containers.
• Lesen von Container-Protokollen und Öffnen der Jenkins-Weboberfläche.

Dies sind grundlegende Fähigkeiten für den Betrieb von Jenkins in Docker-basierten Entwicklungs- und Trainingsumgebungen.

Inspektion der Docker-Umgebung

In diesem Schritt bestätigen Sie, dass Docker verfügbar ist und die Jenkins-Umgebung auf Docker-Basis läuft.

Öffnen Sie ein Terminal in der LabEx-VM und überprüfen Sie die Docker-Version:

docker --version

Sie sollten eine Ausgabe ähnlich der folgenden sehen:

Docker version ...

Listen Sie anschließend die laufenden Container auf:

docker ps

Suchen Sie nach einem Container namens jenkins. Dies ist der Jenkins-Controller, der während des gesamten Labs verwendet wird. Die Ausgabe enthält mehrere Spalten, aber die wichtigen Felder sind der Image-Name, die Port-Zuordnung und der Container-Name:

CONTAINER ID   IMAGE                    ...   PORTS                  NAMES
...            jenkins/jenkins:latest   ...   0.0.0.0:8080->8080/tcp jenkins

Die entscheidenden Informationen sind der Container-Name, das Image und die Port-Zuordnung. Sie müssen in diesem Lab keine Container starten oder entfernen.

Inspektion des Jenkins-Images

In diesem Schritt identifizieren Sie das Docker-Image, das vom laufenden Jenkins-Container verwendet wird.

Führen Sie den folgenden Befehl aus:

docker inspect jenkins --format '{{.Config.Image}}'

Dies gibt den Namen des Images aus, das zur Erstellung des Containers verwendet wurde. In dieser Umgebung sollte ein Jenkins-Image angezeigt werden:

jenkins/jenkins:latest

Sie können auch die lokalen Images auflisten:

docker images jenkins/jenkins

Die genaue Image-ID und das Erstellungsdatum können variieren, aber das Repository sollte jenkins/jenkins lauten:

REPOSITORY        TAG       IMAGE ID       CREATED       SIZE
jenkins/jenkins   latest    ...            ...           ...

Dies hilft Ihnen dabei, den laufenden Dienst im Browser mit dem Container-Image zu verknüpfen, das Jenkins bereitstellt.

Inspektion von Jenkins-Ports und Daten

In diesem Schritt untersuchen Sie die Netzwerk-Ports und das Jenkins-Home-Verzeichnis, die vom Container verwendet werden.

Jenkins nutzt den Port 8080 für die Weboberfläche. Überprüfen Sie die veröffentlichten Ports:

docker port jenkins

Sie sollten sehen, dass Port 8080 auf dem Host veröffentlicht ist, ähnlich wie hier:

8080/tcp -> 0.0.0.0:8080
8080/tcp -> :::8080

Überprüfen Sie nun das Jenkins-Home-Verzeichnis innerhalb des Containers:

docker exec jenkins ls /var/jenkins_home

Sie sollten Jenkins-Daten wie Jobs, Plugins, Protokolle oder Konfigurationsdateien sehen:

config.xml
jobs
plugins
...

Jenkins speichert seine Konfiguration und Job-Daten in /var/jenkins_home. Dieses Verzeichnis ist daher der wichtigste Ort für Backups oder zur Fehlerbehebung.

Lesen der Jenkins-Container-Protokolle

In diesem Schritt lesen Sie die Protokolle des Jenkins-Containers. Protokolle sind oft die erste Anlaufstelle, wenn Jenkins nicht startet oder sich unerwartet verhält.

Führen Sie aus:

docker logs --tail 30 jenkins

Die Ausgabe sollte Start- oder Laufzeitmeldungen von Jenkins enthalten. Möglicherweise sehen Sie die Jenkins-Version, Plugin-Meldungen oder Protokolle zum Start des HTTP-Servers.

Die genauen Zeilen können variieren, aber der Befehl sollte die letzten Protokolleinträge des laufenden jenkins-Containers zurückgeben.

Öffnen der Jenkins-Weboberfläche

In diesem Schritt verbinden Sie den von Ihnen inspizierten Docker-Container mit der Jenkins-Weboberfläche.

Öffnen Sie den Firefox-Browser über die Desktop-Oberfläche. Der Browser öffnet Jenkins unter:

http://localhost:8080

In dieser Umgebung ist kein Login erforderlich.

Sie sollten das Jenkins-Dashboard sehen.

Dies bestätigt, dass der jenkins-Docker-Container die Jenkins-Web-UI über Port 8080 bereitstellt.

Zusammenfassung

In diesem Lab haben Sie eine laufende Jenkins-Bereitstellung auf Docker-Basis inspiziert.

Sie haben gelernt:

• Die Verfügbarkeit von Docker zu bestätigen.
• Den laufenden Jenkins-Container zu identifizieren.
• Das Jenkins-Docker-Image zu untersuchen.
• Die Freigabe von Port 8080 zu prüfen.
• Das Verzeichnis /var/jenkins_home zu inspizieren.
• Die Jenkins-Container-Protokolle zu lesen.
• Das Jenkins-Web-Dashboard zu öffnen.

Diese Fähigkeiten helfen Ihnen dabei, Docker-basierte Jenkins-Umgebungen zu verstehen und Fehler zu beheben, ohne den Controller von Grund auf neu aufbauen zu müssen.