この記事は #NervesJP Advent Calendar 2020 の6日目，の代打です．歳末助け合い運動〜
5日目は，@MzRyuKaさんの「nerves_system_*から読み解くNervesの動向」でした．
やっぱみんなNerves RepositoriesをWatchしてるんですね〜

さて fukuoka.ex Elixir／Phoenix Advent Calendar 2020 の4日目に，こんな記事をお送りしました．Nervesの開発環境をお手軽に整えられまっせ！！というやつです．

ElixirでIoT#4.1.2：[使い方篇] Docker(とVS Code)だけ！でNerves開発環境を整備する

使い方の解説は嬉しいんだけど，どうやってるのか知りたい！！という声がいっぱい寄せられませんでした．なので本記事では，Dockerfileの記述やVS Code dev-containerの設定方法などを解説します．加えて，某ハンズオン向けに仕込んだカスタマイズ方法も紹介したいと思います．

なお本記事では，それぞれのリポジトリのRelease v0.2を対象として扱います．

Dockerfile: https://github.com/NervesJP/docker-nerves/tree/v0.2
VS Code: https://github.com/NervesJP/nerves-devcontainer/tree/v0.2

いろいろ使い勝手の向上のために鋭意進化中です！
もちろんcontribution大歓迎です．どしどしIssue/PRをお寄せください．
ちなみに中のヒトは docker-compose がまるでわかっていません^^;

Dockerfile

ナマモノはこちらから．
https://github.com/NervesJP/docker-nerves/blob/v0.2/Dockerfile

いろいろコダワルとキリがないのがDocker道ですが，誰にとっても嬉しいなるべく最小限かつ共通の記述のみに留めています．DockerとかNervesに詳しい方は，自分でどんどんオレオレカスタマイズして使っていただければです．

各行それぞれを追いながら説明していきます．

Elixir/Erlangのインストール

Dockerfile

# docker-elixir 1.11.2
# https://hub.docker.com/_/elixir
FROM elixir:1.11.2

コメントにあるとおり，OfficialのDocker Imageを持ってきているだけです．
Elixir 1.11.2-otp-23のイメージを指定しています．ちなみにOSはDebian 10です．
NervesはElixir/Erlangのバージョンをちゃんと気にする必要があるので，ここはきちんとタグを指定することにしています．

なお余談ですが，Elixir 1.11.0のbugがNerves Projectで見つかって，Joseも交えてワイワイfixされてたりします．なのでNervesは1.11.0と1.11.1では動作しません．

Nerves用のパッケージのインストール

Dockerfile

ENV DEBCONF_NOWARNINGS yes

