從 Visual Studio Code 部署 Azure IoT Edge 模組
適用於：
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模組之後，您會想要將它們部署到您的裝置，以在邊緣運作。 如果您有多個模組一起收集及處理數據，您可以一次部署它們，並宣告連線它們的路由規則。
本文說明如何建立 JSON 部署指令清單，然後使用該檔案將部署推送至 IoT Edge 裝置。 如需根據共用標籤建立以多個裝置為目標的部署資訊，請參閱 使用Visual Studio Code 大規模部署IoT Edge 模組。
必要條件
IoT Edge 裝置
如果您沒有設定 IoT Edge 裝置，您可以在 Azure 虛擬機中建立一個裝置。 請遵循其中一篇快速入門文章中的步驟來 建立虛擬Linux裝置 或 建立虛擬 Windows 裝置。
Visual Studio Code \(英文\)。
適用於 Visual Studio Code 的 Azure IoT Edge。 適用於 Visual Studio Code 的 Azure IoT Edge 工具擴充功能處於維護模式。
設定部署資訊清單
部署資訊清單為 JSON 文件，說明應部署的模組、資料如何在模組之間流動，以及想要的模組對應項需要的屬性。 如需部署指令清單如何運作以及如何建立它們的詳細資訊，請參閱 瞭解如何使用、設定及重複使用IoT Edge模組。
若要使用 Visual Studio Code 部署模組，請將部署指令清單儲存為 。JSON 檔案。 若要執行命令以將設定套用至裝置，您會使用到下一節中的檔案路徑。
以下是一個模組作為範例的基本部署指令清單：
注意
此範例部署指令清單會針對IoT Edge代理程式和中樞使用架構1.1版。 架構 1.1 版與 IoT Edge 1.0.10 版一起發行，並啟用模組啟動順序和路由優先順序等功能。
{
"modulesContent": {
"$edgeAgent": {
"properties.desired": {
"schemaVersion": "1.1",
"runtime": {
"type": "docker",
"settings": {
"minDockerVersion": "v1.25",
"loggingOptions": "",
"registryCredentials": {}
}
},
"systemModules": {
"edgeAgent": {
"type": "docker",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-agent:1.5",
"createOptions": "{}"
}
},
"edgeHub": {
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-hub:1.5",
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
}
}
},
"modules": {
"SimulatedTemperatureSensor": {
"version": "1.5",
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
"createOptions": "{}"
}
}
}
}
},
"$edgeHub": {
"properties.desired": {
"schemaVersion": "1.1",
"routes": {
"route": "FROM /messages/* INTO $upstream"
},
"storeAndForwardConfiguration": {
"timeToLiveSecs": 7200
}
}
},
"SimulatedTemperatureSensor": {
"properties.desired": {}
}
}
}
登入以存取IoT中樞
您可以使用適用於 Visual Studio Code 的 Azure IoT 擴充功能，搭配 IoT 中樞執行作業。 若要讓這些作業運作，您必須登入您的 Azure 帳戶，然後選取您正在處理的 IoT 中樞。
在 Visual Studio Code 中，開啟 [ 總管] 檢視。
在 [總管] 底部，展開 [Azure IoT 中樞] 區段。
點選 Azure IoT 中樞 區段標頭中的 ... 。 如果您沒有看到省略號，請將滑鼠停留在標頭上方。
選擇 [選取 IoT 中樞]。
如果您未登入您的 Azure 帳戶，請遵循提示來執行此動作。
選取 Azure 訂閱。
選取您的IoT中樞。
部署至您的裝置
藉由套用您使用模組資訊設定的部署指令清單，即可將模組部署至您的裝置。
在 Visual Studio Code 總管檢視中，展開 [Azure IoT 中樞] 區段，然後展開 [裝置] 節點。
以滑鼠右鍵按下您想要使用部署指令清單設定的 IoT Edge 裝置。
提示
若要確認您選擇的裝置是IoT Edge裝置，請選取它以展開模組清單，並確認$edgeHub和$edgeAgent是否存在。 每個 IoT Edge 裝置都包含這兩個模組。
選取 [建立單一裝置的部署]。
流覽至您想要使用的部署指令清單 JSON 檔案，然後按兩下 [ 選取Edge 部署指令清單]。
部署的結果會列印在Visual StudioCode輸出中。 如果目標裝置正在執行並連線到因特網，則會在幾分鐘內套用成功的部署。
檢視裝置上的模組
將模組部署至裝置之後，即可在 [Azure IoT 中樞] 區段中檢視所有模組。 選取IoT Edge裝置旁的箭號以展開它。 所有目前正在執行的模組都會顯示。
如果您最近將新模組部署到裝置，請將滑鼠停留在 [Azure IoT 中樞 裝置] 區段標頭上，然後選取重新整理圖示以更新檢視。
以滑鼠右鍵按兩下模組的名稱，以檢視和編輯模組對應項。