対称キーを使用して Linux で IoT Edge デバイスを作成およびプロビジョニングする

[アーティクル]
04/11/2024

適用対象: IoT Edge 1.5 IoT Edge 1.4

重要

サポートされているリリースは、IoT Edge 1.5 LTS と IoT Edge 1.4 LTS です。 IoT Edge 1.4 LTS は、2024 年 11 月 12 日にサポートが終了します。以前のリリースの場合は、「IoT Edge を更新する」を参照してください。

この記事では、IoT Edge のインストールを含む、Linux IoT Edge デバイスの登録とプロビジョニングの詳細な手順について説明します。

IoT ハブに接続するすべてのデバイスにはデバイス ID があり、これを使用して、cloud-to-device または device-to-cloud の通信を追跡します。接続情報を使用してデバイスを構成します。これには次のものが含まれます。

IoT ハブホスト名
Device ID
IoT Hub に接続するための認証の詳細

この記事の手順では、"手動プロビジョニング" と呼ばれるプロセスについて説明します。ここでは、1 つのデバイスを IoT ハブに接続します。手動プロビジョニングの場合、IoT Edge デバイスの認証には 2 つのオプションがあります。

対称キー: IoT Hub で新しいデバイス ID を作成すると、サービスによって 2 つのキーが作成されます。いずれかのキーをデバイスに配置すると、認証時にそのキーが IoT Hub に提示されます。

この認証方法は比較的すばやく開始できますが、それほど安全ではありません。
X.509 自己署名: 2 つの X.509 ID 証明書を作成し、デバイスに配置します。 IoT Hub で新しいデバイス ID を作成するときは、両方の証明書の拇印を指定します。デバイスでは IoT Hub に対して認証を行うときに、1 つの証明書が提示され、その証明書がその拇印と一致することが IoT によって検証されます。

この認証方法はより安全であり、運用環境のシナリオの場合に推奨されます。

この記事では、認証方法として対称キーを使用する方法について説明します。 X.509 証明書を使用する場合は、「x.509 証明書を使用して Linux で IoT Edge デバイスを作成およびプロビジョニングする」を参照してください。

Note

設定するデバイスが多数あり、それぞれを手動でプロビジョニングしたくない場合は、次の記事のいずれかを使用して、IoT Edge が IoT Hub Device Provisioning Service でどのように動作するかを確認してください。

前提条件

この記事では、IoT Edge デバイスを登録し、このデバイスに IoT Edge (IoT Edge ランタイムとも呼ばれます) をインストールする方法について説明します。デバイスを登録してインストールする前に、Azure CLI などのデバイス管理ツールとデバイス要件が存在することを確認します。

デバイス管理ツール

デバイスを登録する手順には、Azure portal、Visual Studio Code、または Azure CLI を使用できます。各ユーティリティには、独自の前提条件があり、インストールが必要な場合があります。

Azure サブスクリプション内の無料または標準の IoT ハブ。

Azure サブスクリプション内の無料または標準の IoT ハブ
ご使用の環境内の Azure CLI

Azure CLI のバージョンは、少なくとも 2.0.70 以降である必要があります。検証するには、az --version を使用します。このバージョンでは、az 拡張機能のコマンドがサポートされ、Knack コマンドフレームワークが導入されています。

デバイスの要件

X64、ARM32、または ARM64 の Linux デバイス。

Microsoft では、さまざまなオペレーティングシステム用のインストールパッケージを公開しています。

運用シナリオ向けに現在サポートされているオペレーティングシステムに関する最新の情報については、「Azure IoT Edge のサポートされるシステム」を参照してください。

Visual Studio Code 拡張機能

Visual Studio Code を使っている場合は、デバイスの作成と管理のプロセスを容易にする便利な Azure IoT 拡張機能があります。

Azure IoT Edge と Azure IoT Hub 拡張機能の両方をインストールします。

