從 Azure 入口網站部署 Azure IoT Edge 模組

  • 發行項

適用於：IoT Edge 1.5 複選標記 IoT Edge 1.5 IoT Edge 1.4 複選標記 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模組之後，您會想要將它們部署到您的裝置，以在邊緣運作。 如果您有多個模組一起收集及處理數據，您可以一次部署它們，並宣告連線它們的路由規則。

本文說明 Azure 入口網站 如何引導您建立部署指令清單，並將部署推送至IoT Edge裝置。 如需根據共用標籤建立以多個裝置為目標的部署的相關信息，請參閱 大規模部署和監視IoT Edge模組。

必要條件

設定部署資訊清單

部署資訊清單為 JSON 文件，說明應部署的模組、資料如何在模組之間流動，以及想要的模組對應項需要的屬性。 如需部署指令清單如何運作以及如何建立它們的詳細資訊，請參閱 瞭解如何使用、設定及重複使用IoT Edge模組。

Azure 入口網站 有一個精靈會引導您建立部署指令清單，而不是手動建置 JSON 檔。 它有三個步驟：新增模組、指定路由和檢閱部署。

注意

本文中的步驟會反映IoT Edge代理程式和中樞的最新架構版本。 架構 1.1 版與 IoT Edge 1.0.10 版一起發行，並啟用模組啟動順序和路由優先順序功能。

如果您要部署到執行 1.0.9 版或更早版本的裝置，請在精靈的 [模組] 步驟中編輯 Runtime 設定，以使用架構 1.0 版。

選取裝置並新增模組

  1. 登入 Azure 入口網站 並流覽至您的IoT中樞。

  2. 在左窗格中，選取 [裝置管理] 功能表下的 [裝置]。

  3. 從清單中選取目標IoT Edge裝置。

  4. 在上方列上，選取 [ 設定模組]。

  5. 在 頁面的 [Container Registry 認證 ] 區段中，提供認證來存取包含模組映射的任何私人容器登錄。

  6. 在頁面的 [ IoT Edge 模組 ] 區段中，選取 [ 新增]。

  7. 從下拉功能表中選擇三種類型的模組之一：

    • IoT Edge 模組 - 您提供模組名稱和容器映像 URI。 例如，範例 SimulatedTemperatureSensor 模組的映像 URI 為 mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0。 如果模組映像儲存在私人容器登錄中，請在此頁面新增認證以存取映像。
    • Marketplace 模組 - 裝載在 Azure Marketplace 中的模組。 某些市集模組需要額外的設定，因此請檢閱 Azure Marketplace IoT Edge 模組清單中的模組詳細數據。
    • Azure 串流分析模組 - 從 Azure 串流分析工作負載產生的模組。

  8. 新增模組之後，請從清單中選取模組名稱，以開啟模組設定。 如有必要，請填寫選擇性字段。

    如需可用模組設定的詳細資訊，請參閱 模組組態和管理。

    如需模組對應項的詳細資訊，請參閱 定義或更新所需的屬性。

  9. 重複步驟 6 到 8，將其他模組新增至您的部署。

  10. 選取 [下一步：路由] 繼續前往路由區段。

指定路由

在 [路由] 索引標籤上，您可以定義如何在模組與 IoT 中樞 之間傳遞訊息。 訊息是使用名稱/值組來建構。 根據預設，新裝置的第一個部署包含稱為 路由的路由 ，並定義為 FROM /messages/* INTO $upstream，這表示任何模組所輸出的任何訊息都傳送至IoT中樞。

[優先順序] 和 [存留時間] 參數是選擇性參數，您可以包含在路由定義中。 優先順序參數可讓您選擇哪些路由應該先處理其訊息，或應最後處理哪些路由。 優先順序取決於設定數位 0-9，其中 0 是首要優先順序。 存留時間參數可讓您宣告該路由中的訊息應該保留多久，直到處理或從佇列中移除訊息為止。

如需如何建立路由的詳細資訊，請參閱 宣告路由。

設定路由之後，請選取 [下一步：檢閱 + 建立 ] 以繼續執行精靈的下一個步驟。

檢閱部署

檢閱區段會顯示 JSON 部署資訊清單，該清單會根據您在前兩個區段中的選項而建立。 請注意，您未新增兩個模組： $edgeAgent 和 $edgeHub。 這兩個模組組成 IoT Edge運行時間 ，而且在每個部署中都是必要的預設值。

檢閱您的部署資訊，然後選取 [ 建立]。

檢視裝置上的模組

將模組部署至裝置之後，您就可以在 IoT 中樞 的裝置詳細數據頁面中檢視所有模組。 此頁面會顯示每個已部署模組的名稱，以及部署狀態和結束代碼等實用資訊。

從 Azure Marketplace 部署模組

Azure Marketplace 是一種在線應用程式和服務市集，您可以瀏覽經過認證並優化以在 Azure 上執行的各種企業應用程式和解決方案，包括 IoT Edge 模組。

您可以從 Azure Marketplace 和 IoT 中樞 部署 IoT Edge 模組。

從 Azure Marketplace 部署

藉由選取 [立即建立] 或 [立即取得]，來讓市集中的IoT Edge模組，以及找到想要部署的模組時，請加以部署。 繼續進行部署精靈步驟，視您選取的 IoT Edge 模組而定：

  1. 選取 [ 繼續]，確認提供者的使用規定和隱私策略。 您可能必須先提供連絡資訊。
  2. 選擇您的訂用帳戶，以及鏈接目標裝置的 IoT 中樞。
  3. 選擇 [部署至裝置]。
  4. 輸入裝置的名稱，或選取 [ 尋找裝置 ] 以在向中樞註冊的裝置之間流覽。
  5. 選取 [建立 ] 以繼續設定部署指令清單的標準程式，包括視需要新增其他模組。 新模組的詳細數據，例如映像URI、建立選項和所需的屬性，已預先定義，但可以變更。

確認模組已部署在 Azure 入口網站 的 IoT 中樞 中。 選取您的裝置，選取 [設定模組 ]，模組應該列在 [IoT Edge 模組 ] 區段中。

從 Azure IoT 中樞部署

您可以在 Azure 入口網站 的 IoT 中樞 中，快速將模組從 Azure Marketplace 部署到您的裝置。

  1. 在 Azure 入口網站中，巡覽至您的 IoT 中樞。
  2. 在左窗格中，選取 [裝置管理] 功能表下的 [裝置]。
  3. 選取要接收部署的 IoT Edge 裝置。
  4. 在上方列上，選取 [ 設定模組]。
  5. 在 [ IoT Edge 模組] 區段中，單擊 [新增]，然後從下拉菜單中選取 [Marketplace 模組 ]。

顯示如何在 I o T 中樞中新增模組的螢幕快照。

從 [IoT Edge 模組 Marketplace ] 頁面選擇模組。 您選取的模組會自動為您的訂用帳戶、資源群組和裝置設定。 然後會出現在您的IoT Edge模組清單中。 某些模組可能需要額外的設定。

提示

來自 Azure IoT 中樞的IoT Edge模組相關信息有限。 您可以先深入瞭解 Azure Marketplace 中的 IoT Edge 模組 。

選取 [下一步：路由 並繼續部署]，如本文稍早指定 路由 和 檢閱部署 所述。

下一步

瞭解如何 大規模部署和監視IoT Edge模組