Erste Schritte Debian Docker

Erste Schritte mit Debian Docker

Nachdem im HOOC Managementportal eine Anlage erstellt wurde, erfolgt die Aktivierung nach untenstehenden Punkten:

  1. Linken des HOOC Gateways mit einer Anlage mittels Eingabe Seriennummer im HOOC Managementportal
  2. Navigation zu HOOC Gateway -> Konfiguration
  3. Auswahl Plattform / Prozessor mit Paket Docker Image und das HOOC Connect Docker Image ohne VPN-Zugangsdaten auf eigene Hardware herunterladen
  4. Befehl docker load < HOOC_CONNECT_DOCKERIMAGE_LINUX_ARM_V7_GENERIC.tar ausführen
  5. Der Name des geladenen Docker Images wird in der Konsole angezeigt (Bsp: Loaded image: hooc/connect-generic:0.2.0)
  6. Mittels Kommando docker run --rm -it --cap-add NET_ADMIN --network host hooc/connect-generic:0.2.0 hwid das nicht aktivierte Embedded Gateway starten
  7. Kopieren des 64-Stelligen Hardware-Identifikations-Codes (Console Output Docker) in das entsprechende Feld im HOOC Managementportal und aktivieren.

Der Hardware-Identifikations-Code (hwid) ist ein eindeutiger Code, welcher die Hardware identifiziert. Dadurch wird sichergestellt, dass ein Lizenzschlüssel nur von der jeweiligen Hardware verwendet werden kann. Erst nach erfolgreicher Bestätigung des Hardware-Identifikations-Code kann das HOOC Connect Binary mit den VPN-Zugangsdaten der Anlage heruntergeladen werden.

  1. Auswahl Plattform / Prozessor mit Paket Docker Image und das HOOC Connect Docker Image mit VPN-Zugangsdaten auf eigene Hardware herunterladen
  2. Befehl docker load < HOOC_CONNECT_DOCKERIMAGE_LINUX_ARM_V7_12345678901234567890.tar ausführen
  3. Der Name des geladenen Docker Images wird in der Konsole angezeigt (Bsp: Loaded image: hooc/connect-12345678901234567890:0.2.0)
  4. Mittels Kommando docker run --rm -it --device /dev/net/tun --cap-add NET_ADMIN --network host hooc/connect-12345678901234567890:0.2.0 das aktivierte Embedded Gateway starten

Nun sollte der Console Output INFO[0000] Successfully connected to VPN... ersichtlich sein. Zudem wird der Status der VPN-Verbindung auf im HOOC Managementportal angezeigt.

Use Case Daemon

docker run \
    --name hooc-connect \
    --detach \
    --device /dev/net/tun \
    --cap-add NET_ADMIN \
    --network host \
    --restart unless-stopped \
    hooc/connect-12345678901234567890:0.2.0

Mittels obenstehendem Kommando kann der HOOC Embedded Gateway als Daemon gestartet werden. Dieser wird automatisch beim Starten von Docker gestartet.

Use Case Bridge

Das HOOC Connect Docker Image erstellt beim Starten das Netzwerkinterface hooc-tap0. Falls nun die selbe Funktionalität wie beispielsweise beim HOOC Connect H gewünscht ist, muss eine Brücke zwischen dem physikalischen Netzwerkinterface, beispielsweise eth0 und dem hooc-tap0 konfiguriert werden. Bei untenstehenden Konfigurationsbeispielen bezieht die Brücke per DHCP eine IP Adresse.

Der Befehl iptables -A FORWARD -j ACCEPT -i br-hooc -o br-hooc stellt sicher, dass die Brücke Datenpakete korrekt weiterleitet. Dieser muss vor dem Starten von Docker ausgeführt werden.

Nicht persistente Konfiguration

Die nicht persistente Konfiguration ist nach einem Neustart des Betriebssystems nicht mehr vorhanden. Stellen Sie sicher, dass die Pakete net-tools und bridge-utils installiert sind. Führen Sie untenstehende Befehle als root-user aus.

# Stop docker daemon
service docker stop
# Create the bridge br-hooc
brctl addbr br-hooc
# Add the physical eth0 to the br-hooc bridge
brctl addif br-hooc eth0
# Remove IP eth0
ifconfig eth0 0.0.0.0
# Bring eth0 up
ifconfig eth0 up
# Obtain IP from local DHCP-Server
dhclient br-hooc
# Start docker daemon
service docker start
# Start the embedded gateway with the bridge parameter
docker run --rm -it --device /dev/net/tun --cap-add NET_ADMIN --network host hooc/connect-12345678901234567890:0.2.0 --vpn.linux.bridge=br-hooc

Persistente Konfiguration

Die Netzwerkbrücke sowie das physikalische Netzwerkinterface in der entsprechenden Netzwerkkonfigurationsdatei anpassen:

iface eth0 inet manual
iface eth0 inet6 manual

auto br-hooc
iface br-hooc inet dhcp
    bridge_ports eth0

Falls dhcpcd verwendet wird, sollte in der Datei /etc/dhcpcd.conf folgende Anpassungen gemacht werden:

denyinterfaces eth0
interface br-hooc

Mittels Neustart des Geräts oder der Netzwerkschnittstellen wird die persistente Konfiguration übernommen. Danach kann mittels Kommando

docker run \
    --name hooc-connect \
    --detach \
    --device /dev/net/tun \
    --cap-add NET_ADMIN \
    --network host \
    --restart unless-stopped \
    hooc/connect-12345678901234567890:0.2.0 \
    --vpn.linux.bridge=br-hooc

der HOOC Embedded Gateway als Daemon gestartet werden. Dieser wird automatisch beim Starten von Docker gestartet.

Die obenstehende Konfiguration ist nur ein Beispiel für eine Konfiguration. Diese muss je nach Betriebssystem und Version individuell angepasst werden.