Azure IoT Edgeチュートリアルのバックアップ(No.16)

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

戻る
- Azure IoT Hubチュートリアル
- Azure IoT Centralチュートリアル
- Azure IoT Edgeチュートリアル

目次 †

↑

概要 †

Azure IoT Edgeの様々なモジュールをデプロイしていくチュートリアル。

Marketplaceモジュール
カスタム・モジュール
AzureのPaaSやSaaSモジュール

↑

詳細 †

Azure IoT Hubの作成は、Azure IoT Hubチュートリアルへ。

↑

Marketplaceモジュールのデプロイ †

とりあえずMarketplace モジュールのデプロイだけやってみる。

以下の２つのクイックスタートがあるが、

Windows デバイスへのコードのデプロイ
https://docs.microsoft.com/ja-jp/azure/iot-edge/quickstart
Linux デバイスへのコードのデプロイ
https://docs.microsoft.com/ja-jp/azure/iot-edge/quickstart-linux

WindowsでAzure IoT EFLOWと言うエミュレータを使用するか、
ARMテンプレートでLinuxのAzureVMをデプロイして試すか、２通りの方法がある。

↑

前提 †

Azure CLI

ローカルでなくても良い模様。
Dockerが提案されていたが、WSLでも良いものと思われる。
更に言えば、Azure Cloud Shellでも良いものと思われる
（...と言うか、実際にAzure Cloud Shellでやった）。

↑

準備 †

IoT Hub の作成

az iot hub create --resource-group XXXX --name XXXX --sku F1 --partition-count 2

IoT Edge デバイスを登録
- デバイスをハブに作成
- デバイスの接続文字列を確認

IoT Edge デバイスの設定

Windowsの場合はローカルにEFLOWを構成
Linuxの場合はARMテンプレートでAzureVMをデプロイ

以下はLinuxを個別に設定する際のシェル。

curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
sudo mv ./microsoft-prod.list /etc/apt/sources.list.d/
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv ./microsoft.gpg /etc/apt/trusted.gpg.d/
sudo apt-get update
sudo apt-get install -y moby-engine moby-cli
sudo apt-get install -y iotedge
sudo vi /etc/iotedge/config.yaml
sudo systemctl restart iotedge
systemctl status iotedge
sudo iotedge list

その後、コンフィグ手順は下記参照。
https://learn.microsoft.com/ja-jp/azure/iot-edge/how-to-provision-devices-at-scale-linux-symmetric

↑

実行 †

IoT Edgeモジュールを展開
Marketplaceモジュール（Simulated Temperature Sensor）

生成されたデータを表示する
コンテナ内部にログインしてShell（Bash）で。

↑

カスタム・モジュールの開発とデプロイ †

次にカスタム・の開発とデプロイをやってみる。

以下の２つのチュートリアルがあるが、

Visual Studio Code を使用して
- IoT Edge モジュールを開発する
  https://learn.microsoft.com/ja-jp/azure/iot-edge/tutorial-develop-for-linux
- Azure IoT Edge モジュールをデバッグする
  https://learn.microsoft.com/ja-jp/azure/iot-edge/debug-module-vs-code

Visual Studio 2022 を使用して Azure IoT Edge 用のモジュールを開発してデバッグする
https://learn.microsoft.com/ja-jp/azure/iot-edge/how-to-visual-studio-develop-module

いずれもWindowsでAzure IoT EFLOWと言うエミュレータを使用する。
ここでは、サポート範囲の広いVisual Studio Code を使用した手順のみ実施する。

↑

ローカル環境準備 †

.NET Core SDKとVSCode、C#のVSCode拡張をインストールしておく。

Azure IoT Edge関連のツールについては、
- 色々調査すると、言語のVSCode拡張とAzure IoT Tools for VSCodeをインストールすれば良さそうだが、
- 今は、Azure IoT Tools for VSCodeがメンテナンス・モードなので、iotedgedevのCLIを単体使いしろと言う事らしい。
- なお、Azure IoT Tools for VSCodeの依存関係としてiotedgedevが含まれていた模様。iotedgedevのランタイムはPython。
```
pip list
pip freeze > uninstall.txt
pip uninstall -y -r uninstall.txt
pip install -U iotedgedev
```

参考
- Azure IoT Edge #4 - Edgeモジュールの開発環境構築 - YouTube?
  https://www.youtube.com/watch?v=-ztATJCcBWQ
- iotedgedev · PyPI
  https://pypi.org/project/iotedgedev/
- iotedgedev/docs/environment-setup/manual-dev-machine-setup.md at main · Azure/iotedgedev
  https://github.com/Azure/iotedgedev/blob/main/docs/environment-setup/manual-dev-machine-setup.md
- iotedgedev/docs/environment-setup/run-devcontainer-docker.md at main · Azure/iotedgedev
  https://github.com/Azure/iotedgedev/blob/main/docs/environment-setup/run-devcontainer-docker.md

↑

Container Registryの準備 †

デプロイにContainer RegistryとしてAzure Container Registryを使う。

↑

C#のSolution・Projectの準備 †

以下のCMDのコマンドでC#のSolution・Projectを準備

mkdir iotedgesolution
cd iotedgesolution
iotedgedev solution init --template csharp

以下を含むいくつかのステップを完了するよう促す
- Azureへの認証
- Azure サブスクリプションの選択
- リソースグループを選択または作成
- Azure IoT Hub を選択または作成
- Azure IoT Edge デバイスの選択または作成

ファイルの修正
- https://github.com/OpenTouryoProject/HubAndMsgSrv/pull/5/files?w=1

↑

カスタム・モジュールのコンテナ化 †

ココのシェルはVSCodeのGitBash?ターミナルで実行する。

ユーザIDとパスワードで Azure Container Registry にログイン。

az login
AcrName=osscjpdevinfra
echo $AcrName
RegistryName=$(az acr show --name $AcrName --query loginServer --output tsv)
echo $RegistryName
Password=$(az acr credential show --name $RegistryName --query "passwords[0].value" | sed 's/"//g')
echo $Password

az acr login -n $RegistryName
docker login $RegistryName -u $AcrName -p $Password

カスタム・モジュールのコンテナを、ビルド、プッシュ、セット

subscriptionID=$(az account show --query id --output tsv)
userPrincipalName=$(az ad signed-in-user show --query userPrincipalName --output tsv)
location=westus2
hmsRgName=HmsRG
iotHubName=OsscJpDevInfra
iotEdgeID=myedge1

hubConnectionString=$( \
  az iot hub connection-string show \
  -n $iotHubName \
  --key primary \
  --query connectionString -o tsv)

docker build --rm -f "./modules/filtermodule/Dockerfile.amd64.debug" -t osscjpdevinfra.azurecr.io/filtermodule:0.0.1-amd64 "./modules/filtermodule"
docker push osscjpdevinfra.azurecr.io/filtermodule:0.0.1-amd64
az iot edge set-modules --hub-name $iotHubName --device-id $iotEdgeID --content ./deployment.template.json --login $hubConnectionString

↑