Présentation

Afficher le code source sur GitHub

Le routeur de bordure OpenThread (OTBR) est compatible avec Docker et peut être exécuté dans un conteneur Docker plutôt que directement sur votre ordinateur local.

Ce guide est consacré à l'exécution de OTBR Docker sur le Raspberry Pi (RPi) ou toute machine Linux. Il n'a été testé que sur ces plates-formes.

Configuration de Raspberry Pi

Installez le système d'exploitation Raspberry Pi OS with Desktop sur le RPi. Suivez les instructions de l'étape Télécharger et installer le système d'exploitation de la présentation de Raspberry Pi, mais assurez-vous d'utiliser Raspberry Pi OS avec votre ordinateur. Vous ne pouvez pas utiliser la version Lite, car vous devez accéder à l'IUG Web d'OTBR dans un navigateur Web.

Une fois l'API installée, démarrez-la et ouvrez une fenêtre de terminal.

  1. Mettez à jour le système :

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installez Docker :

    curl -sSL https://get.docker.com | sh
    
  3. Si vous souhaitez utiliser Docker en tant qu'utilisateur non racine, sans avoir besoin de sudo avant chaque commande, modifiez vos paramètres utilisateur. Déconnectez-vous pour que les modifications prennent effet :

    sudo usermod -aG docker $USER
    

  4. Démarrez Docker s'il n'est pas déjà en cours d'exécution :

    sudo dockerd
    

  5. Installez git :

    sudo apt install git
    

  6. Les scripts de pare-feu OTBR créent des règles dans le conteneur Docker. Exécutez modprobe pour charger les modules du noyau pour iptables :

    sudo modprobe ip6table_filter
    

Configuration Linux

Suivez les mêmes instructions que pour l'RPi:

  1. Mettez à jour le système :

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Installez Docker :

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

  3. Si vous souhaitez utiliser Docker en tant qu'utilisateur non racine, sans avoir besoin de sudo avant chaque commande, modifiez vos paramètres utilisateur. Déconnectez-vous pour que les modifications prennent effet :

    sudo usermod -aG docker $USER
    

  4. Démarrez Docker s'il n'est pas déjà en cours d'exécution :

    sudo dockerd
    

  5. Installez git :

    sudo apt install git
    

  6. Les scripts de pare-feu OTBR créent des règles dans le conteneur Docker. Exécutez modprobe pour charger les modules du noyau pour iptables :

    sudo modprobe ip6table_filter
    

Mac ou Windows

Pour utiliser Docker OTBR sur Mac ou Windows, installez la boîte à outils Docker. Cette étape est nécessaire, car l'exécution de OTBR Docker implique l'installation de ports série virtuels, qui ne sont compatibles qu'avec la boîte à outils Docker sur ces systèmes.

Obtenir l'image Docker OTBR

Récupérez l'image Docker OTBR en la récupérant directement à partir du hub Docker OpenThread ou en clonant le dépôt OTBR et en créant localement le Dockerfile inclus.

Nous vous recommandons d'extraire l'image de Docker Hub, car il a été testé et validé par l'équipe OpenThread.

Extraire l'image de Docker Hub

Cette image est associée à l'ID de commit e80def4.

  1. Extrayez l'image :

    docker pull openthread/otbr:latest
    

  2. Il devrait maintenant apparaître dans votre liste d'images Docker :

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

Créer le Dockerfile

Pour créer l'image vous-même, clonez le dépôt du routeur de bordure OpenThread et compilez le Dockerfile inclus.

  1. Clonez le dépôt OTBR :

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

  2. Créez le Dockerfile :

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