Japan Azure IoT Support Blog https://docs.microsoft.com/archive/blogs/jpazureiotblog/feed.xml 日本マイクロソフト株式会社の Azure IoT 開発サポートチームの blog です。 Tue, 16 Apr 2019 05:15:00 GMT ja hourly 1 Japan Azure IoT Support Blog 終了のお知らせ https://docs.microsoft.com/archive/blogs/jpazureiotblog/japan-azure-iot-support-blog-%E7%B5%82%E4%BA%86%E3%81%AE%E3%81%8A%E7%9F%A5%E3%82%89%E3%81%9B Wed, 26 Dec 2018 08:30:07 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1325

こんにちは、Azure IoT サポートチームです。

2019 年1 月をもちまして、弊社システム刷新の都合により、本Blog を終了いたします。

 

今後、同様の情報公開は、以下の情報公開専用フォーラムにて行ってまいります。

 

Azure IoT サポートチーム フォーラム
< https://social.msdn.microsoft.com/Forums/ja-JP/home?forum=azureiotsupportteamja >

 

2017 年11 月に開始以来、多くのお客様にご覧いただき、誠にありがとうございました。

読者の皆様のビジネスに多少なりとも貢献できておりましたら幸甚です。

今後ともどうぞよろしくお願いします。]]> IoT Hub の一時的なエラーの対処について https://docs.microsoft.com/archive/blogs/jpazureiotblog/iot-hub-transient-faults Thu, 23 Aug 2018 01:54:18 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1315

IoT Hub との通信において、サービス側のエラーとしてタイムアウト エラーや Internal Server Error などが稀に発生する場合があります。例えば、IoT デバイス上のアプリケーションから、IoT Hub へ HTTPS でメッセージを送信した際、これらのエラーを返すことがありますが、ほとんどの場合サービス側の一時的な負荷やネットワークの問題により発生する一過性の事象と考えられます。マイクロソフトではできる限りこうしたエラーを減らすようサービス品質の向上に努めていますが、ネットワークの状態およびその他の予測不能な要因のため、エラーを完全に防ぐことは現実的に困難です。

 

また、デバイスと IoT Hub の接続は多くの場合パブリックなインターネットを経由しており、インターネットもしくはオンプレミスのネットワークの状態によって一時的なエラーが発生する可能性も考えられるため、IoT デバイス側に何らかの再試行(リトライ) ロジックを実装していただくことを推奨しています。

 

この詳細について、以下のドキュメントにも記載がありますので、ご参考になりますと幸いです。

 

    • 一時的な障害の処理

<https://docs.microsoft.com/ja-jp/azure/architecture/best-practices/transient-faults >

 

    • 再試行パターン

<https://docs.microsoft.com/ja-jp/azure/architecture/patterns/retry >

 

もし時間をおいて複数回リトライしても解消せず、継続してエラーが発生している場合は一時的な問題ではない可能性があるため、必要に応じてサポートまでお問い合わせください。

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

 

]]> Device Provisioning Service のグループ登録で使用する証明書について https://docs.microsoft.com/archive/blogs/jpazureiotblog/device-provisioning-service-certificates-overview Mon, 23 Jul 2018 02:50:36 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1295 Device Provisioning Service では X.509 証明書を使ったデバイスの認証ならびにプロビジョニング (デバイスの登録) をサポートします。その方法としては以下の 2 種類があります。 [1] デバイスの自己署名証明書を使った個別登録 (Individual Enrollment) [2] ルート認証局 (Root CA) や中間認証局 (Intermediate CA) で署名された証明書を使うグループ登録 (Group Enrollment) 今回は [2] のグループ登録で使用する証明書とその注意点についてご紹介します。
X.509 証明書を使ったデバイス登録では、SSL / TLS での接続時にデバイスがクライアント証明書を Device Provisioning Service に対して提示します。Device Provisioning Service は提示された証明書を検証して、デバイス登録の可否および対象となる登録エントリを判断します。そして該当する登録エントリで指定された接続情報をデバイスに対して返すことにより、デバイスは IoT Hub に接続することが可能になります。 clip_image001[4]
ここでグループ登録に使用される証明書は一般に以下のような証明書チェーンを構成しています。左端が Root CA の発行する自己署名証明書、右端がデバイス個別のクライアント証明書です。 clip_image002[4]
また Device Provisioning Service における検証済みの証明書とは、Device Provisioning Service にアップロード後、Proof of Possession (所有者証明) が行われた証明書を指します。検証済みの証明書は Azure ポータル上では Verified として表示されます。 clip_image003[4]
Device Provisioning Service (DPS) ではデバイスが提示したクライアント証明書を元に、以下のような流れでデバイス登録の可否を判断します。 1. デバイスが提示した証明書チェーンが有効か（例. 有効期限が切れていないか）。Yes なら次へ進む。 2. 証明書チェーンの中に DPS に登録されて検証済み (Verified) の証明書があるか。Yes なら次へ進む。 3. 個別登録 (Individual Enrollment) にエントリがあるか。あればプロビジョニングを開始する。なければ次へ。 4. グループ登録に中間証明機関 N の証明書の登録があるか。あればプロビジョニングを開始する。なければ次へ。 5. グループ登録に中間証明機関 N-1 の証明書の登録があるか。あればプロビジョニングを開始する。なければ次へ。 6. (証明書チェーンをたどって繰り返す） 7. グループ登録に中間証明機関 1 (ルート証明機関の場合あり) の証明書の登録があるか。あればプロビジョニングを開始する。なければプロビジョニングしない。
ここで重要になるのは、デバイスは Device Provisioning Service に対して、検証済みの証明書までたどることができる証明書チェーンを提示する必要がある点です。 例えば以下のようにルート証明書が検証済みの証明書として登録されており、かつ中間証明機関 2 の証明書がグループ登録の証明書として登録されているケースを考えます。 clip_image004[4]
この時、デバイスが提示する証明書チェーンが上記のように中間証明書までしかなく、検証済みの証明書までたどれない場合は、検証手順 2 で失敗します。そのためデバイスは以下のように完全な証明書チェーンを提示する必要があります。 clip_image005[4]
なお、グループ登録用に指定されただけで、検証されていない中間 (ルート) 証明書は、証明書チェーンの検証には使われません。そのため、検証済みの証明書にいたる完全な証明書チェーンをデバイスから送る必要があります。 また、SSL / TLS のハンドシェイクで中間証明書を含む完全な証明書チェーンを送付するかどうかは、デバイスの OS および Device Provisioning Service SDK の実装、 SDK に渡す証明書の情報に依存するため、個別に確認する必要があります。 例えば Windows OS の場合は証明書チェーンを構成するルート証明書や中間証明書を OS の証明書ストアに追加することで、SSL / TLS 通信時の証明書チェーンにも含まれるようになります。 証明書チェーンが送付されているかどうかは、 SSL / TLS のハンドシェイクのパケットから確認できます。以下は Wireshark を使った確認例です。 clip_image006[4]
この場合はクライアント証明書 (myedge222) の部分しか送られていません。 clip_image007[4]
こちらではクライアント証明書の発行元の中間認証局の証明書 (Azure IoT Hub Intermediate Cert Test Only) も同時に送られています。 X.509 証明書を使ったグループ登録を検証される際のお役に立ちましたら幸いです。]]> Azure IoT Edge の GA (一般提供) について https://docs.microsoft.com/archive/blogs/jpazureiotblog/azure-iot-edge-%E3%81%AE-ga-%E4%B8%80%E8%88%AC%E6%8F%90%E4%BE%9B-%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6 Mon, 02 Jul 2018 23:42:29 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1125 S.M です。   2018 年 6 月 27 日に Azure IoT Edge が GA (一般提供) となりました。IoT Edge は主に直接インターネット経由で IoT Hub に接続できないデバイスに対してクラウドテクノロジーを提供するための製品になります。GA に伴い行われた主な更新は以下の通りになります。   ● IoT EdgeのソースコードはGitHubから入手いただけるようになりました。   ● IoT Edge のランタイムはオープンソースコンテナーの Moby でサポートされるようになりました。 *Docker CE and Docker EEも引き続き利用可能ですが、Microsoft はこれら製品の不具合などに対して修正ができないことから、Moby の利用を推奨しています。なお、Preview時に作成いただいた既存のDockerベースのモジュールは引き続きそのままご利用いただけます。   ● IoT Edge デバイスの Certification プログラムが開始されました。なお、IoT Edge デバイスCertification の取得は必須ではございません。   ● Cognitive Service の Custom Vision が IoT Edge 上で利用できるようになりました。   GA の詳細は下記資料にまとめられています。 https://azure.microsoft.com/en-us/blog/azure-iot-edge-generally-available-for-enterprise-grade-scaled-deployments/   Azure IoT Edge の利用が正式にサポートされているOSの一覧も資料として公開させていただきましたので、こちらもあわせてご確認いただければと思います。   Azure IoT Edge Support https://docs.microsoft.com/en-us/azure/iot-edge/support]]> IoT Hub、IoT Edge のゲートウェイとリーフデバイスの時刻について https://docs.microsoft.com/archive/blogs/jpazureiotblog/iot-hub-iot-edge-gateway-leaf-device-time-sync Wed, 27 Jun 2018 23:35:27 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1105

