開発の基本的な流れ

Armadillo-IoT ゲートウェイ A6EではCON7 (USBコンソールインターフェース)をシリアルコンソールとして使用できます。シリアル通信設定等については、「シリアル通信ソフトウェア(minicom)の使用」を参照してください。

ログイン方法については、「ログイン」を参照してください。

Armadillo-IoT ゲートウェイ A6E にはopensshがインストールされていますが、デフォルトではSSHサーバーが起動していません。

SSHサーバーを自動的に起動するようにするためには、以下のコマンドを実行してください。

[armadillo:~]# rc-update add sshd
 * service sshd added to runlevel default
[armadillo ~]# persist_file /etc/runlevels/default/sshd
[ 2819.277066] EXT4-fs (mmcblk0p1): re-mounted. Opts: (null)
[armadillo ~]# reboot

上記の例では、再起動後も設定が反映されるように、 persist_file コマンドでeMMCに設定を保存しています。

	Cat.1 モデルは、初期状態では LTE ネットワーク経由の ssh が使用できません。「Cat.1 モデル搭載 ELS31-J ファイアーウォール設定 (Cat.1 モデル)」 を参考にファイアーウォール設定を変更後ご利用ください。

Armadillo-IoT ゲートウェイ A6E には、ゲートウェイコンテナがプリインストールされています。 このコンテナを利用することで、インターフェースの操作やクラウドへのデータアップロードなどを簡単に行うことができます。

ゲートウェイコンテナを利用して実施できる内容は下記の通りです。

インターフェースやクラウドサービスの選択はコンフィグ設定で行う事ができます。 また、センサーデータのログ出力やネットワーク断時のキャッシュ機能にも対応しています。

利用方法や仕様については、「ゲートウェイコンテナを動かす」 を参照してください。

ゲートウェイアプリケーション開発ではゲートウェイコンテナを利用します。 以下のパターンに分類されます。

9.4.1.3. ゲートウェイコンテナイメージを改変する

基本的に、アットマークテクノではゲートウェイコンテナイメージの改変を推奨しておりません。もし改変を行う場合、以下の手順に沿って、対応することができます。 なお、手順中のコマンドで指定するコンテナ名は a6e-gw-container となります。

	ただし、ゲートウェイコンテナイメージの改変を行った場合、今後アットマークテクノが提供するゲートウェイコンテナのアップデートを そのまま適用することが出来なくなります。そのため、「ゲートウェイコンテナを拡張する」 に記載している方法をお勧めいたします。

1. 「PodmanのデータをeMMCに保存する」 を実行

   このとき、起動しているコンテナがある場合は podman stop コマンドで停止します。(図11.53「コンテナを停止する実行例」)

2. ゲートウェイコンテナのコンフィグファイルを修正する

   ゲートウェイコンテナは、コンテナ起動時にコンテナアプリケーションの起動スクリプトを実行するように設定されています。そのため、下記の通り sleep infinity コマンドを実行して待ち続けるだけの設定に変更します。 また、Armadillo Base OS ブート時に自動的に起動する設定となっているため、自動起動を無効にする設定も加えます。

   armadillo:~# cat /etc/atmark/containers/a6e-gw-container.conf
   : (省略)
   
   set_autostart no 
   
   #set_command sh /usr/bin/gw-app.sh 
   set_command sleep infinity 

   	自動起動の無効化
   	起動スクリプト実行部分をコメントアウト
   	sleep infinity コマンドを実行するように修正

   設定後は persist_file コマンドで変更を保存してください。

   [armadillo ~]# persist_file -P /etc/atmark/containers/a6e-gw-container.conf

3. 「実行中のコンテナに接続する」 の通り、コンテナを起動・接続する
4. コンテナ内で開発を行う
5. 「コンテナの変更を保存する」 を実行