Azure IoT Edge。 "Visual Studio Code 用の Azure IoT Edge Tools" 拡張機能は、メンテナンスモードになっています。
Azure IoT Hub

デバイスを登録する

デバイスを登録するには、好みに応じて Azure portal、Visual Studio Code、または Azure CLI を使用できます。

Azure portal の IoT Hubで、IoT Edge デバイスは、Edge 対応ではない IoT デバイスとは別に作成および管理されます。

Azure Portal にサインインし、IoT Hub に移動します。
左側のウィンドウで、メニューから [デバイス] を選択し、[デバイスを追加する] を選択します。
[デバイスの作成] ページで、次の情報を指定します。
- 説明的なデバイス ID を作成します。たとえば、my-edge-device-1 (すべて小文字) です。このデバイス ID は後で使用するので、メモしておいてください。
- [IoT Edge デバイス] のチェックボックスをオンにします。
- 認証の種類として [対称キー] を選択します。
- 認証キーを自動生成して、新しいデバイスをハブに接続するために、既定の設定を使用します。
[保存] を選択します。

IoT ハブに新しいデバイスが一覧表示されます。

Visual Studio Code 用の Azure IoT 拡張機能を使用して、IoT ハブで操作を実行できます。 Azure IoT 拡張機能の前提条件をインストール済みであることを確認します。

Azure IoT Edge と Azure IoT Hub 拡張機能がインストールされると、左側のアイコンメニューに Azure アイコンが追加されます。 Visual Studio Code を使用して Azure アカウントにサインインできます。そのためには、Azure アイコンを選択し、[Azure にサインイン] を選択します。

Visual Studio Code を使用して新しいデバイスを登録する

新しいデバイスの登録方法は、Azure portal で IoT Edge デバイスを作成する方法と似ています。この仮想デバイスはツインの一方であり、実際のデバイスはツインのもう一方です。 Visual Studio Code では、次の手順に従ってこれを設定できます。

Visual Studio Code エクスプローラーメニューで、[Azure IoT Hub] セクションを展開します。
[Azure IoT Hub] セクションヘッダーで [...] を選択します。省略記号が表示されない場合は、ヘッダーを選択するかポイントします。
[Create IoT Edge Device]$IoT Edge デバイスの作成$ を選択します。
表示されたテキストボックスで、my-edge-device-1 (すべて小文字) などの ID をデバイスに指定し、Enter キーを押します。

Visual Studio Code の出力コンソールに、コマンドの結果 (JSON 出力) が表示されます。デバイスの情報には、指定した deviceId が含まれ、IoT ハブに物理デバイスを接続するために使用できる connectionString が生成されます。出力コンソールには、キーやその他のデバイス識別情報も表示されます。

これで、エクスプローラーメニューの [Azure IoT Hub]>[デバイス] セクションの一覧にこのデバイスが表示されます。

Note

デバイスが一覧になければ、[Azure IoT Hub] の下にあるリンク [IOT ハブの選択] から IoT ハブを選択し、プロンプトに従う必要がある場合があります。プロンプトでは、最初にサブスクリプション、次に IoT ハブを選択するように求められます。このプロセスにより、Visual Studio Code が IoT ハブ (およびその中のすべてのデバイス) を認識します。 Visual Studio Code を更新すると、デバイスが表示されます。

az iot hub device-identity create コマンドを使用して、IoT ハブに新しいデバイス ID を作成します。 device_id_here を、my-edge-device-1 (すべて小文字) など、独自の新しい一意のデバイス ID に置き換えます。 hub_name_here を既存の IoT ハブに置き換えます。

このコマンドには、3 つのパラメーターが含まれます。

--device-id または -d: IoT ハブ内で一意のわかりやすい名前を指定します。
--hub-name または -n: IoT ハブの名前を指定します。

--edge-enabled または --ee: デバイスが IoT Edge デバイスであることを宣言します。

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

