Skip to content

Latest commit

 

History

History
149 lines (99 loc) · 9.1 KB

build_source.md

File metadata and controls

149 lines (99 loc) · 9.1 KB
Raw

ソースからのビルド

Orion Context Broker のリファレンス配布は Debian 12 です。これは、broker を他のディストリビューションに組み込むことができないことを意味しません (実際には可能です)。このセクションには、Debian を使用していない人に役立つ可能性があるため、他のディストリビューションに組み込む方法に関する指示が含まれる場合があります。ただし、"公式にサポートされている" 唯一の手順は Debian 12 用の手順です。

公式以外のディストリビューションで Docker コンテナ・イメージをビルドする方法は、Docker ドキュメントの 3.1 非公式ディストリビューションでのビルド・セクションで確認できます。

Debian 12 (正式サポート)

Orion Context Broker は、以下のライブラリをビルドの依存関係として使用します :

  • boost: 1.74
  • libmicrohttpd: 0.9.76 (ソースから)
  • libcurl: 7.88.1
  • openssl: 3.0.9
  • libuuid: 2.38.1
  • libmosquitto: 2.0.15 (ソースから)
  • Mongo C driver: 1.24.3 (ソースから)
  • rapidjson: 1.1.0 (ソースから)
  • gtest (make unit_test ビルディング・ターゲットのみ) : 1.5 (ソースから)
  • gmock (make unit_test ビルディング・ターゲットのみ) : 1.5 (ソースから)

基本的な手順は次のとおりです (root 権限でコマンドを実行しないと仮定し、root 権限が必要なコマンドに sudo を使用します) :

  • 必要なビルドツール (コンパイラなど) をインストールします

      sudo apt-get install make cmake g++

  • 必要なライブラリをインストールします (次の手順で説明する、ソースから取得する必要があるものを除きます)

      sudo apt-get install libssl-dev libcurl4-openssl-dev libboost-dev libboost-regex-dev libboost-filesystem-dev libboost-thread-dev uuid-dev libgnutls28-dev libsasl2-dev libgcrypt-dev

  • ソースから Mongo Driver をインストールします

      wget https://github.com/mongodb/mongo-c-driver/releases/download/1.24.3/mongo-c-driver-1.24.3.tar.gz
  tar xfvz mongo-c-driver-1.24.3.tar.gz
  cd mongo-c-driver-1.24.3
  mkdir cmake-build
  cd cmake-build
  cmake -DENABLE_AUTOMATIC_INIT_AND_CLEANUP=OFF ..
  make
  sudo make install

  • ソースから rapidjson をインストールする :

      wget https://github.com/miloyip/rapidjson/archive/v1.1.0.tar.gz
  tar xfvz v1.1.0.tar.gz
  sudo mv rapidjson-1.1.0/include/rapidjson/ /usr/local/include

  • ソースから libmicrohttpd をインストールします (./configure 下のコマンドはライブラリの最小限のフットプリントを得るための推奨ビルド設定を示していますが、上級ユーザの方は好きなように設定できます)

      wget https://ftp.gnu.org/gnu/libmicrohttpd/libmicrohttpd-0.9.76.tar.gz
  tar xvf libmicrohttpd-0.9.76.tar.gz
  cd libmicrohttpd-0.9.76
  ./configure --disable-messages --disable-postprocessor --disable-dauth
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

  • ソースから mosquitto をインストールします (WITH_CJSON, WITH_STATIC_LIBRARIES, WITH_SHARED_LIBRARIES の設定を変更することで、mosquitto-2.0.15/ の下の config.mk ファイルを変更してビルドを微調整できます)

      wget https://mosquitto.org/files/source/mosquitto-2.0.15.tar.gz
  tar xvf mosquitto-2.0.15.tar.gz
  cd mosquitto-2.0.15
  sed -i 's/WITH_CJSON:=yes/WITH_CJSON:=no/g' config.mk
  sed -i 's/WITH_STATIC_LIBRARIES:=no/WITH_STATIC_LIBRARIES:=yes/g' config.mk
  sed -i 's/WITH_SHARED_LIBRARIES:=yes/WITH_SHARED_LIBRARIES:=no/g' config.mk
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # Update /etc/ld.so.cache with the new library files in /usr/local/lib

  • コードを取得します (または、圧縮されたバージョンや別の URL パターンを使用してダウンロードできます。例えば、git clone [email protected]:telefonicaid/fiware-orion.git) :

      sudo apt-get install git
  git clone https://github.com/telefonicaid/fiware-orion

  • ソースをビルドします :

      cd fiware-orion
  make

  • (オプションですが強く推奨されます) 単体テストと機能テストを実行します。 これについては、以下の特定のセクションで詳しく説明します。

  • バイナリをインストールします。INSTALL_DIR を使用して、インストール・プレフィックス・パス (デフォルトは /usr) を設定することができます。したがって、broker は $INSTALL_DIR/bin ディレクトリにインストールされます

      sudo make install INSTALL_DIR=/usr

  • broker のバージョン・メッセージを呼び出す、すべてが正常であることを確認してください :

      contextBroker --version