ゲートウェイコンテナを利用せずに、新たに一からコンテナを作成することもできます。 次項より、その場合の手順を示します。

	ゲートウェイコンテナと、それに関連するファイルは 「コンテナとコンテナに関連するデータを削除する」 に記載している方法で Armadillo から削除することができます。

9.4.2.1. PodmanのデータをeMMCに保存する

デフォルトでは、Podmanのデータはtmpfsに保存されます。そのため、Armadillo を再起動するとデータは消えてしまいます。 この挙動は、Armadilloの運用時を想定したものです。

eMMCへの書き込みを最小限にする等の観点から、 Armadilloの運用時は、 Podmanのデータはtmpfsに保存するのが適切です。 eMMCへの保存が必要な場合のみ SWUpdate または abos-ctrl で読み取り専用のイメージを保存します。

Armadillo開発時のみ、 eMMCにPodmanのデータが保存されるようにすることを推奨します。

eMMCにPodmanのデータが保存されるようにするには、以下のコマンドを実行します。

[armadillo ~]# abos-ctrl podman-storage --disk
Creating configuration for persistent container storage
Create subvolume '/mnt/containers_storage'
[ 2145.288677] EXT4-fs (mmcblk0p1): re-mounted. Opts: (null)
[armadillo ~]# abos-ctrl podman-storage --status
Currently in disk mode, run with --tmpfs to switch

	podman のストレージはコンテナのイメージやランタイムのデータのみです。 コンテナのデータをボリュームに入れたら消えません。詳しくは 「コンテナの変更を保存する」 を参照してください。

9.4.2.3. デバイスのアクセス権を与える

開発中のアプリケーションがデバイスを利用する場合は、コンテナにデバイスを渡す必要があります。

podman run コマンドに --device オプションでデバイスファイルを指定します。

	--privileged オプションを指定するとすべてのセキュリティーメカニズムが無効になる為、全てのデバイスが利用できるようになります。このオプションを利用することは、セキュリティー上問題がある為、デバッグ用途でのみご利用ください。

podman_start用の設定ファイル(/etc/atmark/containers/*.conf)を作成します。その後、 podman_start -a コマンドを実行するか、armadilloを再起動してコンテナが自動起動することを確認してください。コンテナの自動起動に関する詳しい説明は 「コンテナの自動起動」 を参考にしてください。

まず、コンテナをコンテナレジストリに送るか、 podman save コマンドを実行してアーカイブを作成します。

以下の例では ATDE に mkswu のキーを作成して、 docker.ioのイメージをこのまま使います。

手順の詳しい説明やオプションは 「Armadilloのソフトウェアをアップデートする」 を参考にしてください。

[ATDE ~]$ sudo apt update && sudo apt install mkswu
[ATDE ~]$ mkswu --init
: (省略)
[ATDE ~]$ cd mkswu
[ATDE ~/mkswu]$ cp /usr/share/mkswu/examples/pull_container_nginx.desc .
[ATDE ~/mkswu]$ cp -r /usr/share/mkswu/examples/nginx_start .
[ATDE ~/mkswu]$ vi pull_container_nginx.desc
swdesc_option version=1

swdesc_pull_container "docker.io/nginx:alpine"
swdesc_files --extra-os nginx_start
[ATDE ~/mkswu]$ mkswu -o initial_setup_container.swu \
        initial_setup.desc pull_container_nginx.desc

ここで作成した initial_setup_container.swu ファイルを USB メモリに配置して、 Armadillo-IoT ゲートウェイ A6E に刺すとインストールされます。

インストールが終了して再起動すると docker.io/nginx:alpine のコンテナを 起動します。

購入状態でSWUをインストールできるか確認をするために、ソフトウェアの初期化を行います。

「Armadilloのソフトウェアの初期化」 を参照し、Armadillo Base OSを初期化してからアプリケーションをアップデートしてください。

アップデートを行う方法は以下の二通りです：

自動的にイメージを作る方法は 「コンテナの自動作成やアップデート」 を参考にしてください。