IoT Hub、IoT Edge のゲートウェイとリーフデバイスの時刻が一致しない場合、接続が行えなくなる事象が発生する場合があります。

 

IoT Edge のゲートウェイは、リーフデバイスの代わりに、IoT Hub とセキュアな接続を行うために、SAS トークンを使用します。

そして、このSAS トークンは、生成を行うクライアントの現在時刻を元に有効期限を設定しており、1 時間に1 回生成され直されます。

実際、edgeHub のログに以下のように、 “Getting new token from the client…” のログが定期的に表示されます。

 

[INF] - Attempting to connect to IoT Hub for client <リーフデバイス名> via AMQP...

[INF] - Existing token not found for <リーフデバイス名>. Getting new token from the client...

[INF] - Device connection removed for device <リーフデバイス名>

 

- SAS トークンについて

<https://docs.microsoft.com/ja-jp/azure/iot-hub/iot-hub-devguide-security#security-tokens >

=======================

IoT Hub では、デバイスとサービスの認証にセキュリティ トークンを使用することにより、ネットワーク経由でのキーの送信を回避します。

(中略)

{expiry}

1970 年1 月1 日の00 時00 分00 秒UTC からのエポック秒で表されるUTF8 文字列。

(中略)

注意

トークンの有効期間は IoT Hub コンピューターで検証されるため、トークンを生成するコンピューターのクロックのずれは最小限である必要があります。

=======================

 

この時、edgeHub のログに以下のエラーが表示されます。

 

[ERR] - Error creating or updating the cloud proxy for client <リーフデバイス名>

 

上記のエラーに関連する事例に、以下の記載もあります。

 

[V2] Windows container sometimes doesn't sync time with host, cause edgeHub failed to connect to IoT Hub. #565

<https://github.com/Azure/iot-edge/issues/565 >

=======================

Since edge runtime requires secure connection with IoT Hub, hence the time synchronization of IoT Hub DeviceClient does matter. If the client device time goes ahead (or behind) too much, IoT Hub will reject such connection from client. Then we'll got operation timeout at client side.

=======================

 

 