テストとカバレッジ

Orion Context Broker には、次の手順に従って実行できる一連のユニット・テスト, valgrind, およびエンドツーエンドのテストが付属しています (オプションですが、強くお勧めします):

  • ソースから GoogleTest/Mock をインストールします。以前の URL は http://googlemock.googlecode.com/files/gmock-1.5.0.tar.bz2 でしたが、Google は2016年8月下旬にそのパッケージを削除し、機能しなくなりました。

      wget https://nexus.lab.fiware.org/repository/raw/public/storage/gmock-1.5.0.tar.bz2
  tar xfvj gmock-1.5.0.tar.bz2
  cd gmock-1.5.0
  ./configure
  # システム内の fiware-orion リポジトリのローカル・コピーの場所に応じて、次の行の /path/to/fiware-orion を調整します。
  patch -p1 gtest/scripts/fuse_gtest_files.py < /path/to/fiware-orion/test/unittests/fuse_gtest_files.py.patch
  make
  sudo make install  # installation puts .h files in /usr/local/include and library in /usr/local/lib
  sudo ldconfig      # just in case... it doesn't hurt :)

aarch64 アーキテクチャの場合、apt-get を使用して libxslt をインストールし、--build=arm-linux オプションを指定して /configure を実行します。

  • MongoDB をインストールします (テストはローカルホストで実行されている mongod に依存します)。 詳細については、MongoDB の公式ドキュメントを確認してください。推奨バージョンは 6.0 です (以前のバージョンでも動作する可能性がありますが、お勧めしません)。

  • ユニット・テストを実行します

      make unit_test

  • 機能テストと valgrind テストに必要な追加のツールをインストールします:

      sudo apt-get install curl netcat-traditional valgrind bc python3 python3-pip mosquitto

  • テスト・ハーネスのための環境を準備します。基本的には、accumulator-server.py スクリプトをコントロールの下にあるパスにインストールしなければならず、~/bin が推奨です。また、/usr/bin のようなシステム・ディレクトリにインストールすることもできますが、他のプログラムと衝突する可能性がありますので、お勧めしません。さらに、ハーネス・スクリプト (scripts/testEnv.sh ファイル参照) で使用されるいくつかの環境変数を設定し、必要な Python パッケージを使用して virtualenv 環境を作成します。

      mkdir ~/bin
  export PATH=~/bin:$PATH
  make install_scripts INSTALL_DIR=~
  . scripts/testEnv.sh
  python3 -m venv /opt/ft_env   # or 'virtualenv /opt/ft_env --python=/usr/bin/python3' in some systems
  . /opt/ft_env/bin/activate
  pip install Flask==2.0.2 Werkzeug==2.0.2 paho-mqtt==1.6.1 amqtt==0.11.0b1

  • この環境でテスト・ハーネスを実行してください (時間がかかりますので、気をつけてください)

      make functional_test INSTALL_DIR=~

  • すべての機能テストに合格したら、valgrind テストを実行できます (これは機能テストよりも時間がかかります) :

      make valgrind INSTALL_DIR=~

次の手順を使用して、Orion Context Broker のカバレッジレポートを生成できます (オプション) :

  • lcov ツールをインストールします

      sudo apt-get install lcov xsltproc

  • まず、unit_test と functional_test の成功パスを実行して、すべてが正常であることを確認します (上記参照)

  • カバレッジを実行します

      make coverage INSTALL_DIR=~