CLI に The command requires the extension azure-iot. (このコマンドには拡張機能 azure-iot が必要です。)Do you want to install it now? (今すぐインストールしますか?) と表示された場合は、Y を入力し、Enter を押します。これにより、ダウンロードが開始され、デバイスが作成されます。

デバイスが IoT ハブに登録されたので、プロビジョニング情報を取得できます。これを使用して、次の手順で IoT Edge ランタイムのインストールとプロビジョニングを完了します。

登録済みデバイスを表示し、プロビジョニング情報を取得する

対称キー認証を使用するデバイスでは、IoT Edge ランタイムのインストールとプロビジョニングを完了するために接続文字列が必要です。 IoT Edge デバイスを作成すると、このデバイスの接続文字列が生成されます。 Visual Studio Code と Azure CLI の場合、接続文字列は JSON 出力に含まれます。 Azure portal を使用してデバイスを作成する場合は、デバイス自体で接続文字列を見つけることができます。 IoT ハブでデバイスを選択すると、デバイスページに Primary connection string として表示されます。

IoT ハブに接続するエッジ対応デバイスが、IoT ハブの [デバイス] ページに一覧表示されます。複数のデバイスがある場合は、[IoT Edge デバイス] という種類を選択し、[適用] を選択すると、一覧をフィルター処理できます。

デバイスを設定する準備ができたら、物理デバイスを IoT ハブ内でのその ID にリンクする接続文字列が必要です。対称キーを使用して認証を行うデバイスでは、接続文字列をポータルでコピーできます。ポータルで接続文字列を見つけるには、次のようにします。

[デバイス] ページで、一覧から IoT Edge デバイス ID を選択します。
[プライマリ接続文字列] または [セカンダリ接続文字列] のどちらかの値をコピーします。どちらのキーでも機能します。

IoT ハブのすべてのデバイスを表示するには、az iot hub device-identity list コマンドを使用します。 hub_name_here を自分の IoT ハブ名に置き換えてください。

az iot hub device-identity list --hub-name hub_name_here

IoT Edge デバイスとして登録されたすべてのデバイスのプロパティ capabilities.iotEdge が true に設定されています。デバイス ID を含め、JSON 出力として他にも多くのメタデータが表示されます。

デバイスを設定する準備ができたら、物理デバイスを IoT ハブ内でのその ID にリンクする接続文字列が必要になります。次の az iot hub device-identity connection-string show コマンドを使用すると、単一のデバイスの接続文字列が返されます。 [device_id] と [hub_name] を独自の値に置き換えます。 device-identity パラメーターの値は、大文字と小文字が区別されます。

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

コンソールに、次のような JSON 出力が表示されます。

{
  "connectionString": "HostName=[hub_name].azure-devices.net;DeviceId=[device_id];SharedAccessKey=[device_key]"
}

ヒント

connection-string show コマンドは、Azure IoT 拡張機能のバージョン 0.9.8 で導入され、これによって、非推奨の show-connection-string コマンドが置き換えられました。このコマンドの実行中にエラーが発生した場合は、拡張機能のバージョンが 0.9.8 以降に更新されていることを確認してください。詳細情報と最新の更新プログラムについては、Azure CLI 用の Microsoft Azure IoT 拡張機能に関するページを参照してください。

デバイスで使用する接続文字列をコピーする場合は、接続文字列を囲んでいる引用符を含めないでください。

IoT Edge をインストールする

このセクションでは、Linux 仮想マシンまたは IoT Edge の物理デバイスを準備します。次に、IoT Edge をインストールします。

次のコマンドを実行してパッケージリポジトリを追加し、信頼できるキーの一覧に Microsoft パッケージ署名キーを追加します。

重要

2022 年 6 月 30 日に、レベル 1 OS サポートリストから Raspberry Pi OS Stretch が廃止されました。潜在的なセキュリティの脆弱性を回避するために、ホスト OS を Bullseye に更新してください。

