User Manual
awaBerry | Mit Docker verbinden - Debian
Führen Sie den awaBerry Docker-Agenten unter Debian aus. Container-Einrichtungsanleitung einschließlich Image-Pull, Konfiguration und Geräte-Registrierung...
Verbindung mit Docker herstellen - Debian
Zusammenfassung
Diese Seite ist ein wichtiger Schritt bei der Einrichtung Ihres awaBerry-Geräts mit Docker unter einem Debian-System. Hier können Sie die notwendige Docker-Konfigurationsdatei und die entsprechende Lizenz herunterladen. Zusätzlich finden Sie eine Abfolge von Befehlszeilenanweisungen, die Sie durch das Erstellen, Ausführen und Interagieren mit Ihrem neuen awaBerry Docker-Container führen. Befolgen Sie diese Schritte, um Ihre Umgebung vorzubereiten und Ihr neues Gerät mit awaBerry zu integrieren.
Seitenaufruf
Sie können diese Seite aufrufen, indem Sie zu folgender Adresse navigieren: /connect_steps_docker?os=debian
Seitenfunktionen
Diese Seite bietet verschiedene interaktive Elemente zur Erleichterung des Docker-Verbindungsprozesses:
- Schaltfläche "Docker-Datei herunterladen": Diese prominent platzierte Schaltfläche ermöglicht Ihnen den Download der spezifischen Docker-Konfigurationsdatei, die für Ihr ausgewähltes Betriebssystem (Debian) und Ihre Docker-Version maßgeschneidert ist. Durch Klicken auf diese Schaltfläche wird der Download in Ihrem Browser geöffnet.
- Schaltfläche "Lizenz herunterladen": Unterhalb der Schaltfläche für die Docker-Datei ermöglicht Ihnen dieser Link den Download der notwendigen Lizenzdatei für Ihre awaBerry Docker-Einrichtung. Dies wird ebenfalls in Ihrem Browser geöffnet.
- Befehlszeilenanweisungen: Drei separate Codeblöcke zeigen die wesentlichen Befehle, die zur Einrichtung und Ausführung Ihres awaBerry Docker-Containers benötigt werden:
- Docker Build-Befehl: Dieser Befehl wird verwendet, um das awaBerry Docker-Image aus der heruntergeladenen Docker-Datei zu erstellen.
- Docker Run-Befehl: Nach dem Erstellen startet dieser Befehl einen neuen Docker-Container aus Ihrem awaBerry-Image.
- Docker Exec-Befehl: Dieser Befehl ermöglicht Ihnen den Zugriff auf die Befehlszeile des laufenden Docker-Containers, wo die awaBerry-Installationsroutine automatisch startet.
- Schaltfläche "Zurück zur Geräteliste": Am Ende der Seite ermöglicht Ihnen diese Schaltfläche die Rückkehr zu Ihrer Liste der registrierten awaBerry-Geräte und beendet den Verbindungsprozess für diese Sitzung.
Szenarioausführungen
Mögliche Nutzungsschritte auf dieser Seite
Um Ihr Gerät erfolgreich über Docker unter Debian zu verbinden, befolgen Sie diese Schritte:
- Docker-Datei und Lizenz herunterladen:
- Klicken Sie auf die Schaltfläche "Docker-Datei herunterladen (Debian latest)". Ihr Browser lädt die Docker-Konfigurationsdatei herunter.
- Klicken Sie auf den Link "Lizenz herunterladen (Debian latest)". Ihr Browser lädt die notwendige Lizenzdatei herunter.
- Speichern Sie beide Dateien an einem geeigneten Ort auf Ihrem Gerät, auf dem eine Docker-Umgebung installiert ist (z. B. Docker Desktop, Docker unter Linux).
- Docker-Befehle ausführen:
- Öffnen Sie Ihr Terminal oder Ihre Eingabeaufforderung.
- Navigieren Sie zu dem Verzeichnis, in dem Sie die Docker-Datei gespeichert haben.
- Kopieren Sie den Docker Build-Befehl, indem Sie auf sein Kopiersymbol klicken, fügen Sie ihn dann ein und führen Sie ihn in Ihrem Terminal aus. Dies erstellt das awaBerry Docker-Image.
- Sobald der Build abgeschlossen ist, kopieren Sie den Docker Run-Befehl und führen Sie ihn aus. Dies startet Ihren awaBerry Docker-Container im Hintergrund.
- Kopieren Sie abschließend den Docker Exec-Befehl und führen Sie ihn aus. Dies öffnet eine Shell innerhalb Ihres laufenden Containers, und die awaBerry-Installationsroutine beginnt automatisch.
- Installation und Geräte-Registrierung:
- Die awaBerry-Installationsroutine führt Sie durch die abschließenden Einrichtungsschritte innerhalb des Docker-Containers.
- Nach erfolgreicher Fertigstellung werden neue Docker-Container automatisch zu Ihrer awaBerry-Geräteliste hinzugefügt, und Sie erhalten für jeden neu hinzugefügten Container eine Bestätigungs-E-Mail.
- Zurück zur Geräteliste: Nach Abschluss der Einrichtung klicken Sie auf die Schaltfläche "Zurück zur Geräteliste", um zur Hauptseite der Geräteverwaltung zurückzukehren.
Mögliche Fehler, die auf dieser Seite auftreten können
Obwohl die Seite selbst auf eine reibungslose Interaktion ausgelegt ist, können Probleme mit Ihrer lokalen Umgebung oder der Netzwerkverbindung auftreten:
- Download-Fehler: Wenn Sie auf die Schaltflächen "Docker-Datei herunterladen" oder "Lizenz herunterladen" klicken und nichts passiert oder eine Fehlermeldung in Ihrem Browser angezeigt wird, kann dies folgende Ursachen haben:
- Netzwerkverbindungsprobleme: Stellen Sie sicher, dass Ihre Internetverbindung stabil ist.
- Browser-Beschränkungen: Die Sicherheitseinstellungen Ihres Browsers verhindern möglicherweise den Download. Versuchen Sie, diese vorübergehend anzupassen oder einen anderen Browser zu verwenden.
- Werbeblocker/Sicherheitssoftware: Diese Tools können manchmal Dateidownloads beeinträchtigen.
- Fehler beim Kopieren von Befehlen: Obwohl unwahrscheinlich, wenn das Klicken auf das Kopiersymbol für einen Befehl den Text nicht in Ihre Zwischenablage kopiert oder die Benachrichtigung nicht erscheint, könnte dies darauf hindeuten:
- Browser-/Geräteberechtigungen: In seltenen Fällen können Ihr Browser oder Ihr Betriebssystem Webseiten den Zugriff auf die Zwischenablage verweigern.
- Probleme mit externer Docker-Umgebung (nach dem Kopieren von Befehlen): Obwohl dies kein direkter Fehler auf *dieser* Seite ist, können die kopierten Befehle in Ihrem Terminal fehlschlagen, wenn:
- Docker ist nicht installiert oder läuft nicht: Die Befehle erfordern eine funktionierende Docker-Umgebung.
- Falsches Verzeichnis: Sie müssen den Build-Befehl aus dem Verzeichnis ausführen, in dem sich die Docker-Datei befindet.
- Berechtigungsprobleme: Ihr Benutzerkonto hat möglicherweise nicht die erforderlichen Berechtigungen zum Ausführen von Docker-Befehlen.
