目次

...

はじめに

...

ここではiPRO Camera SDKを利用してコンテナアプリを開発する環境を構築する手順を説明します。また、このチュートリアルではSDKのインストールディレクトリを${SDK_DIR}として記載します。

開発で推奨する開発環境

...

サポート対象となる推奨環境は以下となります。

• 開発用OS ：Linux (64bit)

• ディストリビューション ：Ubuntu 22.04 LTS, Ubuntu 20.04以降04 LTS

開発環境構築手順

...

開発者ライセンスの取得

下記より開発者ライセンスを申請し、取得しておいてください。

お問い合わせ・SDKダウンロード - Development Partner Portal (i-pro.com)

Docker環境の準備

開発PCにDocker Engineをインストールします。出典：Docker Engine インストール（Ubuntu 向け） | Docker ドキュメント (matsuand.github.io)

ここでの手順は下記環境にて実施しています。

OS: Ubuntu 22.04.2 LTS (Jammy Jellyfish)

Docker Engineのバージョン: 23.0.1

Dockerをインストールする前に、古いバージョンのアンインストールを行います。

sudo apt-get remove docker docker-engine docker.io containerd runc

Dockerをインストールできるようにするためのアプリをインストールします。

...

Engineをインストールします。Install Docker Engine on Ubuntu に従って、Docker Engineをインストールします。以下はページの概略を記載します。

• 念のため旧パッケージをアンインストールします。
  ただし、アンインストールして問題ないパッケージか事前によくご確認ください。削除したことで問題が発生しても責任は負いかねます。

  Code Block
  for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do sudo apt-get remove $pkg; done

   

• apt-getで使用するDocker用レポジトリを追加します。echoから始まる行は4行まとめてコピペしてください。

  Code Block
  # Add Docker's official GPG key: sudo apt-get update sudo apt-get install ca-certificates curl

...

Dockerの公式GPG鍵を追加します。

...

• sudo install -m 0755 -d /etc/apt/keyrings sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg

...

• -o /etc/apt/keyrings/docker.asc sudo

...

• chmod a+r /etc/apt/keyrings/docker

...

Dockerの安定版リポジトリをセットアップします。

...

• .asc # Add the repository to Apt sources: echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/

...

• etc/

...

• apt/keyrings/docker

...

• .

...

• asc] https://download.docker.com/linux/ubuntu \ $(

...

• . /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

...

Dockerエンジンをインストールします。

...

• sudo apt-get update

...

• 最新のDocker engineをインストールします。

  Code Block
  sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

• Do you want to continue? [Y/n] と聞かれたら Y を入力してEnterキーを押してください。

• インストール後の動作確認です。　

  Code Block
  sudo docker

...

• run

...

...

docker.sockにグループでの書き込み権限を付与します。

sudo chgrp docker /var/run/docker.sock

Dockerが使えるかどうかのテストを行います。

docker run --rm hello-world

以下のように表示されればインストール成功です。

...

• hello-world

  成功した場合の表示例です。

  Code Block

...

sudo systemctl restart docker

• ipro@PC-HP2208N0101R:~$ sudo docker run hello-world Unable to find image 'hello-world:latest' locally latest: Pulling from library/hello-world

...

• c1ec31eb5944: Pull complete

...

• Digest: sha256:

...

• d1b0b5888fbb59111dbf2b3ed698489c41046cb9d6d61743e37ef8d9f3dda06f Status: Downloaded newer image for hello-world:latest

...

• Hello from Docker! This message shows that your installation appears to be working correctly.

...

• To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal.

...

• To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash

...

• Share images, automate workflows, and more with a free Docker ID: https://hub.docker.com/

...

• For more examples and ideas, visit: https://docs.docker.com/get-started/

 成功しなかった場合、下記で成功するか確認してください。

• dockerコマンドはデフォルトではroot権限が必要なので、ユーザー権限でも実行できるように、dockerグループにユーザーを追加します。 公式ドキュメントでは、 Linux post-installation steps for Docker Engine に記載されています。

• dockerユーザーグループを作成します。

  Code Block
  sudo groupadd docker

  groupadd: group 'docker' already exists と表示される場合は、すでにグループが作成されていますので続行します。

• 通常使用するユーザーをdocker groupに追加します。

  Code Block
  sudo usermod -aG docker $USER

   

• 設定を反映します。

  Code Block
  newgrp docker

   

• sudo無でdockerが実施できることを確認します。

  Code Block
  docker run hello-

...

ここでPCを再起動します。（必ず再起動を実施してください。）

...