レベル 2 でサポートされているプラットフォームオペレーティングシステムの場合、インストールパッケージは、Azure IoT Edge リリースで利用できます。「オフラインまたは特定のバージョンのインストール」のインストール手順を参照してください。

インストールは、数個のコマンドで実行できます。ターミナルを開き、次のコマンドを実行します。

24.04:

wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

22.04:

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

20.04:

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

APT を使用したインストールは、少ないコマンドで実行できます。ターミナルを開き、次のコマンドを実行します。

12 - Bookworm (arm32v7):

curl https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
sudo apt install ./packages-microsoft-prod.deb

11 - Bullseye (arm32v7):

curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
sudo apt install ./packages-microsoft-prod.deb

ヒント

OS のインストール中に "root" アカウントにパスワードを指定した場合、'sudo' は不要です。上記のコマンドを 'apt' から始めて実行できます。

インストールは、数個のコマンドで実行できます。ターミナルを開き、次のコマンドを実行します。

9.x (amd64):

  wget https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
  sudo yum localinstall packages-microsoft-prod.rpm
  rm packages-microsoft-prod.rpm

8.x (amd64):

  wget https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
  sudo yum localinstall packages-microsoft-prod.rpm
  rm packages-microsoft-prod.rpm

オペレーティングシステムのバージョンの詳細については、「Azure IoT Edge でサポートされているプラットフォーム」を参照してください。

Note

Azure IoT Edge ソフトウェアパッケージには、パッケージ内にあるライセンス条項 (usr/share/doc/{package-name} または LICENSE ディレクトリ) が適用されます。パッケージを使用する前に、ライセンス条項をお読みください。インストールし、パッケージを使用すると、これらの条項に同意したものと見なされます。ライセンス条項に同意しない場合は、そのパッケージを使用しないでください。

コンテナーエンジンをインストールする

Azure IoT Edge は、OCI と互換性のあるコンテナーランタイムに依存します。運用環境のシナリオでは、Moby エンジンを使用することをお勧めします。 Moby エンジンは、IoT Edge で公式にサポートされているコンテナーエンジンです。 Docker CE/EE コンテナーイメージは、Moby ランタイムと互換性があります。 Ubuntu Core スナップを使用している場合、Docker スナップは Canonical によって処理され、運用シナリオでサポートされます。

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

sudo apt-get update; \
  sudo apt-get install moby-engine

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

sudo apt-get update; \
  sudo apt-get install moby-engine

Moby エンジンと CLI をインストールします。

sudo yum install moby-engine moby-cli

ヒント

Moby コンテナーエンジンをインストールするときにエラーが発生する場合は、Linux カーネルに Moby との互換性があることを確認します。埋め込みデバイスの一部の製造元からは、コンテナーエンジンとの互換性のために必要な機能を備えていないカスタム Linux カーネルを含むデバイスイメージが提供されています。 Moby から提供されている check-config スクリプトを使用する次のコマンドを実行して、カーネルの構成を確認します。

curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

スクリプトの出力で、Generally Necessary と Network Drivers の下のすべての項目が有効になっていることを確認します。機能が欠けている場合は、カーネルをソースから再構築し、カーネルの適切な .config に含める関連モジュールを選択することで、それらを有効にします。同様に、defconfig や menuconfig などのカーネル構成ジェネレーターを使用している場合は、それぞれの機能を見つけて有効にし、ご自分のカーネルを適宜再構築します。新たに変更されたカーネルを展開したら、check-config スクリプトをもう一度実行して、必要なすべての機能が正常に有効になっていることを確認します。

IoT Edge には、Docker と IoT ID サービスへの依存関係があります。次のコマンドを使って、依存関係をインストールします。

sudo snap install docker
sudo snap install azure-iot-identity

Docker スナップは Canonical によって提供され、運用シナリオでサポートされます。

