User Manual
awaBerry | Mit Docker verbinden - Ubuntu
Führen Sie den awaBerry Docker-Agenten unter Ubuntu aus. Schritt-für-Schritt-Anleitung für die Ubuntu-Container-Einrichtung, die Agenteninstallation und die...
Verbindung mit Docker herstellen - Ubuntu
Zusammenfassung
Diese Handbuchseite unterstützt Sie bei der Herstellung einer Verbindung zu Ihrem awaBerry-Gerät über Docker unter einem Ubuntu-Betriebssystem. Sie enthält klare Anweisungen zum Herunterladen der erforderlichen Docker-Dateien und zur Ausführung der notwendigen Befehle zum Erstellen und Ausführen des awaBerry Docker-Images.
Seitenaufruf
Sie können diese Seite aufrufen, indem Sie zu folgender Adresse navigieren: /connect_steps_docker?os=ubuntu
Seitenfunktionen
- Schaltfläche "Docker-Datei herunterladen": Diese Schaltfläche ermöglicht Ihnen den Download der spezifischen Docker-Konfigurationsdatei, die für Ihr awaBerry-Gerät unter Ubuntu angepasst ist (z. B. "Docker-Datei herunterladen (ubuntu latest)"). Ein Klick darauf öffnet einen neuen Browser-Tab oder ein neues Fenster, um den Download zu starten.
- Link "Lizenz herunterladen": Dieser Link bietet Zugriff auf die erforderliche Lizenzdatei für Ihre Docker-Einrichtung (z. B. "Lizenz herunterladen (ubuntu latest)"). Ein Klick darauf öffnet einen neuen Browser-Tab oder ein neues Fenster, um die Lizenz herunterzuladen.
- Docker Build-Befehl: Dieser Abschnitt zeigt den Befehl an, den Sie in Ihrem Terminal ausführen müssen, um das awaBerry Docker-Image aus der heruntergeladenen Docker-Datei zu erstellen. Er enthält eine Kopierschaltfläche, um den Befehl einfach in Ihre Zwischenablage zu übertragen.
- Docker Run-Befehl: Dieser Abschnitt zeigt den Befehl zum Starten eines neuen awaBerry Docker-Containers an. Er enthält ebenfalls eine Kopierschaltfläche für die einfache Übertragung in die Zwischenablage.
- Docker Exec-Befehl: Dieser Abschnitt zeigt den Befehl zum Zugriff auf die Kommandozeile des laufenden awaBerry Docker-Containers an. Er enthält eine Kopierschaltfläche für die einfache Übertragung in die Zwischenablage.
- Schaltfläche "Zurück zur Geräteliste": Diese Schaltfläche ermöglicht Ihnen die Rückkehr zur Hauptliste Ihrer Geräte und bricht den aktuellen Verbindungsprozess ab.
Szenarioausführungen
Mögliche Nutzungsschritte auf dieser Seite
1. Herunterladen von Docker-Dateien
- Schritt 1: Suchen und klicken Sie auf die Schaltfläche "Docker-Datei herunterladen (ubuntu latest)". Ihr Browser startet den Download der Docker-Einrichtungsdatei.
- Schritt 2: Suchen und klicken Sie auf den Link "Lizenz herunterladen (ubuntu latest)". Ihr Browser startet den Download der Lizenzdatei.
- Ergebnis: Sie werden sowohl die Docker-Datei als auch die Lizenzdatei auf Ihrem Computer gespeichert haben, bereit für die nächsten Schritte.
2. Einrichten des awaBerry Docker-Images
- Schritt 1: Speichern Sie die heruntergeladene Docker-Datei auf Ihrem Gerät, auf dem eine Docker-Umgebung läuft (wie Docker Desktop oder Docker unter Linux).
- Schritt 2: Öffnen Sie ein Terminal oder eine Eingabeaufforderung im Verzeichnis, in dem Sie die Docker-Datei gespeichert haben.
- Schritt 3: Kopieren Sie den "Docker Build-Befehl" (z. B.
docker build --progress=plain --build-arg CACHE_BUST=<CURRENT_TIMESTAMP> -t ubuntu_awaberry_default .), indem Sie auf das Kopiersymbol daneben klicken. Fügen Sie den Befehl in Ihr Terminal ein und drücken Sie Enter, um das awaBerry Docker-Image zu erstellen. - Schritt 4: Nach Abschluss des Builds kopieren Sie den "Docker Run-Befehl" (z. B.
containerid=$(docker run -d -p 80:80 -p 443:443 -v /host/path/for/awaberry_data:/var/lib/awaberry ubuntu_awaberry_default)) und fügen Sie ihn in Ihr Terminal ein, dann drücken Sie Enter, um den awaBerry Docker-Container zu starten. - Schritt 5: Wenn Sie auf die Kommandozeile innerhalb Ihres laufenden Docker-Containers zugreifen müssen, kopieren Sie den "Docker Exec-Befehl" (z. B.
docker exec -it <container_id> /bin/bash) und fügen Sie ihn in Ihr Terminal ein, dann drücken Sie Enter. - Ergebnis: Das awaBerry Docker-Image wird auf Ihrem System erstellt und ausgeführt, und neue Geräte werden automatisch hinzugefügt.
3. Zurück zur Geräteliste
- Schritt 1: Nach Abschluss Ihrer Docker-Einrichtung oder wenn Sie den Vorgang abbrechen möchten, klicken Sie auf die Schaltfläche "Zurück zur Geräteliste".
- Ergebnis: Sie werden zur Hauptseite der Geräteliste weitergeleitet.
Mögliche Fehler, die auf dieser Seite auftreten können
1. Download-Fehler
- Fehler: Der Download der Docker-Datei oder der Lizenz beginnt nicht, oder der Browser meldet einen Download-Fehler.
- Ursache: Dies tritt typischerweise auf, wenn es ein Problem mit Ihrer Internetverbindung gibt, ein vorübergehendes Problem mit dem Download-Server vorliegt oder Ihre Browser-Sicherheitseinstellungen den Download verhindern.
- Was zu tun ist: Überprüfen Sie Ihre Internetverbindung. Versuchen Sie, die Download-Schaltflächen erneut zu klicken. Wenn das Problem weiterhin besteht, stellen Sie sicher, dass Ihr Browser auf dem neuesten Stand ist, und lockern Sie vorübergehend strenge Download-Sicherheitseinstellungen, falls dies sicher ist.
2. Fehler bei der Ausführung von Docker-Befehlen
- Fehler: Wenn Sie die Docker-Befehle in Ihr Terminal einfügen und ausführen, erhalten Sie Fehlermeldungen wie "Befehl nicht gefunden", "Docker-Daemon läuft nicht" oder Fehler beim Erstellen/Ausführen.
- Ursache: Dies deutet darauf hin, dass Docker möglicherweise nicht korrekt auf Ihrem System installiert oder ausgeführt wird, oder es gibt einen Syntaxfehler, wenn Sie den kopierten Befehl geändert haben. Build-Fehler können auch auftreten, wenn die heruntergeladene Docker-Datei beschädigt ist oder wenn es zugrunde liegende Systemressourcenprobleme gibt.
- Was zu tun ist:
- Stellen Sie sicher, dass Docker Desktop (für Windows/macOS) oder Docker Engine (für Linux) auf Ihrem Rechner installiert und ausgeführt wird.
- Verifizieren Sie, dass Sie die Befehle exakt wie angegeben kopiert haben, ohne Änderungen.
- Konsultieren Sie die offizielle Docker-Dokumentation zur Fehlerbehebung bei spezifischen Docker-Fehlermeldungen.