# Install libraries for Nerves development
RUN apt-get update && \
    apt-get install -y build-essential automake autoconf git squashfs-tools ssh-askpass pkg-config curl && \
    rm -rf /var/lib/apt/lists/*

# [Optional] Uncomment this section to install libraries for customizing Nerves System
#RUN apt-get update && \
#    apt-get install -y libssl-dev libncurses5-dev bc m4 unzip cmake python && \
#    rm -rf /var/lib/apt/lists/*

Nerves公式Hexdocsの Installation / For Debian based systemsに従ったapt installをしています．

[Optional]のところは，Buildrootを使ったNerves Systemのカスタマイズをしたい場合には必要です．要は上級者向けです．Docker環境で使いたい方は少ないんじゃないかなぁと思われますが，でもまぁいちおうコメントで書いておきました．

fwupのインストール

Dockerfile

# Install fwup (https://github.com/fhunleth/fwup)
ENV FWUP_VERSION="1.8.2"
RUN wget https://github.com/fhunleth/fwup/releases/download/v${FWUP_VERSION}/fwup_${FWUP_VERSION}_amd64.deb && \
    apt-get install -y ./fwup_${FWUP_VERSION}_amd64.deb && \
    rm ./fwup_${FWUP_VERSION}_amd64.deb && \
    rm -rf /var/lib/apt/lists/*

fwup とは，Nervesのファームウェアを構築したり，microSDカードへの書込みを行うためのユーティリティです．
https://github.com/fhunleth/fwup

ここでは，Debian/Ubuntu AMD64向けのapt packageをダウンロードしてインストールしています．

Hexパッケージのインストール

Dockerfile

# Install hex and rebar
RUN mix local.hex --force
RUN mix local.rebar --force
# Install Mix environment for Nerves
RUN mix archive.install hex nerves_bootstrap 1.10.0 --force

ビルドツールの hex, rebar/rebar3 と，NervesのMix環境である nerves_bootstrap をインストールしています．
mix コマンドでのインストールはデフォルトだとインタラクティブに Yes する必要があり，docker buildには具合が悪いです．そのため --force オプションを付けています．

nerves_bootstrap については，ここもバージョンを揃えておいたほうが良いかなということで，明示的に指定しています．

CMDの指定

Dockerfile

CMD ["/bin/bash"]

最後に，コンテナ実行時のコマンドを指定しています．
実はElixir Official Imageでは iex が記述されています．Nerves開発にとっては気持ちが悪いので，bashに上書きしておくことにしました．

Tips: Docker Hubとの連携

GitHubとDocker Hubを連携したら良い感じにCI/CDできるらしいっす．

GitHub で自動構築 — Docker-docs-ja 17.06 ドキュメント

こんな感じにAutomated Builds Ruleを仕込んでます．確かに便利〜
（algyan は某ハンズオン用です）

VS Code設定

次はVS Code dev-containerの設定です．コレ自体の解説は，他の記事を読んだほうが早いです．

設定方法は簡単で， ./devcontainer/devcontainer.json というファイルでポチポチとプロパティを書いていくだけです．Properties referenceはこんな感じ．
https://code.visualstudio.com/docs/remote/devcontainerjson-reference

ということでナマモノはこちらから．
https://github.com/NervesJP/nerves-devcontainer/blob/v0.2/.devcontainer/devcontainer.json

コチラも各行それぞれを追いながら説明していきます．

コンテナ名とイメージの指定

./devcontainer/devcontainer.json

{
    "name": "Nerves",
    // Pull Docker image from DockerHub  https://hub.docker.com/r/nervesjp/nerves
    "image": "nervesjp/nerves:0.2",
    // NOTE: original Dockerfile is maintained at https://github.com/NervesJP/docker-nerves/blob/main/Dockerfile
    // You can also build Docker image locally by locating above file to here and uncomment next line 
    //"dockerFile": "Dockerfile",

コンテナ名を"Nerves"にしています．これがVS Code左下ステータスバーの緑色のところに表示されます．
イメージは，Docker Hubにpushしてあるビルド済みのイメージを指定しています．コメントにもある通り，Dockerfileをローカルに置いて直接ビルドすることもできます．

マウントの指定

./devcontainer/devcontainer.json

    "mounts": [
        "source=${localWorkspaceFolder}/.hex,target=/root/.hex,type=bind,consistency=cached",
        "source=${localWorkspaceFolder}/.nerves,target=/root/.nerves,type=bind,consistency=cached",
        "source=${localWorkspaceFolder}/.ssh,target=/root/.ssh,type=bind,consistency=cached"
    ],

ホストとDockerコンテナの間でマウントするディレクトリを指定しています．
ここ割りとコダワリどころで，Nerves開発に使う上記３つのディレクトリをマウントするようにしました．これらはカレントディレクトリ（GitHubのディレクトリ）にもともと作ってあります．${HOME}でも良いかなと悩んだのですが，Nervesはじめてな方はこれらのディレクトリが無いかなということで，この形式に落ち着いています．

なお dev-container を開いたホストのディレクトリは，コンテナ内の /workspaces/nerves-devcontainer に自動的にマウントされます．

シェルの設定

./devcontainer/devcontainer.json

    "settings": {
        "terminal.integrated.shell.linux": "bash"
    },

まぁ定番ということでbashを指定しています．
ここは各人でコダワリあるかもしれませんが，宗教戦争は控えましょう^^;

VS Code拡張機能のインストール

./devcontainer/devcontainer.json

    "extensions": [
        "jakebecker.elixir-ls"
    ],

コンテナ内のVS Codeにて使用する拡張機能を指定しています．
とりあえずベタにElixirLSだけにしてあります．オススメのプラグイン教えてください〜

Nerves向け環境変数の設定

./devcontainer/devcontainer.json

    // This section sets environment variables for Nerves development
    "remoteEnv": {
        "MIX_TARGET": "rpi3",
        "WIFI_SSID": "xxxxxxxx",
        "WIFI_PSK": "yyyyyyyy"
    }

[使い方篇 / 環境変数の設定] でも紹介していますが，VS Code拡張機能の便利なところで，コンテナ内のシェル環境変数を設定することができます．

よく忘れがちな ${MIX_TARGET} を入れておきました．
あとはVintageNet WiFiの設定をするための環境変数です．これらの環境変数の使い方は @kentaro さんのナイスな記事をご参照いただくのが良いかと．

ウェブチカでElixir/Nervesに入門する（2020年12月版） / Wi-Fi経由でファームウェアをデプロイできるようにする

ご利用の際には，これらをお好みに合わせていただければです．

ユーザの設定

./devcontainer/devcontainer.json

    // Uncomment to connect as a non-root user. More info: https://aka.ms/vscode-remote/containers/non-root.
    //"remoteUser": "vscode"
}

コンテナ内のユーザを設定できますが，まぁrootでも良いかなということでコメントにしてあります．

ハンズオンに向けた調整

[使い方篇] では，devcontainerこんな嬉しさがあるぜっ！ってのを紹介しました．

ハンズオンの開催を計画する時にすごく頭を悩ませるのが，参加者の環境を揃えることです．DockerfileとかVS Codeの各種設定ファイルを調整すれば，これもお手軽に解消できます！！
- |> ［PR］参考例［広告］
- |> この例の導入方法［ステマ］

もともとdev-container環境を整備したのは，このハンズオンに向けた準備のためでした．

ALGYAN主催！【オンライン】豪華プレゼント付！Elixir/Nerves(ナーブス)体験ハンズオン！

じゃあどうやってカスタマイズしているの？を紹介します．

Dockerfile

Dockerfile側は，v0.1から algyan branchを生やして整備しました．
GitHubのWebページではこんな感じです．
https://github.com/NervesJP/docker-nerves/compare/v0.1...algyan

ターミナルではこんな感じです．これもブロックごとに説明しましょう．

$ git diff v0.1..algyan Dockerfile 
diff --git a/Dockerfile b/Dockerfile
index 95ce84e..5cbadf5 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -29,4 +29,28 @@ RUN mix local.rebar --force
 # Install Mix environment for Nerves
 RUN mix archive.install hex nerves_bootstrap --force

+# Download archives of Nerves artifacts on Docker build process
+RUN mkdir -p ~/.nerves/dl
+# Alghough the latest version of nerves_system_rpi4 is now v1.13.1, we found
+# the issue about WiFi connection to 5GHz AP on this version.
+# So we decided to download both versions to avoid confusion on ALGYAN hands-on.
+RUN wget -q -P ~/.nerves/dl/ https://github.com/nerves-project/nerves_system_rpi4/releases/download/v1.13.0/nerves_system_rpi4-portable-1.13.0-366303C.tar.gz
+RUN wget -q -P ~/.nerves/dl/ https://github.com/nerves-project/toolchains/releases/download/v1.3.2/nerves_toolchain_arm_unknown_linux_gnueabihf-linux_x86_64-1.3.2-E31F29C.tar.xz
+RUN wget -q -P ~/.nerves/dl/ https://github.com/nerves-project/nerves_system_rpi4/releases/download/v1.13.1/nerves_system_rpi4-portable-1.13.1-C916C86.tar.gz
+RUN wget -q -P ~/.nerves/dl/ https://github.com/nerves-project/toolchains/releases/download/v1.3.2/nerves_toolchain_aarch64_unknown_linux_gnu-linux_x86_64-1.3.2-7C57FE3.tar.xz
+

今回の準備で特に気にしたことは，ハンズオンの最中の通信量を少しでも削減することでした．
ALGYANイベントはMS Teamsでオンライン開催ですので，負荷は小さいほうがよいです．また，ラズパイ4を参加者にプレゼント！ということで，ターゲットはrpi4だけ気にすればよいです．

ということで，mix deps.getの際にダウンロードしてくるnerves_systemパッケージをコンテナ内に入れ込むことにしました．
v1.13.0とv1.13.1の両方があるのは，まぁいろいろな事情があります^^;

+# COPY SSH keys (id_rsa / id_rsa.pub) to `/root/.ssh/` on Docker dev-container
+# Of course we understand that sharing SSH keys on GitHubit is dangerous, but
+# we employ this way to make the hands-on process more efficient.
+RUN mkdir -p /root/.ssh
+COPY .ssh/id_rsa /root/.ssh/
+RUN chmod 600 /root/.ssh/id_rsa
+COPY .ssh/id_rsa.pub /root/.ssh/
+COPY .ssh/config /root/.ssh/
+RUN chmod 600 /root/.ssh/config
+

今回のハンズオンでは，Nervesファームウェアをもう書き込み済み！のmicroSDカードをプレゼントしています．これは，dev-containerからはmix burnできない,,,という制約から来ています．
その代わり，SSH鍵をコンテナに入れ込むことができるので，そのあたりの設定をスキップすることができます．ただし，SSH鍵をみんなで同じの使い回すという，ちと危険が危ないやつですが^^;

ちなみに .ssh/config はこんな設定を書いてあります．

Host nerves.local
    ServerAliveInterval 10
    StrictHostKeyChecking no

最後に，シェルの設定をちょっと入れ込んでいます．

+# Append some environmental variables for hands-on
+RUN echo "export PS1=\"\n\[\033[0;32m\]\u@\h \[\033[0;33m\]\w\n\\[\033[0m\]# \[\033[0m\]\"" >> ~/.bashrc
+RUN echo "export MIX_TARGET=rpi4" >> ~/.bashrc
+
 CMD ["/bin/bash"]

これもrpi4だけ気にすればよいので，${MIX_TARGET}を設定してあります．
また，${PS1}は私の好みです^^;

なおVS Code拡張機能のremoteEnvオプションを知ったのは，このあとのお話しでしたｗ

VS Code設定

こちらはハンズオンの混乱を避けるために，v0.1からファイルをコピってリポジトリをまるごと分けました．
https://github.com/NervesJP/nerves-algyan-devcontainer

またもや git diff を追って見ていきます．

$ git diff c17534 .devcontainer/devcontainer.json 
diff --git a/.devcontainer/devcontainer.json b/.devcontainer/devcontainer.json
index 5ef137c..924e3f7 100644
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,10 +1,17 @@
 {
-       "name": "Nerves",
-       "dockerFile": "Dockerfile",
-       "extensions": [
-               "jakebecker.elixir-ls"
-       ],
+       "name": "NervesJP-ALGYAN",
+       "image": "nervesjp/nerves:algyan",
+
+       //"mounts": [
+       //      "source=${localWorkspaceFolder}/.ssh,target=/root/.ssh,type=bind,consistency=cached"
+       //],
+
        "settings": {
                "terminal.integrated.shell.linux": "bash"
-       }
+       },

こっちはシンプルですね．
コンテナの名前を "NervesJP-ALGYAN" に変更しているのと，pullしてくるDocker imageのタグを :algyan にしているだけです．タグの変更だけでDocker Hub連携をよしなにできるの，マジ便利です．
あと .ssh/ 等のバインドはやめています．

おわりに

こんな感じで，おれのかんがえた最強のNerves dev-container環境を整えてみてください！！

#NervesJP Advent Calendar 2020 の7日目は @myasu さんによる「Elixir/NervesでPLC(多機能リレー)を作ってみた」です．PLCまるでわからん

ElixirでIoT#4.1.3：[仕組み篇] Docker(とVS Code)だけ！でNerves開発環境を整備する

Dockerfile

Elixir/Erlangのインストール

Nerves用のパッケージのインストール

fwupのインストール

Hexパッケージのインストール

CMDの指定

Tips: Docker Hubとの連携

VS Code設定

コンテナ名とイメージの指定

マウントの指定

シェルの設定

VS Code拡張機能のインストール

Nerves向け環境変数の設定

ユーザの設定

ハンズオンに向けた調整

Dockerfile

VS Code設定

おわりに