Descripción general

Ver el código fuente en GitHub

El router de borde de OpenThread (OTBR) es compatible con Docker y puede ejecutarse en un contenedor de Docker, en lugar de hacerlo directamente en la máquina local.

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

Configuración de Raspberry Pi

Instala el SO Raspberry Pi con Computadoras en la RPi. Sigue las instrucciones del artículo Descarga e instala el OS de Descripción general de Raspberry Pi, pero asegúrate de usar Raspberry Pi OS con Computadora 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 solicitar sudo antes de cada uno , modifica la configuración de usuario. Sal 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 solicitar sudo antes de cada uno , modifica la configuración de usuario. Sal 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 utilizar OTBR Docker en Mac o Windows, instala Docker Caja de herramientas. Esto es obligatorio cuando se ejecuta OTBR Docker implica la activación de puertos en serie virtuales, que solo es compatible con Docker. Caja de herramientas en esos sistemas.

Obtén la imagen de Docker de OTBR

Para obtener la imagen de Docker de OTBR, extráela directamente del docker de OpenThread Hub o clonando el repositorio de OTBR y compilar el Dockerfile incluido de manera local.

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

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 para compilar 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 .