既定では、コンテナーエンジンによってコンテナーログサイズの制限は設定されません。これにより、時間の経過と共に、デバイスがログでいっぱいになり、ディスク容量が不足する可能性があります。ただし、ローカルに表示するようにログを構成することはできますが、省略しても構いません。ログ構成の詳細については、「運用環境デプロイのチェックリスト」を参照してください。

次の手順では、ログメカニズムとして local ログドライバーを使用するようにコンテナーを構成する方法を示します。

Ubuntu、Debian、RHEL
Ubuntu Core スナップ

既存の Docker デーモンの構成ファイルを作成または編集します
```
sudo nano /etc/docker/daemon.json
```
例で示すように、既定のログドライバーを local ログドライバーに設定します。
```
   {
      "log-driver": "local"
   }
```
コンテナーエンジンを再起動して、変更を有効にします。
```
sudo systemctl restart docker
```

IoT Edge ランタイムをインストールする

IoT Edge サービスによって、IoT Edge デバイス上にセキュリティ標準が提供されて維持されます。サービスは起動のたびに開始され、IoT Edge ランタイムの残りの部分を開始することでデバイスをブートストラップします。

Note

バージョン 1.2 以降では、IoT ID サービスにより、IoT Edge および IoT Hub と通信する必要があるその他のデバイスコンポーネントの ID プロビジョニングと管理が処理されます。

このセクションの手順では、インターネットに接続されているデバイスに最新バージョンの IoT Edge をインストールする一般的なプロセスが示されています。プレリリースバージョンなどの特定のバージョンをインストールする必要がある場合、またはオフラインの間にインストールする必要がある場合は、この記事で後述する「オフラインまたは特定のバージョンのインストール」の手順に従ってください。

ヒント

以前のバージョンを実行している IoT Edge デバイスが既にあり、最新のリリースにアップグレードする場合は、「IoT Edge セキュリティデーモンおよびランタイムの更新」の手順を使用します。それ以降のバージョンは、以前のバージョンの IoT Edge と十分に異なるため、アップグレードには特定の手順が必要です。

(まだ最新の状態でない場合) 最新バージョンの IoT Edge と IoT ID サービスパッケージをインストールします。

22.04:

sudo apt-get update; \
   sudo apt-get install aziot-edge

20.04:

sudo apt-get update; \
   sudo apt-get install aziot-edge defender-iot-micro-agent-edge

オプションの defender-iot-micro-agent-edge パッケージには、セキュリティ態勢管理、脆弱性、脅威検出、フリート管理などのエンドポイントの可視性を提供する Microsoft Defender for IoT セキュリティマイクロエージェントが含まれており、IoT Edge デバイスのセキュリティ保護に役立ちます。 Edge デバイスのセキュリティ監視とセキュリティ強化を有効にするには、Edge エージェントを使ってマイクロエージェントをインストールすることをお勧めします。 Microsoft Defender for IoT の詳細については、「デバイスビルダー向け Microsoft Defender for IoT とは」を参照してください。

(まだ最新の状態でない場合) 最新バージョンの IoT Edge と IoT ID サービスパッケージをインストールします。

sudo apt-get update; \
  sudo apt-get install aziot-edge defender-iot-micro-agent-edge

オプションの defender-iot-micro-agent-edge パッケージには、セキュリティ態勢管理、脆弱性、脅威検出、フリート管理などのエンドポイントの可視性を提供する Microsoft Defender for IoT セキュリティマイクロエージェントが含まれており、IoT Edge デバイスのセキュリティ保護に役立ちます。 Edge デバイスのセキュリティ監視とセキュリティ強化を有効にするには、Edge エージェントを使ってマイクロエージェントをインストールすることをお勧めします。 Microsoft Defender for IoT の詳細については、「デバイスビルダー向け Microsoft Defender for IoT とは」を参照してください。

(まだ最新の状態でない場合) 最新バージョンの IoT Edge と IoT ID サービスパッケージをインストールします。

sudo yum install aziot-edge

スナップストアから IoT Edge をインストールします。

