概要

GitHub のソースを表示

OpenThread Border Router(OTBR)は Docker をサポートし、ローカルマシンで直接実行するのではなく、Docker コンテナで実行できます。

このガイドでは、Raspberry Pi(RPi)または Linux ベースのマシンでの OTBR Docker の実行に焦点を当てており、これらのプラットフォームでのみテストされています。

Raspberry Pi のセットアップ

RPi に Raspberry Pi OS with Desktop OS をインストールします。Raspberry Pi の概要の OS をダウンロードしてインストールするのステップに従いますが、OS として Raspberry Pi OS with Desktop を使用してください。

インストールが完了したら、RPi を起動してターミナル ウィンドウを開きます。

  1. システムを更新します。

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Docker をインストールします。

    curl -sSL https://get.docker.com | sh
    
  3. Docker を root 以外として使用する場合は、各コマンドの前に sudo を実行せずに、ユーザー設定を変更します。変更を反映するには、ログアウトします。

    sudo usermod -aG docker $USER
    

  4. Docker をまだ実行していない場合は、起動します。

    sudo dockerd
    

  5. git をインストールします。

    sudo apt install git
    

  6. OTBR ファイアウォール スクリプトは、Docker コンテナ内にルールを作成します。modprobe を実行して、iptables のカーネル モジュールを読み込みます。

    sudo modprobe ip6table_filter
    

Linux の設定

RPi と同じ手順を使用します。

  1. システムを更新します。

    sudo apt-get update
    sudo apt-get upgrade
    

  2. Docker をインストールします。

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

  3. Docker を root 以外として使用する場合は、各コマンドの前に sudo を実行せずに、ユーザー設定を変更します。変更を反映するには、ログアウトします。

    sudo usermod -aG docker $USER
    

  4. Docker をまだ実行していない場合は、起動します。

    sudo dockerd
    

  5. git をインストールします。

    sudo apt install git
    

  6. OTBR ファイアウォール スクリプトは、Docker コンテナ内にルールを作成します。modprobe を実行して、iptables のカーネル モジュールを読み込みます。

    sudo modprobe ip6table_filter
    

Mac または Windows

Mac または Windows で OTBR Docker を使用するには、Docker Toolbox をインストールします。OTBR Docker の実行には仮想シリアルポートのマウントが伴うため、この操作が必要になります。仮想シリアルポートは、これらのシステムの Docker Toolbox でのみサポートされています。

OTBR Docker イメージを取得する

OTBR Docker イメージを取得するには、OpenThread Docker Hub から直接 pull するか、OTBR リポジトリのクローンを作成して、含まれている Dockerfile をローカルでビルドします。

イメージは OpenThread チームによってテストおよび検証されているため、Docker Hub から pull することをおすすめします。

Docker Hub からイメージを pull する

このイメージの時点の commit ID は e80def4 です。

  1. イメージを pull します。

    docker pull openthread/otbr:latest
    

  2. Docker イメージのリストに次のように表示されます。

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

Dockerfile をビルドする

イメージを手動で作成するには、OpenThread Border Router リポジトリのクローンを作成し、付属の Dockerfile をビルドします。

  1. OTBR リポジトリのクローンを作成します。

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

  2. Dockerfile をビルドします。

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