Panoramica

Visualizza l'origine su GitHub

Il router di confine OpenThread (OTBR) fornisce supporto Docker e può essere eseguito in un container Docker anziché direttamente sulla tua macchina locale.

Questa guida si concentra sull'esecuzione di Docker di OTBR su Raspberry Pi (RPi) o su qualsiasi macchina basata su Linux ed è stata testata solo su tali piattaforme.

Configurazione Raspberry Pi

Installa il sistema operativo Raspberry Pi OS with Desktop su RPi. Segui le istruzioni nel passaggio Scarica e installa il sistema operativo della Panoramica di Raspberry Pi, ma assicurati di utilizzare Raspberry Pi OS con Desktop come sistema operativo. Non puoi utilizzare la versione Lite, poiché devi accedere alla GUI web di OTBR in un browser web.

Al termine dell'installazione, avvia RPi e apri una finestra del terminale.

  1. Aggiorna il sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installa Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Se vuoi utilizzare Docker come non root, senza richiedere sudo prima di ogni comando, modifica le impostazioni utente. Esci per applicare le modifiche:

    sudo usermod -aG docker $USER
    

  4. Avvia Docker se non è già in esecuzione:

    sudo dockerd
    

  5. Installa git:

    sudo apt install git
    

  6. Gli script firewall OTBR creano regole all'interno del container Docker. Esegui modprobe per caricare i moduli kernel per iptables:

    sudo modprobe ip6table_filter
    

Configurazione Linux

Utilizza le stesse istruzioni fornite nell'RPI:

  1. Aggiorna il sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installa Docker:

    curl -sSL https://get.docker.com | sh
    

  3. Se vuoi utilizzare Docker come non root, senza richiedere sudo prima di ogni comando, modifica le impostazioni utente. Esci per applicare le modifiche:

    sudo usermod -aG docker $USER
    

  4. Avvia Docker se non è già in esecuzione:

    sudo dockerd
    

  5. Installa git:

    sudo apt install git
    

  6. Gli script firewall OTBR creano regole all'interno del container Docker. Esegui modprobe per caricare i moduli kernel per iptables:

    sudo modprobe ip6table_filter
    

Mac o Windows

Per utilizzare Docker OTBR su Mac o Windows, installa Docker Toolbox. Questo è necessario perché l'esecuzione di OTBR Docker prevede il montaggio di porte seriali virtuali, supportate solo da Docker Toolbox su questi sistemi.

Scarica l'immagine Docker OTBR

Recupera l'immagine Docker OTBR estraendola direttamente da OpenThread Docker Hub o clonando il repository OTBR e creando localmente il Dockerfile incluso.

Ti consigliamo di eseguire il pull dell'immagine da Docker Hub, in quanto è stata testata e verificata dal team di OpenThread.

Esegui il pull dell'immagine da Docker Hub

Questa immagine risale all'ID commit e80def4.

  1. Esegui il pull dell'immagine:

    docker pull openthread/otbr:latest
    

  2. Ora dovrebbe apparire nel tuo elenco di immagini Docker:

    docker images
    REPOSITORY           TAG          IMAGE ID           CREATED           SIZE
    openthread/otbr      latest       98416559dcbd       2 weeks ago       1.15GB
    

Crea il Dockerfile

Per creare l'immagine autonomamente, clona il repository del router di confine OpenThread e crea il Dockerfile incluso.

  1. Clona il repository OTBR:

    cd ~
    git clone https://github.com/openthread/ot-br-posix
    cd ot-br-posix
    

  2. Crea il Dockerfile:

    docker build --no-cache -t openthread/otbr -f etc/docker/Dockerfile .