• world

  成功した場合の表示例です。

  Code Block

  ipro@PC-HP2208N0101R:~$ docker run hello-world Hello from Docker! This message shows that your installation appears to be working correctly. To generate this message, Docker took the following steps: 1. The Docker client contacted the Docker daemon. 2. The Docker daemon pulled the "hello-world" image from the Docker Hub. (amd64) 3. The Docker daemon created a new container from that image which runs the executable that produces the output you are currently reading. 4. The Docker daemon streamed that output to the Docker client, which sent it to your terminal. To try something more ambitious, you can run an Ubuntu container with: $ docker run -it ubuntu bash Share images, automate workflows, and more with a free Docker ID: https://hub.docker.com/ For more examples and ideas, visit: https://docs.docker.com/get-started/

   

• systemdの設定を変更して、起動時にDockerサービスが自動起動する設定を行います。

  Code Block
  sudo systemctl enable docker.service sudo systemctl enable containerd.service

   

• 起動時にdockerサービスが起動するかどうか確認するために一度Ubuntuを再起動します。 WSLではubuntuの端末で再起動はできません。 いったん×ボタンでウィンドウを終了させた後、powershellを起動して以下を入力します。

  Code Block
  wsl --shutdown

   

• その後スタートメニューから改めてUbuntu 22.04 LTSを起動します。
  

• 以下のコマンドを入力し、正しくバージョン番号が表示されれば成功です。

  Code Block
  docker version

  成功したときの表示例です。

  Code Block

  ipro@PC-HP2208N0101R:~$ docker version Client: Docker Engine - Community Version: 26.1.4 API version: 1.45 Go version: go1.21.11 Git commit: 5650f9b Built: Wed Jun 5 11:28:57 2024 OS/Arch: linux/amd64 Context: default Server: Docker Engine - Community Engine: Version: 26.1.4 API version: 1.45 (minimum version 1.24) Go version: go1.21.11 Git commit: de5c9cf Built: Wed Jun 5 11:28:57 2024 OS/Arch: linux/amd64 Experimental: false containerd: Version: 1.6.33 GitCommit: d2d58213f83a351ca8f528a95fbd145f5654e957 runc: Version: 1.1.12 GitCommit: v1.1.12-0-g51d5e94 docker-init: Version: 0.19.0 GitCommit: de40ad0

プロキシサーバー経由で接続している場合

Dockerをプロキシサーバー経由でインターネットにアクセスさせる手順を実施します。プロキシサーバーを使用していない場合は、実施する必要はありません。

• Dockerクライアントの設定ファイルを作成して以下のように記載します。

  Code Block
  vi ~/.docker/config.json

  記載する内容は以下です。

  Code Block
  { "proxies": { "default": { "httpProxy": "http://[プロキシサーバーのIPアドレス:ポート]", "httpsProxy": "http://[プロキシサーバーのIPアドレス:ポート]" } } }

  特定のIPアドレスだけをプロキシなしで接続したい場合は”noProxy”で設定できます。詳細は プロキシサーバを使うように Docker を設定 — Docker-docs-ja 24.0 ドキュメント をご覧ください。

• ファイルを保存します。

qemuインストール

コンテナ版追加アプリを作成するために、開発環境にインストールする必要のある、qemuのインストール方法を記載します。

qemuのインストール

sudo apt update
sudo apt-get install qemu binfmt-support qemu-user-static # Install the qemu packages
sudo docker run --rm --privileged multiarch/qemu-user-static --reset -p yes # This step will execute the registering scripts

docker buildxの準備

• experimental 機能や BuildKit を使うため、環境変数を追加設定 & 反映 します。

• 設定ファイルを開きます。

  Code Block
  vi ~/.bashrc

• 以下を末尾に追加

  Code Block
  export DOCKER_CLI_EXPERIMENTAL=enabled export DOCKER_BUILDKIT=1

  保存します。

• buildxが使えるようになっているか確認します。

  Code Block
  docker --help | grep buildx

  出力例

  Code Block
  buildx* Docker Buildx (Docker Inc., v0.10.5)

   

• 現在build可能なアーキテクチャを確認します。

  Code Block
  docker buildx ls

  出力例

  Code Block
  NAME/NODE DRIVER/ENDPOINT STATUS BUILDKIT PLATFORMS default * docker default default running v0.11.7-0.20230525183624-798ad6b0ce9f linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/amd64/v4, linux/386, linux/arm64, linux/riscv64, linux/ppc64, linux/ppc64le, linux/s390x, linux/mips64le, linux/mips64, linux/arm/v7, linux/arm/v6

  この出力の中に linux/arm64 があれば成功です。

開発環境構築のチェック

環境構築ができたかどうかのチェックを行います。 ※結果は一例ですので、環境によって異なります。

