Présentation

Afficher le code source sur GitHub

Le routeur de bordure OpenThread (OTBR) prend en charge Docker et peut être exécuté dans un conteneur Docker plutôt que directement sur votre machine locale.

Ce guide se concentre sur l'exécution d'OTBR Docker sur le Raspberry Pi (RPi) ou sur toute machine Linux, et n'a été testé que sur ces plates-formes.

Configuration de Raspberry Pi

Installez l'OS Raspberry Pi avec Desktop sur le RPi. Suivez les instructions de l'étape Télécharger et installer l'OS de la présentation de Raspberry Pi, mais veillez à utiliser l'OS Raspberry Pi avec Desktop.

Une fois installé, démarrez le RPi 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 soient prises en compte :

    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 de Linux

Suivez les mêmes instructions que pour le tiers assujetti à des restrictions:

  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 soient prises en compte :

    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 OTBR Docker sous Mac ou Windows, installez Docker Toolbox. Cela est nécessaire, car l'exécution de Docker OTBR implique l'installation de ports série virtuels, qui n'est compatible qu'avec la boîte à outils Docker sur ces systèmes.

Obtenir l'image Docker OTBR

Récupérez l'image Docker OTBR en l'extrayant directement à partir du Docker Hub OpenThread, ou en clonant le dépôt OTBR et en créant localement le fichier Dockerfile inclus.

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

Extraire l'image de Docker Hub

Cette image correspond à 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 créez 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 fichier Dockerfile :

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