IoT Edge ゲートウェイを使わない場合でも、日本で動作していたデバイスを海外に持ち込んだ際に、デバイスの時刻を現地時間に設定してもタイムゾーンが日本時間のままになっていたことで、常に有効期限を過ぎたトークンが生成されることにより、接続できなくなった事例もありますので、ご留意ください。

 

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

]]> Azure Portal の IoT Hub ブレードが正常に表示されない場合の切り分け方法 https://docs.microsoft.com/archive/blogs/jpazureiotblog/azure-portal-%E3%81%AE-iot-hub-%E3%83%96%E3%83%AC%E3%83%BC%E3%83%89%E3%81%8C%E6%AD%A3%E5%B8%B8%E3%81%AB%E8%A1%A8%E7%A4%BA%E3%81%95%E3%82%8C%E3%81%AA%E3%81%84%E5%A0%B4%E5%90%88%E3%81%AE%E5%88%87 Fri, 11 May 2018 02:12:37 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1085 Azure Portal 上で IoT Hub (またはその他サービスのブレードも含め) の表示が正常に行われない現象が発生した場合の切り分け方法についてご案内いたします。この現象は、ブレード内の表示内容に更新 (新しいサービスのボタンが追加された等) が行われた場合、ブラウザが持つキャッシュ情報との整合性がとれないため発生する場合があります。この現象をご確認いただいた際は、切り分けのため、ブラウザのキャッシュをクリアしていただくか、キャッシュの影響を受けないブラウザの InPrivate モードをご利用いただき、表示が改善されるかご確認ください。 こちらのブログでは Internet Explorer と Google Chrome について対処策をご紹介いたします。この方法は IoT Hub に限らず Azure ポータルの表示で何か問題があった際に、最初の切り分けとしてご案内させていただくことが多いものとなりますため、他サービス含め今後もし同様の事象がありました際にお役に立ちましたら幸いです。 なお、こちらの切り分けを行っていただいても問題が解決されない場合は弊社サポートまでお問い合わせください。 ------------------------------------------------------------------------  1. InPrivate ブラウズ モードの起動方法 （Internet Explorer） ------------------------------------------------------------------------ InPrivate ブラウズ モードでは、既存のブラウザー キャッシュやセッションに影響されない通信が可能となります。 そのため、ブラウザーのキャッシュなどの影響を受けている事象について、回避が可能となります。  
  1. Internet Explorer を起動します。
  2. Ctrl + Shift + P を押下し InPrivate ブラウズ モードを起動します。
  3. InPrivate モードにて再度お試しください。
  Title: InPrivate ブラウズ URL: https://blogs.msdn.microsoft.com/dsazurejp/2015/08/24/azure-5/    ------------------------------------------------------------------------  2. キャッシュ クリアについて （Internet Explorer） ------------------------------------------------------------------------ InPrivate ブラウズ モードにて事象が改善しない場合は、Web ブラウザーのキャッシュ クリアをお願いいたします。 以下に、手順をご案内いたします。   ※ こちらの手順をおこなっていただく際は、ID やパスワードを使用してサインインされている Web サイトの履歴も削除される事となります。    このため、あらためてサインインされる場合はパスワードなどのサインイン情報を再度入力が必要になりますことをご留意くださいますようお願いいたします。  
  1. Internet Explorer を起動します。
  2. 画面上部右側の [歯車 マーク (ツール) ] - [インターネット オプション (O)] の順にクリックします。
  3. [全般] タブ内の 「閲覧の履歴」 にあります [削除 (D) ] ボタンをクリックし ます。
  4. [閲覧の履歴の削除] 内の [インターネット一時ファイルおよび Web サイトのファイル (D)]、[クッキーと Web サイトのファイル (T)]、[クッキーと Web サイトデータ (O)]、[履歴 (H)] に、チェックを入れ、[削除] をクリックします。
  5. インターネット オプションを閉じ、Internet Explorer を終了します。
  6. Internet Explorer を起動し Azure のアカウント ポータルへサインインします。
   ------------------------------------------------------------------------ 3. シークレット ウィンドウ表示方法（Google Chrome） ------------------------------------------------------------------------ シークレット ウィンドウ モードでは、既存のブラウザー キャッシュやセッションに影響されない通信が可能となります。 そのため、ブラウザーのキャッシュなどの影響を受けている事象について、回避が可能となります。  
  1. Google Chrome ウィンドウを開きます。
  2. ブラウザー ウィンドウの右上にある Chrome メニュー をクリックします。
  3. [シークレット ウィンドウを開く] を選択します。
  4. 右上にグレーの人のアイコンが付いたウィンドウが開きます。
  5. シークレット モードを閉じるには、各シークレット ウィンドウの右上にある [X] をクリックします。
  ※ アカウントが Windows 10 の家族向け機能の一部として設定されている場合、シークレット モードはご利用いただけません。 ※ Windows、Linux、Chrome OS の場合は Ctrl+Shift+N キー、Mac の場合は Command -shift-N キーを押す方法でもシークレット ウィンドウを開くことができます。   Title: シークレット モードでプライベート ブラウジングを行う URL: https://support.google.com/chrome/answer/95464?hl=ja   ------------------------------------------------------------------------ 4. キャッシュ クリア方法（Google Chrome） ------------------------------------------------------------------------
  1. Google Chrome を起動します。
  2. 画面右上の [≡] - [履歴 <3 ] をクリックします。
  3. [履歴閲覧データの消去...] をクリックして [閲覧履歴データを消去する] ダイアログを表示します。
  4. [閲覧履歴]、[Cookie と他のサイトやプラグインのデータ] 等、すべてのチェックボックスのチェックをオンにします。
  5. [閲覧履歴データを消去する] ボタンをクリックします。
]]> クラウド側から IoT Edge 上のモジュールの状態を監視する方法 https://docs.microsoft.com/archive/blogs/jpazureiotblog/monitor-iot-edge-modules-from-cloud Wed, 25 Apr 2018 09:08:44 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1075

クラウド側から IoT Edge 上のモジュールの状態を監視する方法をご案内します。

ただし、Azure IoT Edge は現在プレビューであるため、一般公開時には変更となる可能性がございます点にご留意ください。

 

1. Azure ポータルから状態を確認

=======================

以下の手順でAzure ポータルよりご確認いただくことができます。

 

(1)         Azure ポータルのIoT Hub の左側のペインから [IoT Edge (preview)] をクリックし、右側のペインで IoT Edge デバイスの デバイス ID をクリックします。

 

clip_image002

 

(2)         [デバイスの詳細] 画面の下部の Deployed Modules タブで$edgeAgent と$edgeHub などの各モジュールのRUNTIME STATUS がrunning となっていることが確認できます。

 

clip_image004

 

2. プログラムから確認する手順

=======================

プログラムから監視する場合は、HTTP REST API を利用することでモジュール ツインから状態を取得可能です。

 

    • Azure IoT REST –APIs – Module Twin

< https://github.com/jonbgallant/azure-iot-rest#module-twin >

 

以下にREST API を呼び出す時に設定すべき詳細なパラメーターが公開されています。

api-version が 2017-11-08-preview であることにご注意ください。

< https://github.com/jonbgallant/azure-iot-rest/blob/master/data-plane/devices/modules/module-twin.py >

 

ご参考までに、上記を元にC# で作成した REST API の呼び出しサンプルを以下に記載します。

 

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Threading.Tasks;

using System.Globalization;

using System.Net;

using System.Net.Http;

using System.Security.Cryptography;

using System.Net.Http.Headers;

 

namespace IoTREST

{

    public class IoTRESTClient

    {

        private string IoTHubName;

        private string httpResult;

        private string Key;

        private string policyName;

        public IoTRESTClient(string _IoTHubName, string _Key, string _policyName)

        {

            IoTHubName = _IoTHubName;

            httpResult = "";

            Key = _Key;

            policyName = _policyName;

        }

        public string generateSasToken(string resourceUri, string key, string policyName, int expiryInSeconds = 3600)

        {

            TimeSpan fromEpochStart = DateTime.UtcNow - new DateTime(1970, 1, 1);

            string expiry = Convert.ToString((int)fromEpochStart.TotalSeconds + expiryInSeconds);

 

            string stringToSign = WebUtility.UrlEncode(resourceUri).ToLower() + "\n" + expiry;

 

            HMACSHA256 hmac = new HMACSHA256(Convert.FromBase64String(key));

            string signature = Convert.ToBase64String(hmac.ComputeHash(Encoding.UTF8.GetBytes(stringToSign)));

 

            string token = String.Format(CultureInfo.InvariantCulture, "SharedAccessSignature sr={0}&sig={1}&se={2}", WebUtility.UrlEncode(resourceUri).ToLower(), WebUtility.UrlEncode(signature), expiry);

 

            if (!String.IsNullOrEmpty(policyName))

            {

                token += "&skn=" + policyName;

            }

 

            return token;

        }

 

        public async void GetModuleTwin(string deviceId, string moduleId)