• Docker Engineがインストール済みであること

  Code Block
  $ docker --version Docker version 23.0.1, build cb74dfc

  インストール出来ていない場合はDocker Engineをインストールしてください。

• Dockerデーモンが起動中であること
  【systemdを使用している場合】

  Code Block

  $ systemctl status docker ● docker.service - Docker Application Container Engine Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled) Active: active (running) since Wed 2023-06-28 08:41:48 JST; 5h 6min ago TriggeredBy: ● docker.socket Docs: https://docs.docker.com Main PID: 1051 (dockerd) Tasks: 24 Memory: 199.9M CPU: 5.471s CGroup: /system.slice/docker.service └─1051 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock (以下略)

  Activeが inactive (dead) になっている場合は、systemctl start docker コマンドでサービスを起動してください。

  【SysVinitを使用している場合】

  Code Block$ sudo /etc/init.d/

  docker

  status * Docker is running

  not running と表示される場合は sudo /etc/init.d/docker start コマンドでサービスを起動してください。
  

• docker buildxがインストールされていること

  Code Block
  $ docker --help | grep buildx buildx* Docker Buildx (Docker Inc., v0.10.5)

  何も表示されていない場合は、 Docker Buildx に従って個別にインストールしてください。
  

• qemuがインストールされ、Arm64ビットアプリがクロスビルド可能になっていること
  以下のリストの中に linux/arm64 があることを確認してください。

  Code Block
  $ docker buildx ls default * docker default default running v0.11.7-0.20230525183624-798ad6b0ce9f linux/amd64, linux/amd64/v2, linux/amd64/v3, linux/amd64/v4, linux/arm64, linux/riscv64, linux/ppc64, linux/ppc64le, linux/s390x, linux/386, linux/mips64le, linux/mips64, linux/arm/v7, linux/arm/v6

  linux/arm64 がない場合は、qemuをインストールしてください。

カメラファームウェアの更新

...

ダウンロード一覧 (i-pro.com)

Docker拡張モジュールのインストール

下記よりDocker拡張モジュールをダウンロードし、インストールしてください。旧バージョンがインストールされている場合はアップデートされます。下記よりDocker拡張モジュールをダウンロードし、インストールしてください。Container AdamApp for Azure IoT Edgeのみに対応した古いDocker拡張モジュールがインストールされている場合はアップデートされます。

i-PRO Docker®拡張モジュール | i-PRO Products

下記の赤枠画面よりインストールしてください。緑枠のように表示されれば成功です。

...

Container AdamApp for Azure IoT Edgeのみに対応した古いDocker拡張モジュールでクラウド対応をONにしている場合はOFFにする必要があります。

以下のURLでカメラ(IPアドレスが192.168.0.10の場合)にアクセスします。

...

クラウド対応が「On」になっている場合は「Off」に変更して「設定」を押します。

...

Azureログイン

★吉村さん確認、ID/passはどのように提供するか？★

★docker拡張モジュールは英語サイトはどのように提供するか？★

SDK ver.2.01以前からSDK ver.2.10以降への開発環境移行手順

★以降手順記載する。★

ビルド手順

開発者ライセンスの利用

既に開発者ライセンス（development.key）を申請し取得していると思いますので、SDK/confフォルダに配置しておいてください。

...

サンプルアプリのビルド

ここでは例としてサンプルアプリをビルドする手順を実施します。

${SDK_DIR}に移動します。

cd ${SDK_DIR}

setup_env.shでContainerAdamApp専用のオプションを新たに追加します。

source setup_env.sh ambaCV5XCEX

その後、以下のシェルスクリプトでextファイルがビルドされます。

./ext_docker_build.sh [サンプルアプリのディレクトリ]

例えば、C版のskeleton_sample_appであれば下記のようにビルドします。(Python版も同様ですので省略します)

./ext_docker_build.sh src/adamapp/skeleton_sample_app

ビルドが成功すると、サンプルアプリのディレクトリ内に以下の二つのファイルが生成される。

• [アプリ名]_[バージョン名].ext

• [アプリ名]_[バージョン名].zip

アプリ名およびバージョン名はdocker_compose.yamlの上から一番最初に見つかった imageの値から取得しています。例えば image: “skeleton_sample_app:0.0.6” と記載してあれば、ファイル名はskeleton_sample_app_0.0.6.ext (zip)となります。

動作確認

カメラにインストールします(例：下記画像の緑枠からインストール可能)。作成した.extファイルを選択してインストールしてください。
アプリ画面を開きます(下記画像の赤枠ボタン)。

...

下記画像のような、文字列が表示されていれば成功です。

...