sudo snap install azure-iot-edge

スナップを接続する

既定では、スナップは依存関係がなく、信頼されておらず、厳密に制限されています。そのため、インストールの後で、スナップを他のスナップやシステムリソースに接続する必要があります。次のコマンドを使って、IoT ID サービスと IoT Edge スナップを相互に、およびシステムリソースと接続します。始めるには、スナップを手動で接続する必要があります。運用環境のデプロイでは、それらを自動的に接続するように構成して、プロビジョニングの作業量を減らすことができます。

#------------------------
#  IoT Identity Service
#------------------------

# Connect the Identity Service snap to the logging system
# and grant permission to query system info

sudo snap connect azure-iot-identity:log-observe
sudo snap connect azure-iot-identity:mount-observe
sudo snap connect azure-iot-identity:system-observe
sudo snap connect azure-iot-identity:hostname-control

# If using a TPM, enable TPM access

sudo snap connect azure-iot-identity:tpm

#------------
#  IoT Edge
#------------

# Connect to your /home directory to enable writing support bundles

sudo snap connect azure-iot-edge:home

# Connect to logging and grant permission to query system info

sudo snap connect azure-iot-edge:log-observe
sudo snap connect azure-iot-edge:mount-observe
sudo snap connect azure-iot-edge:system-observe
sudo snap connect azure-iot-edge:hostname-control
# Allow IoT Edge to connect to the /var/run/iotedge folder and use sockets

sudo snap connect azure-iot-edge:run-iotedge

# Connect IoT Edge to Docker

sudo snap connect azure-iot-edge:docker docker:docker-daemon

クラウド ID を使用してデバイスをプロビジョニングする

これでコンテナーエンジンと IoT Edge ランタイムがデバイスにインストールされたので、クラウド ID と認証情報を使用してデバイスを設定する準備ができました。

Ubuntu、Debian、RHEL
Ubuntu Core スナップ

次のコマンドを使って、対称キー認証で IoT Edge デバイスを構成できます。

sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'

この iotedge config mp コマンドは、デバイス上に構成ファイルを作成し、接続文字列をこの構成ファイルに入力します。

構成の変更を適用します。
```
sudo iotedge config apply
```
構成ファイルを表示する場合は、次の方法で開きます。
```
sudo nano /etc/aziot/config.toml
```

ホームディレクトリに config.toml ファイルを作成し、スナップに対する対称キー認証で IoT Edge デバイスを構成します。
```
sudo nano ~/config.toml
```
接続文字列と次のプロビジョニング設定を使って、手動でプロビジョニングできます。
```
[provisioning]
source = "manual"
connection_string = "REPLACE_WITH_DEVICE_CONNECTION_STRING"
```
プロビジョニング構成の設定について詳しくは、「IoT Edge デバイスの設定を構成する」をご覧ください。
次のコマンドを使って、IoT Edge と ID サービスの構成を設定します。
```
sudo snap set azure-iot-edge raw-config="$(cat ~/config.toml)"
```

モジュールのデプロイ

IoT Edge モジュールをデプロイするには、Azure portal で IoT ハブに移動し、次のようにします。

[IoT Hub] メニューから [デバイス] を選択します。
デバイスを選択して、そのページを開きます。
[モジュールの設定] タブを選択します。
IoT Edge の既定のモジュール (edgeAgent と edgeHub) をデプロイしますが、このペインにモジュールを追加する必要はないため、下部にある [確認 + 作成] を選択します。
このモジュールについて JSON 形式の確認が表示されます。 [作成] を選択して、モジュールをデプロイします。

詳細については、「モジュールを展開する」を参照してください。

構成が成功したことを確認する

IoT Edge デバイスにランタイムが正常にインストールされ、構成されていることを確認します。

ヒント

iotedge コマンドの実行には、昇格された特権が必要です。 IoT Edge ランタイムのインストール後に初めてマシンにサインインし直すと、アクセス許可は自動的に更新されます。それまでは、コマンドの前に sudo を使用します。