        {

            HttpClient client = new HttpClient();

            string uri = "https://" + IoTHubName + ".azure-devices.net/twins/" + deviceId + "/modules/"+ moduleId + "?api-version=2017-11-08-preview";

            Console.WriteLine("uri:" + uri);

            HttpResponseMessage response;

 

            string sasToken = generateSasToken(IoTHubName + ".azure-devices.net", Key, policyName);

            Console.WriteLine("sasToken:" + sasToken);

            client.DefaultRequestHeaders.Add("Authorization", sasToken);

            try

            {

                response = await client.GetAsync(uri);

                httpResult = await response.Content.ReadAsStringAsync();

                Console.WriteLine(response.StatusCode.ToString() + "\r\n" + httpResult);

            }

            catch (Exception ex)

            {

                Console.WriteLine();

                Console.WriteLine("Error in sample: {0}", ex.Message);

 

            }

        }

        class Program

        {

 

            static void Main(string[] args)

            {

                IoTRESTClient client = new IoTRESTClient("{IoT Hub Name}", "{Shared access keys}", "{Policy Name, e.g. iothubowner}");

                client.GetModuleTwin("test-edge-device1", "$edgeAgent");

                Console.ReadKey();

                Console.WriteLine("Press any key to exit...");

            }

       }

    }

}

 

このサンプルを使って確認した手順を記載しますので、ご参考になりましたら幸いです。

    1. Visual Studio 2017 のC # のコンソールアプリケーションのプロジェクトを作成します。
    1. 添付のソースを貼り、以下を変更します。

76 行目: {IoT Hub Name} はIoT Hub の名前、{Shared access keys} はiothubowner のプライマリ キー(接続文字列ではありません)、{Policy Name, e.g. iothubowner} は iothubowner

77 行目: test-edge-device1 はIoT Edge のデバイスID、$edgeAgent はそのまま使用すればedgeAgent の監視、$edgeHub に変更すればedgeHub の監視になります。

    1. ビルドします。
    1. コマンドプロンプトから exe を実行します。

 

 

3. デプロイの監視手順

=======================

「Edge エージェントと Edge ハブのモジュール ツインのプロパティ」のドキュメントに関連する、デプロイの監視手順については、以下のドキュメントをご参照ください。

 

    • 大規模なIoT Edge モジュールの展開と監視- プレビュー

< https://docs.microsoft.com/ja-jp/azure/iot-edge/how-to-deploy-monitor >

 

「デプロイの監視」の項目をご参照ください。

 

 

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

 

]]> Azure IoT Edge で透過的なゲートウェイ デバイスを作成する手順の一例 https://docs.microsoft.com/archive/blogs/jpazureiotblog/azure-iot-edge-transparent-gateway Wed, 18 Apr 2018 23:18:31 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=1025 (更新 2018/07/20) - IoT Edge の一般提供 (GA) 開始後の情報について追記しました。  

IoT Edge は現在プレビューですが、「透過的なゲートウェイとして動作する IoT Edge デバイスを作成する - プレビュー」のドキュメントの具体的な手順に関するご質問をいただいておりますので、私の手元で確認した手順を一つの構成例としてご案内します。

 

弊社が公開している構成例として、すでに以下のようなページがありますが、今回ご案内する手順では、両方を参考にして、後者の、IoT Edge のゲートウェイをLinux (ローカルPC 上の仮想マシン)、IoT デバイスをRaspberry Pi 3 としています。

 

・IoT Edge のゲートウェイがWindows、IoT デバイスがRaspberry Pi 3 の例

 

IOT EDGE PYTHON RASPBERRYPI CONNET TRANSPARENT GATEWAY

< https://github.com/Azure-Samples/iot-edge-python-raspberrypi-connect-transparent-gateway >

 

・IoT Edge のゲートウェイとIoT デバイスをともにLinux のAzure VM 1 つの中に持つ例

 

Azure IoT Edge Hands On Labs

< https://github.com/AzureIoTGBB/azure-iot-edge-hol-linux >

 

Lab 1,2 をご参照ください。

 

 

    1. 今回前提とする構成

 

今回は、最小構成として、以下の図のような、IoT Hub に、IoT Edge のゲートウェイ1 つがつながっていて、そのゲートウェイを通じて IoT Hub と透過的(transparent) に通信するデバイス(リーフ デバイス, leaf device) 1 つがつながっていることを前提とします。

 

clip_image002

 

IoT Edge のゲートウェイには、今回、(作業用 PC の) Windows 10 Enterprise x64 1709 上のHyper-V の仮想マシン(最大メモリ4GB、外部ネットワークに接続) として、Ubuntu 16.04 LTS をインストールしています。

 

リーフデバイスには、Raspberry Pi 3 を用意し、以下の手順でインストールしています。（「Raspberry Pi の Azure IoT Hub への接続 (Python)」の「Pi の Raspbian オペレーティング システムのインストール」の手順と同様です。）

 

Windows 10 Enterprise x64 1709 上で以下を実施します。

(a)         < https://www.raspberrypi.org/downloads/raspbian/ > のサイトから、Raspbian Stretch with desktop の zip ファイルをダウンロードし、解凍します。

(b)         Etcher SD カード書き込みユーティリティをダウンロードしてインストールします。

(c)          micro SD カード(私の手元では64GB のものを使用しています) をWindows PC に接続します。

(d)         Etcher を実行し、[Select image] をクリックして、(a) で解凍したRaspbian イメージ(今回は2018-03-13-raspbian-stretch.img) を選択します。

(e)         micro SD カード ドライブを選択します。 適切なドライブが既に選択されている場合があります。

(f)          [Flash (フラッシュ)] をクリックして、micro SD カードにRaspbian をインストールします。

(g)         インストールが完了したら、コンピューターからmicro SD カードを取り出します。Etcher では完了時にmicro SD カードを自動的に取り出すか、マウント解除するため、micro SD カードを直接取り出しても問題ありません。

(h)         micro SD カードをRaspberry Pi 3 に挿入します。

 

 

    1. SSH の設定と接続確認

 

(a)         リーフデバイス(Raspberry Pi 3) 側で、SSH を有効にします。

    1. Raspberry Pi 3 にモニター、キーボード、マウスを接続し、Raspberry Pi 3 を起動してから、pi をユーザー名として、raspberry をパスワードとして使用してRaspbian にログインします。(起動するだけで、自動的にログインされている場合があります。)
    1. Raspberry アイコン> [Preferences](設定) > [Raspberry Pi Configuration](Raspberry Pi 構成) の順にクリックします。
    1. [Interfaces] (インターフェイス) タブで、[SSH] を[Enable] (有効) に設定し、[OK] をクリックします。

(b)         Raspberry Pi 3 にイーサネット ケーブルを使用して有線ネットワークに接続します。

(c)          Terminal を起動し、ifconfig を実行して、eth0 の inet に表示されるIP アドレスをメモします。

