Panoramica

Visualizza il codice sorgente 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 è incentrata sull'esecuzione di OTBR Docker su Raspberry Pi (RPi) o su qualsiasi macchina basata su Linux ed è stata testata solo su queste piattaforme.

Configurazione di Raspberry Pi

Installa il sistema operativo Raspberry Pi con desktop sull'RPi. Segui le istruzioni nel passaggio Scarica e installa il sistema operativo della panoramica di Raspberry Pi, ma assicurati di utilizzare il sistema operativo di Raspberry Pi con desktop come sistema operativo.

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 rendere effettive 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

Usa le stesse istruzioni delle pagine protette:

  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 rendere effettive 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. Questa operazione è necessaria perché l'esecuzione di OTBR Docker prevede il montaggio di porte seriali virtuali, che sono supportate solo da Docker Toolkit su questi sistemi.

Ottieni l'immagine Docker OTBR

Per ottenere l'immagine Docker OTBR, puoi estrarla direttamente da OpenThread Docker Hub oppure clonare il repository OTBR e creare localmente il Dockerfile incluso.

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

Esegui il pull dell'immagine da Docker Hub

Questa immagine è aggiornata con l'ID commit e80def4.

  1. Esegui il pull dell'immagine:

    docker pull openthread/otbr:latest
    

  2. A questo punto dovrebbe apparire nell'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 personalmente, 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 .