Visão geral

Veja o código-fonte no GitHub

O roteador de borda do OpenThread (OTBR) oferece suporte ao Docker e pode ser executado em um contêiner do Docker em vez de diretamente na máquina local.

O foco deste guia é a execução do Docker do OTBR no Raspberry Pi (RPi) ou em qualquer máquina baseada em Linux, e foi testado apenas nessas plataformas.

Configuração do Raspberry Pi

Instale o SO Raspberry Pi com computador na RPi. Siga as instruções na etapa Fazer o download e instalar o SO da Visão geral do Raspberry Pi, mas use o SO Raspberry Pi com computador como o SO.

Após a instalação, inicialize a RPi e abra uma janela de terminal.

  1. Atualize o sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instale o Docker:

    curl -sSL https://get.docker.com | sh
    
  3. Se você quiser usar o Docker como não raiz, sem exigir sudo antes de cada comando, modifique as configurações de usuário. Saia da conta para que as mudanças entrem em vigor:

    sudo usermod -aG docker $USER
    

  4. Inicie o Docker se ele ainda não estiver em execução:

    sudo dockerd
    

  5. Instale o git:

    sudo apt install git
    

  6. Os scripts de firewall OTBR criam regras dentro do contêiner do Docker. Execute modprobe para carregar os módulos do kernel para iptables:

    sudo modprobe ip6table_filter
    

Configuração do Linux

Use as mesmas instruções da RPi:

  1. Atualize o sistema:

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Instale o Docker:

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

  3. Se você quiser usar o Docker como não raiz, sem exigir sudo antes de cada comando, modifique as configurações de usuário. Saia da conta para que as mudanças entrem em vigor:

    sudo usermod -aG docker $USER
    

  4. Inicie o Docker se ele ainda não estiver em execução:

    sudo dockerd
    

  5. Instale o git:

    sudo apt install git
    

  6. Os scripts de firewall OTBR criam regras dentro do contêiner do Docker. Execute modprobe para carregar os módulos do kernel para iptables:

    sudo modprobe ip6table_filter
    

Mac ou Windows

Para usar o Docker do OTBR no Mac ou Windows, instale o Docker Toolbox. Isso é necessário porque a execução do Docker OTBR envolve a montagem de portas seriais virtuais, que é compatível apenas com o Docker Toolbox nesses sistemas.

Acessar a imagem Docker do OTBR

Receba a imagem do Docker do OTBR extraindo-a diretamente do Docker Hub do OpenThread (em inglês) ou clonando o repositório do OTBR e criando localmente o Dockerfile incluído.

Recomendamos extrair a imagem do Docker Hub, já que ela foi testada e verificada pela equipe do OpenThread.

Extrair a imagem do Docker Hub

Esta imagem é de acordo com o ID de commit e80def4.

  1. Extraia a imagem:

    docker pull openthread/otbr:latest
    

  2. Ela aparecerá na lista de imagens do Docker:

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

Crie o Dockerfile

Para criar a imagem, clone o repositório do roteador de borda do OpenThread e crie o Dockerfile incluído.

  1. Clone o repositório OTBR:

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

  2. Crie o Dockerfile:

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