(d)         Hostname を変更しておきます。

    1. nano で /etc/hostname を開きます

$ sudo nano /etc/hostname

    1. raspberrypi から任意の名前に変更します
    1. Ctrl-o とEnter で保存します
    1. Ctrl-x でnano を終了します
    1. 再起動します。

$ sudo reboot

(e)         passwd でパスワードも変更しておきます。

(f)          Raspbian を更新しておきます。

$ sudo apt update && sudo apt full-upgrade -y

(g)         IoT Edge ゲートウェイ(Ubuntu) 側で、SSH を有効にします。

    1. Terminal を起動します。
    1. パッケージの管理を行うためのaptitudeをインストールします。

$ sudo apt-get install aptitude

    1. aptitudeを使ってsshを導入します。

$ sudo aptitude install ssh

    1. ifconfig を実行して、eth0 のinet に表示されるIP アドレスをメモします。

(h)         Windows 10 (作業用PC) にWindows 版の PuTTY をダウンロードしてインストールします。

(i)           PuTTY を起動して、(c) のIP アドレスでSSH 接続し、ログインできるか確認します。

(j)          PuTTY をもう1 つ起動して、(g) のIP アドレスでSSH 接続し、ログインできるか確認します。

 

    1. IoT Hub の作成

 

(a)         「Linux または MacOS のシミュレートされたデバイスへの Azure IoT Edge のデプロイ - プレビュー」の「IoT Hub の作成」の手順に従って、[F1 - Free] レベルのIoT Hub を作成します。

(b)         Azure ポータル上で作成されたIoT Hub をクリックし、左側のペインの[共有アクセスポリシー] をクリックし、右側に表示される[iothubowner] をクリックして、表示される「接続文字列 – プライマリキー」の値をメモします。

 

clip_image004

 

    1. IoT Edge デバイスの登録

 

(a)         「Linux または MacOS のシミュレートされたデバイスへの Azure IoT Edge のデプロイ - プレビュー」の「IoT Edge デバイスを登録する」の手順に従って、IoT Edge ゲートウェイの名前を登録します。今回、以下の[デバイスID] をIoT Edge ゲートウェイの hostname と同じにしました。

 

clip_image006

 

(b)         登録されたデバイスID をクリックし、表示される「接続文字列 – プライマリキー」の値をメモします。

 

clip_image008

clip_image010

 

 

    1. IoT Edge ゲートウェイ(Ubuntu) 側の準備

 

以下は、IoT Edge ゲートウェイ(Ubuntu) へのSSH 通信を行っている PuTTY 上で実行します。

 

(a)         パッケージを更新します。

$ sudo apt-get update

(b)         pip をインストールします。

$ sudo apt-get install python-pip

(c)          curl がない場合はインストールします。

$ sudo apt install curl

(d)         Docker for Linux をインストールします。(参考：Get Docker CE for Ubuntu)

$ curl -fsSL get.docker.com -o get-docker.sh

$ sudo sh get-docker.sh

(e)         Ubuntu に現在ログインしているユーザーアカウントがルート権限を持たない場合、Docker admin group にそのユーザーアカウントを追加することでルート権限でコンテナを実行できます。以下を実行後、いったんログアウトし、再度ログインすることで有効になります。

$ sudo usermod -aG docker <Ubuntu に現在ログインしているユーザーアカウント>

(f)          Azure IoT Edge コントロールスクリプトをインストールします。

$ sudo pip install -U azure-iot-edge-runtime-ctl

(g)         iothub-explorer tool をインストールします。

$ sudo apt-get install nodejs

$ sudo apt-get install npm

$ sudo npm install -g iothub-explorer

インストールしたバージョンを確認し、動作していることを確認します。

$ iothub-explorer –version

「/usr/bin/env: ‘node’: No such file or directory」のエラーが出る場合は、先に以下を実行します。

$ sudo ln -s /usr/bin/nodejs /usr/bin/node

iothub-explorer –version を実行すると、今回は 1.2.1 と表示されました。

(h)         .NET Core をインストールします。(参考：Prerequisites for .NET Core on Linux)

$ curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

$ sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/microsoft.gpg

$ sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/microsoft-ubuntu-xenial-prod xenial main" > /etc/apt/sources.list.d/dotnetdev.list'

$ sudo apt-get update

$ sudo apt-get install dotnet-sdk-2.1.4

インストールしたバージョンを確認し、動作していることを確認します。

$ dotnet --version

インストールしたバージョン通り、2.1.4 と表示されます。

(i)           Azure IoT C SDK の “modules-preview” ブランチをクローンします。

git がインストールされていない場合はインストールします。

$ sudo apt install git

$ git clone -b modules-preview https://github.com/Azure/azure-iot-sdk-c

(j)          リーフデバイスがIoT Edge ゲートウェイ経由で IoT Hub までの通信には TLS 接続を行います。そのための自己署名証明書作成の作業用ディレクトリとして edge ディレクトリを作成し、そこに移動します。

$ mkdir edge

$ cd edge

(k)         証明書作成のスクリプトを上記ディレクトリにコピーします。