IoT Edge システムサービスが実行されていることを確認します。
```
sudo iotedge system status
```
正常な状態の応答では、aziot サービスが実行中または準備完了と表示されます。
サービスのトラブルシューティングが必要な場合は、サービスログを取得します。
```
sudo iotedge system logs
```
check ツールを使用して、デバイスの構成と接続の状態を確認します。
```
sudo iotedge check
```
OK (緑)、警告 (黄色)、エラー (赤) など、さまざまな応答が予想されます。一般的なエラーのトラブルシューティングについては、「Azure IoT Edge に関する一般的な問題の解決策」を参照してください。

ヒント

アクセス許可が更新された後でも、必ず sudo を使用してチェックツールを実行してください。このツールには、構成状態を確認するために、config ファイルにアクセスするための昇格された特権が必要です。

Note

新しくプロビジョニングされたデバイスでは、IoT Edge ハブに関連するエラーが表示される場合があります。

× production readiness: Edge Hub's storage directory is persisted on the host filesystem - ErrorCould not check current state of edgeHub container (運用環境の準備: Edge Hub のストレージディレクトリがホストファイルシステムに保存されています - エラー: edgeHub コンテナーの現在の状態を確認できません)

このエラーは、IoT Edge ハブモジュールがまだ実行されていないことが原因で、新しくプロビジョニングされたデバイスで発生する可能性があります。前の手順で IoT Edge モジュールがデプロイされていることを確認してください。デプロイによって、このエラーが解消されます。

または、状態コードが 417 -- The device's deployment configuration is not set と表示される場合があります。モジュールがデプロイされると、この状態が変化します。
初めてサービスが開始されると、edgeAgent モジュールが実行されていることだけを確認できます。 edgeAgent モジュールが既定で実行され、デバイスにデプロイする追加モジュールのインストールと起動を支援します。

Azure portal でデバイスページを表示して、デバイスとモジュールがデプロイされ、実行されていることを確認します。

モジュールがデプロイされて実行されたら、次のコマンドを使用して、デバイスまたは仮想マシンでそれらを一覧表示します。
```
sudo iotedge list
```

オフラインまたは特定のバージョンのインストール (省略可能)

このセクションの手順は、標準のインストール手順では説明されていないシナリオを対象としています。これには以下が含まれます。

オフラインの間に IoT Edge をインストールする
リリース候補バージョンをインストールする

パッケージマネージャーで使用できない特定のバージョンの Azure IoT Edge ランタイムをインストールする場合は、このセクションの手順を使用します。 Microsoft パッケージのリストには、最近のバージョンとそのサブバージョンの限られたセットしか含まれていないので、これらの手順は、古いバージョンまたはリリース候補バージョンをインストールするユーザーが対象となります。

Ubuntu スナップを使っている場合は、スナップをダウンロードしてオフラインでインストールできます。詳しくは、「スナップをダウンロードしてオフラインでインストールする」をご覧ください。

curl コマンドを使用すると、IoT Edge GitHub リポジトリから直接、コンポーネントファイルをターゲットにすることができます。

Azure IoT Edge リリースに移動し、対象とするリリースバージョンを見つけます。
そのバージョンの [Assets] セクションを展開します。
各リリースには、IoT Edge と ID サービスの新しいファイルがあります。オフラインデバイスに IoT Edge をインストールする場合は、事前にこれらのファイルをダウンロードします。それ以外の場合は、以下のコマンドを使用して、これらのコンポーネントを更新します。
1. IoT Edge デバイスのアーキテクチャに一致する aziot-identity-service ファイルを見つけます。ファイルリンクを右クリックし、リンクのアドレスをコピーします。
2. コピーしたリンクを次のコマンドで使用して、そのバージョンの ID サービスをインストールします。
```
curl -L <identity service link> -o aziot-identity-service.deb && sudo apt-get install ./aziot-identity-service.deb
```
```
curl -L <identity service link> -o aziot-identity-service.rpm && sudo yum localinstall ./aziot-identity-service.rpm
```
  Ubuntu スナップを使っている場合は、スナップパッケージをダウンロードしてオフラインでインストールできます。詳しくは、「スナップをダウンロードしてオフラインでインストールする」をご覧ください。
