Files
labs/01-basics/lab01/lab.txt
Thomas Kruse 8fdf5827e4 Add labs
2026-02-03 22:29:46 +01:00

128 lines
3.6 KiB
Plaintext

= Installation und Starten eines Mosquitto Brokers
Nutzen Sie eine der folgenden Methoden, um
den Mosquitto Broker lokal zu installieren und zu starten.
Lokales Arbeiten ist Teil der Schulung und weitere Labs bauen darauf auf.
Container Technologie ist ein guter Weg, um reproduzierbare Ergebnisse
zu erhalten und komfortabel zu arbeiten.
Methoden:
- Lokale Installation
- Docker Container
= Lokale Installation
== Windows
Gehen Sie auf die offizielle Seite von Eclipse Mosquitto und
laden Sie den neusten 64 Bit Installer herunter.
https://mosquitto.org/files/binary/win64/
Führen Sie die Installationsdatei aus und befolgen Sie den Anweisungen.
Merken Sie sich das Installationsverzeichnis.
Standardmäßig wird Mosquitto unter 'C:\Program Files\Mosquitto'
installiert.
Starten Sie eine Kommandozeile und navigieren Sie in das
Installationsverzeichnis von Mosquitto.
Installation abgeschlossen, weiter bei "Starten"
== Linux
Mosquitto wird nicht mehr als Binärpaket für Linux auf mosquitto.org angeboten.
Die Installationsmethode ist daher abhängig von der verwendeten Linux Distribution.
Das Beispiel nutzt Debian/Ubuntu/Armbian.
Zum Testen kann auch das in Docker ausprobiert werden
(wobei dann auch direkt ein Mosquiotto Container genutzt werden kann):
Dazu:
1) Ubuntu Container als "virtuelle Maschine" starten 2) darin die Kommandos ausführen
$ docker run --privileged --cgroupns=host --tmpfs /run --tmpfs /run/lock -v /sys/fs/cgroup:/sys/fs/cgroup:rw geerlingguy/docker-ubuntu2404-ansible
$ docker exec -it $(docker ps -q --latest) /bin/bash
Fügen Sie das Mosquitto PPA APT Repository hinzu:
$ sudo apt-add-repository ppa:mosquitto-dev/mosquitto-ppa
$ sudo apt-get update
Installieren Sie nun Mosquitto:
$ sudo apt-get install mosquitto
Der Broker sollte automatisch als Service gestartet werden.
Um ihn manuell zu starten, und die Kommandozeile zu sehen, stoppen
Sie den Mosquitto Broker und starten Sie ihn erneut.
$ sudo systemctl stop mosquitto
# ggf. pruefen ("Active: inactive") mittels "sudo systemctl status mosquitto"
Installation abgeschlossen, weiter bei "Starten"
== MacOS
Installieren Sie den Mosquitto Broker über Brew.
$ brew install mosquitto
Installation abgeschlossen, weiter bei "Starten"
= Starten des Mosquitto Brokers
Führen Sie den Befehl 'mosquitto -h' aus, um unterstützte Befehle von
Mosquitto zu sehen.
Führen Sie den Befehl 'mosquitto -v' aus um den Broker zu starten und
um die Aktivität des Brokers in der Kommandozeile mitzuverfolgen können.
= Verwendung Docker
Da das offizielle Container Image von Mosquitto keine anonymen Verbindungen erlaubt,
wird eine Konfigurationdatei benötigt, die dann in den Docker Container eingebunden wird.
Erstellen Sie dazu eine Datei mit dem Namen 'mosquitto.conf' und folgendem Inhalt:
allow_anonymous true
listener 1883
Um den Mosquitto Broker als Docker Container zu starten führen Sie
folgenden Befehl im selben Verzeichnis, wie die Konfigurationsdatei aus:
$ docker run --rm -p 1883:1883 -v $PWD/mosquitto.conf:/mosquitto/config/mosquitto.conf eclipse-mosquitto
Diesel Befehl startet einen Container mit den Mosquitto Broker, verbindet
den Host Port 1883 mit den Port 1883 des Containers und bindet die
Konfigurationdatei an passender Stelle ein.
= Referenzen
Download Page von Mosquitto https://mosquitto.org/download/
Docker Desktop Installation https://docs.docker.com/desktop/
Docker Standalone Installation https://docs.docker.com/engine/install/
Docker Container Runtime für MacOS https://github.com/abiosoft/colima
Mosquitto Docker Container https://hub.docker.com/_/eclipse-mosquitto