Descripción general

Ver el código fuente en GitHub

El router de borde de OpenThread (OTBR) proporciona compatibilidad con Docker y se puede ejecutar en un contenedor de Docker en lugar de directamente en tu máquina local.

Esta guía se centra en la ejecución de Docker OTBR en Raspberry Pi (RPi) o en cualquier máquina basada en Linux, y solo se probó en esas plataformas.

Configuración de Raspberry Pi

Instala el SO Raspberry Pi con el SO de computadoras en la RPi. Sigue las instrucciones del paso Descarga e instala el SO de la Descripción general de Raspberry Pi, pero asegúrate de usar el SO de Raspberry Pi con computadoras de escritorio como el SO.

Una vez instalada, inicia la RPi y abre una ventana de la terminal.

  1. Actualiza el sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instala Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Si deseas usar Docker como un servicio no raíz, sin requerir sudo antes de cada comando, modifica la configuración de usuario. Sal de tu cuenta para que se apliquen los cambios:

    sudo usermod -aG docker $USER
    

  4. Inicia Docker si aún no se está ejecutando:

    sudo dockerd
    

  5. Instala Git:

    sudo apt install git
    
    .

  6. Las secuencias de comandos de firewall de OTBR crean reglas dentro del contenedor de Docker. Ejecuta modprobe para cargar los módulos de kernel para iptables:

    sudo modprobe ip6table_filter
    

Configuración en Linux

Usa las mismas instrucciones que en la RPi:

  1. Actualiza el sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instala Docker:

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

  3. Si deseas usar Docker como un servicio no raíz, sin requerir sudo antes de cada comando, modifica la configuración de usuario. Sal de tu cuenta para que se apliquen los cambios:

    sudo usermod -aG docker $USER
    

  4. Inicia Docker si aún no se está ejecutando:

    sudo dockerd
    

  5. Instala Git:

    sudo apt install git
    
    .

  6. Las secuencias de comandos de firewall de OTBR crean reglas dentro del contenedor de Docker. Ejecuta modprobe para cargar los módulos de kernel para iptables:

    sudo modprobe ip6table_filter
    

Mac o Windows

Para usar Docker OTBR en Mac o Windows, instala la caja de herramientas de Docker. Esto es necesario, ya que ejecutar OTBR Docker implica la activación de puertos en serie virtuales, que solo es compatible con la caja de herramientas de Docker en esos sistemas.

Obtén la imagen de Docker de OTBR

Obtén la imagen de Docker de OTBR. Para ello, extrae la imagen directamente desde OpenThread Docker Hub o clona el repositorio de OTBR y compila el Dockerfile incluido de manera local.

Recomendamos extraer la imagen de Docker Hub, ya que el equipo de OpenThread la probó y verificó.

Extrae la imagen de Docker Hub

Esta imagen corresponde al ID de confirmación e80def4.

  1. Extrae la imagen:

    docker pull openthread/otbr:latest
    

  2. Ahora debería aparecer en tu lista de imágenes de Docker:

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

Compila el Dockerfile

Para crear la imagen tú mismo, clona el repositorio del router de borde de OpenThread y compila el Dockerfile incluido.

  1. Clona el repositorio OTBR:

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

  2. Compila el Dockerfile:

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