1. IoT Edge デバイスのアーキテクチャに対応する aziot-edge ファイルを見つけます。ファイルリンクを右クリックし、リンクのアドレスをコピーします。
2. コピーしたリンクを次のコマンドで使用して、そのバージョンの IoT Edge をインストールします。
```
curl -L <iotedge link> -o aziot-edge.deb && sudo apt-get install ./aziot-edge.deb
```
```
curl -L <iotedge link> -o aziot-edge.rpm && sudo yum localinstall ./aziot-edge.rpm
```
  Ubuntu スナップを使っている場合は、スナップパッケージをダウンロードしてオフラインでインストールできます。詳しくは、「スナップをダウンロードしてオフラインでインストールする」をご覧ください。

IoT Edge をアンインストールする

デバイスから IoT Edge のインストールを削除する必要がある場合は、次のコマンドを使用します。

IoT Edge ランタイムを削除します。

sudo apt-get autoremove --purge aziot-edge

IoT Edge を再インストールし、今後同じ構成情報を使用する場合は、--purgeフラグを使用しないでください。 --purge フラグによって、構成ファイルを含め、IoT Edge に関連付けられているすべてのファイルが削除されます。

sudo yum remove aziot-edge

IoT Edge ランタイムを削除します。

sudo snap remove azure-iot-edge

Azure ID サービスを削除します。

sudo snap remove azure-iot-identity

IoT Edge ランタイムが削除されると、作成したコンテナーは停止されますが、デバイスには残っています。すべてのコンテナーを表示して、どのコンテナーが残っているかを確認します。

sudo docker ps -a

2 つのランタイムコンテナーを含め、デバイスからコンテナーを削除します。

sudo docker rm -f <container ID>

最後に、デバイスからコンテナーランタイムを削除します。

sudo apt-get autoremove --purge moby-engine

sudo yum remove moby-cli
sudo yum remove moby-engine

sudo snap remove docker

次のステップ

IoT Edge モジュールのデプロイに進んで、デバイスにモジュールをデプロイする方法を確認します。

次の方法で共有

対称キーを使用して Linux で IoT Edge デバイスを作成およびプロビジョニングする

前提条件

デバイス管理ツール

デバイスの要件

Visual Studio Code 拡張機能

デバイスを登録する

Visual Studio Code を使用して新しいデバイスを登録する

登録済みデバイスを表示し、プロビジョニング情報を取得する

IoT Edge をインストールする

コンテナーエンジンをインストールする

IoT Edge ランタイムをインストールする

スナップを接続する

クラウド ID を使用してデバイスをプロビジョニングする

モジュールのデプロイ

構成が成功したことを確認する

オフラインまたは特定のバージョンのインストール (省略可能)

IoT Edge をアンインストールする

次のステップ

フィードバック

その他のリソース

次の方法で共有

対称キーを使用して Linux で IoT Edge デバイスを作成およびプロビジョニングする

前提条件

デバイス管理ツール

デバイスの要件

Visual Studio Code 拡張機能

デバイスを登録する

登録済みデバイスを表示し、プロビジョニング情報を取得する

IoT Edge をインストールする

コンテナー エンジンをインストールする

IoT Edge ランタイムをインストールする

クラウド ID を使用してデバイスをプロビジョニングする

モジュールのデプロイ

構成が成功したことを確認する

オフラインまたは特定のバージョンのインストール (省略可能)

IoT Edge をアンインストールする

次のステップ

フィードバック

その他のリソース

コンテナーエンジンをインストールする