$ cp ~/azure-iot-sdk-c/tools/CACertificates/*.cnf .

$ cp ~/azure-iot-sdk-c/tools/CACertificates/*.sh .

(l)           certGen.sh を実行可能にします。

$ chmod 700 certGen.sh

(m)       証明書チェーンを作るためのルート証明書と中間証明書を作成します。

$ ./certGen.sh create_root_and_intermediate

certs ディレクトリに、以下のファイルができることを確認します。

$ ls certs

azure-iot-test-only.chain.ca.cert.pem      azure-iot-test-only.root.ca.cert.pem

azure-iot-test-only.intermediate.cert.pem

(n)         IoT Edge ゲートウェイ自体のデバイス固有の証明書を作成します。

$ ./certGen.sh create_edge_device_certificate myGateway

※ この時、myGateway の部分は変更せず、そのままにしてください。

certs ディレクトリに、new-edge-device.cert.pem とnew-edge-device.cert.pfx が追加されます。

(o)         これによって公開鍵と秘密鍵が作成されます。certs ディレクトリに移動して、そこで公開鍵の完全なチェーンを作ります。

$ cd certs

$ cat ./new-edge-device.cert.pem ./azure-iot-test-only.intermediate.cert.pem ./azure-iot-test-only.root.ca.cert.pem > ./new-edge-device-full-chain.cert.pem

 

 

    1. リーフデバイス(Raspbian) 側の準備

 

以下は、リーフデバイス(Raspbian) へのSSH 通信を行っているPuTTY 上で実行します。

 

(a)         IoT Edge ゲートウェイのIP アドレス(2-(g) でメモしたもの) を、リーフデバイス側から見えるようにします。

$ sudo nano /etc/hosts

ファイルの最も下の行に以下のように記載します。

<2-(g) でメモしたIoT Edge ゲートウェイのIP アドレス> mygateway.local

※この時、mygateway.local は変更せずそのままにしてください。

Ping してリーフデバイス側から IoT Edge ゲートウェイに通信できることを確認します。

$ ping mygateway.local

(b)         5-(m) で作成したルート証明書を、リーフデバイスにインストールします。

    1. こちらにもedge ディレクトリとその下のcerts ディレクトリを作成します。

$ mkdir edge

$ cd edge

$ mkdir certs

$ cd certs

    1. azure-iot-test-only.root.ca.cert.pem をこのディレクトリにコピーします。

今回は、IoT Edge ゲートウェイ側で sudo nano azure-iot-test-only.root.ca.cert.pem を実行し、内容全部（-----BEGIN CERTIFICATE-----から-----END CERTIFIATE----- まで含めて全部）を、リーフデバイス側でもsudo nano azure-iot-test-only.root.ca.cert.pem を実行してコピー、Ctrl-o とEnterで保存しました。

    1. これを以下の手順でインストールします。

$ openssl x509 -in azure-iot-test-only.root.ca.cert.pem -inform PEM -out azure-iot-test-only.root.ca.cert.crt

$ sudo mkdir /usr/share/ca-certificates/extra

$ sudo cp azure-iot-test-only.root.ca.cert.crt /usr/share/ca-certificates/extra/azure-iot-test-only.root.ca.cert.crt

$ sudo dpkg-reconfigure ca-certificates

    1. 最後のコマンドを実行すると、証明書をルートストアにインストールすることについて警告が出ますが、yes をハイライトさせてEnter で<Ok> します。

 

clip_image012

 

    1. 次の画面では以下の赤いスペース部分のようにextra/azure-iot-test-only.root.ca.cert.crt の[ ] がブランクになっています。

 

clip_image014

 

ここでスペースを押し、extra/azure-iot-test-only.root.ca.cert.crt が [*] になるようにしてから、Enter で <Ok> します。

 

clip_image016

 

    1. 確認のために、以下を実行し、末尾に「extra/azure-iot-test-only.root.ca.cert.crt」があることを確認します。

$ sudo cat /etc/ca-certificates.conf

 

 

    1. IoT Edge ゲートウェイの開始

 

以下は、IoT Edge ゲートウェイ(Ubuntu) へのSSH 通信を行っている PuTTY 上で実行します。

 

    1. 以下を実行して、IoT Edge ゲートウェイとしてのセットアップを行います。

$ cd ~

$ sudo iotedgectl setup --connection-string "<4-(b) のIot Edge ゲートウェイの接続文字列>" --edge-hostname mygateway.local --device-ca-cert-file /home/<Iot Edge ゲートウェイのUbuntu のログインユーザー名>/edge/certs/new-edge-device.cert.pem --device-ca-chain-cert-file /home/<Iot Edge ゲートウェイのUbuntu のログインユーザー名>/edge/certs/new-edge-device-full-chain.cert.pem --device-ca-private-key-file /home/<Iot Edge ゲートウェイのUbuntu のログインユーザー名>/edge/private/new-edge-device.key.pem --owner-ca-cert-file /home/<Iot Edge ゲートウェイのUbuntu のログインユーザー名>/edge/certs/azure-iot-test-only.root.ca.cert.pem

      • ここでも、--edge-hostname の mygateway.local は変更せず、そのままにしてください。
    1. 「Please enter the Edge Agent private key passphrase. Length should be >=4 and <= 1023:」と表示されたら12345 と入力し Enter を押します。
    1. 再度入力を求められるので同じようにします。
    1. IoT Edge ランタイムを起動します。

$ sudo iotedgectl start

    1. IoT Edge ランタイムを構成しているコンテナ/モジュール のedgeAgent が動作していることを確認します。

$ sudo docker ps

以下のように表示されます。

CONTAINER ID        IMAGE                                      COMMAND                   CREATED             STATUS              PORTS               NAMES

8d8178dc82f6        microsoft/azureiotedge-agent:1.0-preview   "/usr/bin/dotnet Mic…"   2 minutes ago       Up 2 minutes                            edgeAgent

    1. 以下を実行すれば edgeAgent のログも確認できます。

$ sudo docker logs -f edgeAgent

 

 

    1. リーフデバイス側からの通信

 

(a)         今回は例として「Azure IoT Edge Hands On Labs - Module 2」のサンプルを動作させてみます。

    1. この Lab のサンプルをクローンします。

$ cd ~

$ git clone http://github.com/azureiotgbb/azure-iot-edge-hol-linux

    1. Python SDK のプレビューバージョンのライブラリをセットアップ、ビルドします。

$ git clone --recursive -b modules-preview http://github.com/azure/azure-iot-sdk-python

$ cd ~/azure-iot-sdk-python/build_all/linux

$ sudo ./setup.sh

$ sudo ./build.sh

    1. ビルドが終わったら、Lab のサンプルのソリューション ディレクトリにコピーします。

$ cp ../../device/samples/iothub_client.so ~/azure-iot-edge-hol-linux/module2

(b)         IoT Hub にリーフデバイスを登録します。

    1. Azure ポータルのIoT Hub の左側のペインで、[デバイス エクスプローラー] をクリックします。
    1. [追加] をクリックし、[デバイスの追加] で [デバイスID] にリーフデバイスの名前を入力し、[保存] します。今回は、2-(d) で設定した hostname と同じにしました。

 

clip_image018

 

(c)          追加されたデバイスID をクリックし、[デバイスの詳細] 画面で「接続文字列 – プライマリ キー」をメモします。

 

clip_image020

 

(d)         この接続文字列の末尾に「;GatewayHostName=mygateway.local」(今回は mygateway.local を変更せずそのまま使ってください）を入れ、Python スクリプトに記入します。

$ cd ~/azure-iot-edge-hol-linux/module2

$ nano iotdevice.py

以下の行を見つけ、接続文字列を置き換えます。

connection_string = "<IoT Device connection string here>"

Ctrl-o、Enterで保存し、Ctrl-xで終了します。

これを行うことで、指定した IoT Edge ゲートウェイを通じてIoT Hub にリーフデバイス(上のPython スクリプト) が接続しに行きます。

(e)         Azure ポータルのIoT Hub の左側のペインの [IoT Edge (preview)] をクリックし、IoT Edge ゲートウェイのデバイスID をクリックします。

 

clip_image022

 

(f)          画面上部の[Set Modules] をクリックします。

 

clip_image024

 

(g)         [1 Add Modules (optional)] では何もせず画面下部の[Next] をクリックします。

(h)         [2 Specify Routes (optional)] では、以下のようになっていることを確認し、画面下部の[Next] をクリックします。

 

clip_image026

 

これは、$upstream はクラウド上のIoT Hub に送信する、ということを意味します。この route は全てのメッセージ(/*) を受け取り、クラウドに送ります。

 

(i)           [3 Review Template (optional)] では、そのまま [Submit] をクリックします。

(j)          これにより、IoT Edge ゲートウェイ上には edgeHub が起動します。IoT Edge ゲートウェイと通信しているPuTTY 上で以下を実行して確認できます。

$ sudo docker ps

CONTAINER ID        IMAGE                                      COMMAND                  CREATED             STATUS              PORTS                                          NAMES

670d08c9c3c7        microsoft/azureiotedge-hub:1.0-preview     "scripts/linux/start…"   3 minutes ago       Up 3 minutes        0.0.0.0:443->443/tcp, 0.0.0.0:8883->8883/tcp   edgeHub

8d8178dc82f6        microsoft/azureiotedge-agent:1.0-preview   "/usr/bin/dotnet Mic…"   2 hours ago         Up 2 hours                                                          edgeAgent

(k)         以下のようにedgeHub のログを確認できます。

$ sudo docker logs -f edgeHub

以下のような、ポート8883 (MQTT over SSL, TLS 認証を使ったMQTT) が初期化されたこともわかります。

[INF] - Initializing TLS endpoint on port 8883 for MQTT head.

これで IoT Edge ゲートウェイにリーフデバイスから接続できます。

(l)           ここで、リーフデバイスと通信している PuTTY 上で以下を実行して、証明書チェーンに問題がないことを確認します。

$ openssl s_client -connect mygateway.local:8883 -showcerts

 

以下が表示例です。「verify return:1」と全て1 が返ってきていれば問題ありません。

 

＝＝＝＝＝表示例：ここから＝＝＝＝＝

CONNECTED(00000003)

depth=4 CN = Azure IoT Hub CA Cert Test Only

verify return:1

depth=3 CN = Azure IoT Hub Intermediate Cert Test Only

verify return:1

depth=2 CN = myGateway

verify return:1

depth=1 CN = Edge Agent CA

verify return:1

depth=0 CN = mygateway.local

verify return:1

---

Certificate chain

0 s:/CN=mygateway.local

   i:/CN=Edge Agent CA

-----BEGIN CERTIFICATE-----

(略)

-----END CERTIFICATE-----

1 s:/CN=Azure IoT Hub Intermediate Cert Test Only

   i:/CN=Azure IoT Hub CA Cert Test Only

-----BEGIN CERTIFICATE-----

(略)

-----END CERTIFICATE-----

2 s:/CN=myGateway

   i:/CN=Azure IoT Hub Intermediate Cert Test Only

-----BEGIN CERTIFICATE-----

(略)

-----END CERTIFICATE-----

3 s:/CN=Edge Agent CA

   i:/CN=myGateway

-----BEGIN CERTIFICATE-----

(略)

-----END CERTIFICATE-----

---

Server certificate

subject=/CN=mygateway.local

issuer=/CN=Edge Agent CA

---

No client certificate CA names sent

Peer signing digest: SHA512

Server Temp Key: ECDH, P-256, 256 bits

---

SSL handshake has read 5506 bytes and written 302 bytes

Verification: OK

---

New, TLSv1.2, Cipher is ECDHE-RSA-AES256-GCM-SHA384

Server public key is 2048 bit

Secure Renegotiation IS supported

Compression: NONE

Expansion: NONE

No ALPN negotiated

SSL-Session:

    Protocol  : TLSv1.2

    Cipher    : ECDHE-RSA-AES256-GCM-SHA384

    Session-ID: BD0F16D2519A492477F6F3F142398EA9535102843A9136E98FBE3D832D4F4697

    Session-ID-ctx:

    Master-Key: DB3BA5E6A2B391CB27D34C8F58E8ABEBD5375AF78372874E81C32219ADBCE6D40F71E15035D5CF341BA1AD1803B95C52

    PSK identity: None

    PSK identity hint: None

    SRP username: None

    TLS session ticket lifetime hint: 300 (seconds)

    TLS session ticket:

    0000 - 98 95 db cb 68 1b f0 34-ee fb 76 4b e8 fc b5 e5   ....h..4..vK....

    0010 - 23 09 ad 14 06 eb 4c ef-50 3c 5d d2 09 c5 84 62   #.....L.P<]....b

    0020 - 32 d0 c0 28 db a6 68 b5-df d0 93 83 1b ea f8 a6   2..(..h.........

    0030 - b6 ee b9 97 f2 eb 91 08-c4 43 ec ce 37 0f b8 68   .........C..7..h

    0040 - f6 61 67 8e 58 41 b0 bd-10 0c 91 1e 9b ff 6c 18   .ag.XA........l.

    0050 - e3 20 75 f4 23 4e 56 59-52 72 08 24 d6 f0 f4 03   . u.#NVYRr.$....

    0060 - 45 1a 8d 0f b5 ef 05 55-5d 7d 2e 6a 43 3b 2b 7c   E......U]}.jC;+|

    0070 - f0 5b fa 38 31 e6 21 ec-0a b2 fb 17 e5 cb 8b 9d   .[.81.!.........

    0080 - 8d c0 2a 6e 86 08 48 29-35 6d 87 79 3f 68 b3 f1   ..*n..H)5m.y?h..

    0090 - 2d 85 e7 22 83 75 19 0e-d5 3c 42 8a c6 00 6c 59   -..".u...<B...lY

 

    Start Time: 1523165748

    Timeout   : 7200 (sec)

    Verify return code: 0 (ok)

    Extended master secret: no

---

read:errno=0

＝＝＝＝＝表示例：ここまで＝＝＝＝＝

 

「Certificate chain」の部分について少し補足します。

「s:/CN=mygateway.local」のように「s:」で始まるものはsubject (証明対象の名称) を表し、「i:/CN=Edge Agent CA」のように「i:」で始まるものはissuer (証明書の発行者、通常CA) を表します。

この証明書チェーンの検証は、以下の図のように、mygateway.local から、ルート証明書(Azure IoT Hub CA Cert Test Only) まで、「i:」に該当する「s:」があるかをチェックしていきます。

 

clip_image028

 

なお、Raspberry Pi 3 上の信頼できるルート証明書(Azure IoT Hub CA Cert Test Only) にたどり着けばよいため、公開ドキュメントにあるようなAzure ポータルのIoT Hub のCertificates に登録する必要はありません。

 

(m)       IoT Hub 側の様子を見るために、PuTTY をさらにもう一つ起動し、IoT Edge ゲートウェイのIP アドレスに対してSSH 接続して、以下を実行します。

$ iothub-explorer monitor-events <8-(b)-2)でIoT Hub に登録したリーフデバイス名> -r --login "<3-(b)のIoT Hub のiothubowner の接続文字列>"

実行しても、リーフデバイスからの通信が始まらない限りは何も表示されないため、次に進みます。

(n)         リーフデバイスからの通信を開始します。

リーフデバイスに接続している PuTTY から、以下を実行します。

$ cd ~/azure-iot-edge-hol-linux/module2

$ python -u iotdevice.py

以下のように表示されます。

 

clip_image030

 

(o)         (m) のウィンドウには以下のように表示されます。

 

clip_image032

 

 

[2018 年 7 月 20 日追記] IoT Edge の一般提供開始 (GA) に伴い、ゲートウェイを構築する手順も更新されています。詳細は以下のドキュメントをご参照ください。   - 透過的なゲートウェイとして動作する Linux IoT Edge デバイスを作成する < https://docs.microsoft.com/ja-jp/azure/iot-edge/how-to-create-transparent-gateway-linux >   なお、この手順に従っても証明書が正しく反映されない場合は、キャッシュされている情報の影響が考えられます。以下のコマンドで事象が解消するかご確認ください。   # 証明書関連のキャッシュを削除 $ sudo rm -rf /var/lib/iotedge/cache $ sudo rm -rf /var/lib/iotedge/hsm   # IoT Edge の再起動 $ sudo systemctl restart iotedge

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

 

]]> IoT Edge ランタイムのバージョンアップの手順 https://docs.microsoft.com/archive/blogs/jpazureiotblog/iot-edge-runtime-update-version Mon, 16 Apr 2018 09:04:35 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=675

IoT Edge ランタイムのバージョンアップの手順をご案内します。

ただし、Azure IoT Edge は現在プレビューであるため、一般公開時には変更となる可能性がございます点にご留意ください。

 

    1. IoT Edgeランタイムのバージョンアップの手順

 

IoT Edge ランタイムには、Edge Agent とEdge Hub が含まれるため、それぞれのバージョンアップの手順をご案内いたします。

 

1-1.      Edge Agent のバージョンアップ手順

 

Edge Agent は、プレビュー段階では、クラウドからバージョンアップする方法はありません。そのため、IoT Edge 上で以下のコマンドを実行します。

 

(A)         すでに IoT Edge ランタイムがデプロイされており、その Edge Agent のバージョンアップを行う場合

 

sudo iotedgectl update --image microsoft/azureiotedge-agent:1.0.0-preview022

 

上記コマンドの「microsoft/azureiotedge-agent:1.0.0-preview022」の部分は、以下のサイトで公開されているレポジトリからお選びいただけます。

 

    • microsoft/azureiotedge-agent

< https://hub.docker.com/r/microsoft/azureiotedge-agent/tags/ >

 

IoT Edge ランタイム実行中に上記コマンドを実行していただくことができます。

コマンド実行後には、「INFO: Please use the start command to see changes take effect.」と表示される場合、sudo iotedgectl start を実行して開始します。

バージョンが更新されたことは、sudo docker ps で確認できます。

 

 

(B)         スクラッチからIoT Edge ランタイムの特定のバージョンのEdge Agent をセットアップしたい場合

 

sudo iotedgectl setup --connection-string  “{IoT Edge デバイス接続文字列}”--image “microsoft/azureiotedge-agent:1.0.0-preview022” –nopass

 

 

1-2.      Edge Hub のバージョンアップ手順

 

Edge Hub は、Azure ポータルから以下の手順でバージョンアップすることができます。

(1)         ご利用のIoT Hub に移動します。

(2)         [IoT Edge (preview)](IoT Edge (プレビュー)) を選択してから、バージョンアップしたい IoT Edge デバイスのデバイスID をクリックします。

 

clip_image002

 

(3)         [デバイスの詳細] で [Set Modules] をクリックします。

 

clip_image004

 

(4)         [1 Add Modules (optional)] で [Configure advanced Edge Runtime settings] をクリックします。

 

clip_image006

 

(5)         [Advanced Edge Settings] で Image を、後述のサイトの中から適用したいバージョンを選び、変更して [保存] をクリックします。

 

clip_image008

 

    • microsoft/azureiotedge-hub

< https://hub.docker.com/r/microsoft/azureiotedge-hub/tags/ >

 

(6)         [2 Specify Routes (optional)] で [Next]、[3 Review Template (optional)] で [Submit] をクリックします。

 

しばらく待つと、バージョンが更新されたことは、[デバイスの詳細] で$edgeHub をクリックして、[Module Details] の Image URI で確認できます。

 

clip_image010

 

 

    1. 複数台のIoT Edge ランタイムを一括でバージョンアップする方法

 

現時点では、複数台のIoT Edge ランタイムを一括でバージョンアップする方法はありません。

以下のドキュメントの通り、IoT Edge ランタイムを構成している Edge Agent が、自身を更新できないためです。

 

    • Edge エージェントとEdge ハブのモジュール ツインのプロパティ

< https://docs.microsoft.com/ja-jp/azure/iot-edge/module-edgeagent-edgehub >

 

systemModules.edgeAgent.settings.image

Edge エージェントのイメージのURI。 現在、Edge エージェントは自身を更新できません。

 

Edge Hub は、以下のドキュメントに沿って更新できます。

 

    • 大規模なIoT Edge モジュールの展開と監視- プレビュー

<https://docs.microsoft.com/ja-jp/azure/iot-edge/how-to-deploy-monitor >

 

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

 

]]> IoT Edge ランタイムの再起動が必要な場合について https://docs.microsoft.com/archive/blogs/jpazureiotblog/iot-edge-runtime-restart-needed Mon, 09 Apr 2018 08:32:54 GMT https://blogs.msdn.microsoft.com/jpazureiotblog/?p=565

IoT Edge は現在プレビューですが、IoT Edge ランタイムの再起動（iotedgectl restart）が必要な場合についてのご質問と回答をご案内します。

 

Q. IoT Edge ランタイムが再起動が必要な場合とは、どのようなオペレーションを実施した場合でしょうか？例えば、運用中にIoT Edge 配下に新規デバイスを追加した場合、IoT Edge ランタイムの再起動が必要になりますでしょうか？

 

A. IoT Edge ランタイムの再起動が必要となる場合は、「iotedgectl setup」のようなランタイム自体の設定変更を行った場合です。例えば、Edge ランタイムの接続文字列(connection string) を変更したり、モジュールのレジストリの資格情報(container registry credential) を追加する場合などが挙げられます。

 

IoT Edge配下に新規デバイスを追加した際、すなわちIoT Edge ゲートウェイに新しいリーフデバイスをMQTT プロトコルで接続する時に、IoT Edge ランタイムの再起動は必要ありません。

 

Azure ポータルからの変更([Specify Routes] でルート変更する場合も含む) では、IoT Edge ランタイムを再起動する必要はありません。

 

 

上記の内容がお役に立てば幸いです。

 

Azure IoT 開発サポートチーム 津田

 

]]>