使用對稱金鑰在 Linux 上建立及佈建 IoT Edge 裝置

發行項
06/13/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 中樞的每個裝置都有裝置識別碼，可用來追蹤雲端到裝置或裝置到雲端的通訊。您可以使用其連線資訊來設定裝置，這些資訊包括：

IoT 中樞主機名稱
裝置識別碼
連線到 IoT 中樞的驗證詳細資料

本文中的步驟會帶您完成稱為「手動佈建」的程序，您會在此程序中將單一裝置連線到其 IoT 中樞。針對手動佈建，您有兩個選項可用來驗證 IoT Edge 裝置：

對稱金鑰：當您在 IoT 中樞中建立新的裝置身分識別時，服務會建立兩個金鑰。您會在裝置上放置其中一個金鑰，並在驗證時呈現 IoT 中樞的金鑰。

這個驗證方法上手較為快速，但並非是安全的方法。
X.509 自我簽署：您可以建立兩個 X.509 身分識別憑證，並將其置於裝置上。當您在 IoT 中樞中建立新的裝置身分識別時，您會從這兩個憑證提供指紋。當裝置向 IoT 中樞進行驗證時，其會顯示一個憑證，而 IoT 中樞會確認憑證符合其指紋。

此驗證方法較安全，建議用於實際執行案例。

本文說明如何使用對稱金鑰做為驗證方法。如果您想要使用 X.509 憑證，請參閱使用 X.509 憑證在 Linux 上建立及佈建 IoT Edge 裝置。

注意

如果您有許多裝置可設定，且不想手動佈建每個裝置，請使用下列其中一篇文章來了解 IoT Edge 如何與 IoT 中樞裝置佈建服務搭配運作：

必要條件

本文說明如何在裝置上註冊 IoT Edge 裝置並安裝 IoT Edge (也稱為 IoT Edge 執行階段)。在註冊並安裝裝置之前，請確定您具備選擇的裝置管理工具 (例如 Azure CLI) 和裝置需求。

裝置管理工具

您可以使用 Azure 入口網站、Visual Studio Code 或 Azure CLI 來完成註冊裝置的步驟。每個公用程式都有自己的必要條件，或可能需要安裝：

Azure 訂閱的免費或標準 IoT 中樞。

裝置需求

X64、ARM32 或 ARM64 Linux 裝置。

Microsoft 發佈各種作業系統的安裝套件。

如需生產情境下，何種 Windows 作業系統可供使用的相關資訊，請參閱 Azure IoT Edge 支援系統。

Visual Studio Code 擴充功能

如果您使用 Visual Studio Code，有實用的 Azure IoT 延伸模組可讓裝置建立和管理程式變得更容易。

安裝 Azure IoT Edge 和 Azure IoT 中樞兩個延伸模組：

Azure IoT Edge。 適用於 Visual Studio Code 的 Azure IoT Edge 工具延伸模組目前是維護模式。
Azure IoT 中樞

登記裝置

您可以根據喜好，使用 Azure 入口網站、Visual Studio Code 或Azure CLI來註冊裝置。

在 Azure 入口網站的 IoT 中樞中，您會在未啟用 Edge 的 IOT 裝置上分別建立及管理 IoT Edge 裝置。

登入 Azure 入口網站，然後瀏覽至 IoT 中樞。
在左側窗格中，從功能表中選取 [裝置]，然後選取 [新增裝置]。
在 [建立裝置] 頁面上，提供下列資訊：
- 建立描述性的裝置識別碼，例如 my-edge-device-1 (全部小寫)。複製此裝置識別碼，您稍後會用到。
- 核取 [IoT Edge 裝置] 核取方塊。
- 選取 [對稱金鑰] 作為 [驗證類型]。
- 使用預設設定自動產生驗證金鑰，以將新裝置連線到中樞。
選取 [儲存]。

您應該會看到新裝置列在您的 IoT 中樞中。

您可以使用適用於 Visual Studio Code 的 Azure IoT 擴充功能來透過 IoT 中樞執行各種操作。請確定您已安裝 Azure IoT 延伸模組必要條件。

安裝 Azure IoT Edge 和 Azure IoT 中樞延伸模組之後，您會發現 Azure 圖示新增至左側圖示功能表。您可以透過 Visual Studio Code 選取 Azure 圖示，然後選取 [登入 Azure] 登入 Azure 帳戶。

使用 Visual Studio Code 註冊新裝置

註冊新裝置類似於在 Azure 入口網站中建立 IoT Edge 裝置。此虛擬裝置是其中一個「對應項」，而真實世界裝置則是另一個對應項。 Visual Studio Code 可以透過下列步驟為您進行設定。

在 Visual Studio Code 總管功能表中，展開 [Azure IoT 中樞] 區段。
在 [Azure IoT 中樞 區段標頭] 中選取 ... 。如果您沒有看到省略號，請選取或暫留在標頭上方。
選取 [建立 IoT Edge 裝置]。
在開啟的文字輸入框中，為您的裝置提供一個識別碼，例如 my-edge-device-1 (全部小寫)，然後按 Enter 鍵。

在 Visual Studio Code 的輸出主控台中，您可以看到命令的結果：一個 JSON 列印輸出。裝置資訊會包括您提供的 deviceId，並產生 connectionString 以讓您用來將實體裝置連線至 IoT 中樞。輸出主控台也會顯示您的金鑰和其他裝置識別資訊。

現在，您可以在總管功能表的 [Azure IoT 中樞]> [裝置] 區段下看到您的裝置。

注意

如果未列出您的裝置，您可能需要從 [Azure IoT 中樞] 底下提供的 [選取 Io T 中樞] 連結，來選擇您的 IoT 中樞，然後遵循提示。提示會要求您先選擇訂用帳戶，然後再選擇 IoT 中樞。此流程可讓 Visual Studio Code 了解您的 IoT 中樞 (以及其中的所有裝置)。重新整理 Visual Studio Code，您的裝置應該就會顯示。

使用 az iot hub device-identity create 命令，在 IoT 中樞中建立新的裝置身分識別。以您自己全新且唯一的裝置識別碼，例如 my-edge-device-1 (全部小寫) 取代 device_id_here。以現有的 IoT 中樞取代 hub_name_here。

這個命令包含三個參數：

--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 顯示此命令需要延伸模組 azure-iot。您要立即安裝嗎?，則請輸入 Y，然後按 Enter 來起始下載以建立您的裝置。

現在您已在 IoT 中樞內註冊裝置，接著您可以擷取用來完成安裝及佈建 IoT Edge 執行階段的佈建資訊。

檢視已註冊的裝置並擷取佈建資訊

使用對稱金鑰驗證的裝置需要其連接字串，才能完成 IoT Edge 執行階段的安裝和佈建。當您建立裝置時，會為 IoT Edge 裝置產生連接字串。針對 Visual Studio Code 和 Azure CLI，連接字串位於 JSON 輸出中。如果您使用 Azure 入口網站來建立裝置，您可以從裝置本身找到連接字串。當您在 IoT 中樞中選取裝置時，它會以 Primary connection string 列在裝置頁面上。

連線至 IoT 中樞且已啟用邊緣的裝置會列在 IoT 中樞的 [裝置] 頁面上。如果您有多個裝置，您可以選取 [IoT Edge 裝置] 類型來篩選清單，然後選取 [套用]。

當您準備好開始設定裝置時，需要連接字串才能利用實體裝置在 IoT 中樞中的身分識別來連結實體裝置。使用對稱金鑰進行驗證的裝置，可在入口網站中複製其連接字串。在入門網站中尋找連接字串：

在 [裝置] 頁面上，從清單中選取 [IoT Edge 裝置識別碼]。
複製 [主要連接字串] 或 [次要連接字串] 的值。任一金鑰都有效。

若要查看 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。您也會看到許多其他中繼資料作為 JSON 輸出，包括您的裝置識別碼。

當您準備好設定裝置時，您需要其連接字串，將您的實體裝置與其在 IoT 中樞中的身分識別連結起來。使用下列 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=my-iot-hub.azure-devices.net;DeviceId=my-edge-device-1;SharedAccessKey=saQ52bt6BBUlRfusqWuxPMAx4ysQwWEb5+1eidwzHPY="
}

提示

connection-string show 命令已在 Azure IoT 延伸模組的 0.9.8 版中引進，取代了已淘汰的 show-connection-string 命令。如果您在執行此命令時發生錯誤，請確定您的延伸模組版本已更新為 0.9.8 或更新版本。如需詳細資訊和最新更新，請參閱適用於 Azure CLI 的 Microsoft Azure IoT 延伸模組。

複製連接字串以在裝置上使用時，請勿在連接字串周圍加上引號。

安裝 IoT Edge

在本節中，您將為 IoT Edge 準備 Linux 虛擬機器或實體裝置。然後，您會安裝 IoT Edge。

執行下列命令以新增套件存放庫，然後將 Microsoft 套件簽署金鑰新增至信任金鑰的清單。

重要

在 2022 年 6 月 30 日，已從第 1 層作業系統支援清單中淘汰 Raspberry Pi OS Stretch。若要避免潛在的安全性弱點，請將主機作業系統更新為 Bullseye。

您可以使用幾個命令來完成安裝。開啟終端機，然後執行下列命令：

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 完成安裝。開啟終端機，然後執行下列命令：

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

提示

如果您在作業系統安裝期間將密碼授與「根」帳戶，則不需要 '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 支援的平台。

注意

使用 Azure IoT Edge 軟體套件時，必須遵守每個封裝中的授權條款 (usr/share/doc/{package-name} 或 LICENSE 目錄)。在使用套件之前，請先閱讀授權條款。安裝及使用套件即表示接受這些授權條款。如果您不同意授權條款，請勿使用該套件。

安裝容器引擎

Azure IoT Edge 會依賴 OCI 相容的容器執行階段。針對實際執行案例，建議使用 Moby 引擎。 Moby 引擎是 IoT Edge 正式支援的唯一容器引擎。 Docker CE/EE 容器映像與 Moby 執行階段相容。

安裝 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 所提供的檢查設定指令碼來檢查您的核心設定：

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 等核心設定產生器，請尋找並啟用個別的功能，並據此重建您的核心。一旦您部署新修改過的核心之後，請再次執行檢查設定指令碼，以確認所有必要的功能都已成功啟用。

IoT Edge 具有 Docker 和 IoT 身分識別服務的相依性。使用下列命令安裝相依性：

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

根據預設，容器引擎不會設定容器記錄大小限制。經過一段時間之後，這可能會導致裝置充滿記錄，並用盡磁碟空間。不過，您可以將記錄設定為在本機顯示，但這是選擇性的。若要深入了解記錄設定，請參閱生產部署檢查清單。

下列步驟示範如何將容器設定為使用 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 執行階段讓裝置進入啟動程序。

注意

從 1.2 版開始，IoT 識別服務會處理 IoT Edge 以及需要與 IoT 中樞通訊的其他裝置元件的身分識別佈建和管理。

本節中的步驟代表在具有網際網路連線的裝置上安裝最新 IoT Edge 版本的一般程序。如果您需要安裝特定版本，例如發行前版本，或需要在離線時安裝，請遵循本文稍後的離線或特定版本安裝步驟。

提示

如果您已經有執行舊版且想要升級至最新版本的 IoT Edge 裝置，請使用更新 IoT Edge 安全性精靈和執行階段中的步驟。較新版本與舊版 IoT Edge 有明顯的不同，因此升級時需要特定步驟。

安裝最新版本的 IoT Edge 和 IoT 識別服務套件 (如果您尚未擁有最新版本)：

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 套件包含適用於 IoT 的 Microsoft Defender 安全性微代理程式，可讓端點了解安全性態勢管理、弱點、威脅偵測、機群管理等等，以協助您保護您的 IoT Edge 裝置。建議您使用 Edge 代理程式安裝微代理程式，以啟用 Edge 裝置的安全性監視和強化。若要深入了解適用於 IoT 的 Microsoft Defender，請參閱對於裝置建置者而言，什麼是適用於 IoT 的 Microsoft Defender。

安裝最新版本的 IoT Edge 和 IoT 識別服務套件 (如果您尚未擁有最新版本)：

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

選用的 defender-iot-micro-agent-edge 套件包含適用於 IoT 的 Microsoft Defender 安全性微代理程式，可讓端點了解安全性態勢管理、弱點、威脅偵測、機群管理等等，以協助您保護 IoT Edge 裝置。建議您使用 Edge 代理程式安裝微代理程式，以啟用 Edge 裝置的安全性監視和強化。若要深入了解適用於 IoT 的 Microsoft Defender，請參閱對於裝置建置者而言，什麼是適用於 IoT 的 Microsoft Defender。

安裝最新版本的 IoT Edge 和 IoT 識別服務套件 (如果您尚未擁有最新版本)：

sudo yum install aziot-edge

從嵌入式管理單元安裝 IoT Edge：

sudo snap install azure-iot-edge

線上貼齊

根據預設，快照是無相依性、不受信任且嚴格限制。因此，貼齊必須在安裝之後連線到其他貼齊和系統資源。使用下列命令，將IoT身分識別服務和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

使用雲端身分識別來佈建裝置

現在，容器引擎和 IoT Edge 執行階段已安裝在您的裝置上，您已準備好使用裝置的雲端身分識別和驗證資訊來設定裝置。

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 和身分識別服務：

sudo snap set azure-iot-edge raw-config="$(cat ~/config.toml)"

部署模組

若要部署 IoT Edge 模組，請移至 Azure 入口網站中的 IoT 中樞，然後：

在 [IoT 中樞] 功能表中選取 [裝置]。
選取您的裝置以開啟其頁面。
選取 [設定模組] 索引標籤。
由於我們想要部署 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
```
您可以預期會有一系列回應，包括「正常」(綠色)、「警告」(黃色)，或「錯誤」(紅色)。如需針對常見錯誤進行疑難解答，請參閱 Azure IoT Edge 常見問題的解決方案。

提示

一律使用 sudo 來執行檢查工具，即使您的權限更新也一樣。此工具需要較高的權限，才能存取組態檔，以確認組態狀態。

注意

在新佈建的裝置上，您可能會看到與 IoT Edge 中樞相關的錯誤：

× 實際執行整備程度：Edge 中樞的儲存體目錄會保存在主機檔案系統上 - 錯誤無法檢查 edgeHub 容器的目前狀態

新佈建的裝置上預期會發生此錯誤，因為 IoT Edge 中樞模組尚未執行。請確定已在先前的步驟中部署 IoT Edge 模組。部署可解決此錯誤。

或者，您可能會看到 417 -- The device's deployment configuration is not set 的狀態碼。部署模組之後，此狀態將會變更。
當服務啟動時，您應該只會看到 edgeAgent 模組正在執行。 edgeAgent 模組預設會執行，且有助於安裝及啟動部署至裝置的任何其他模組。

在 Azure 入口網站中檢視您的裝置頁面，檢查您的裝置和模組是否已部署並執行。

部署並執行模組之後，請使用下列命令在裝置或虛擬機器中列出模組：
```
sudo iotedge list
```

離線或特定版本安裝 (選擇性)

本節中的步驟適用於標準安裝步驟未涵蓋的情況。可能包括：

離線時安裝 IoT Edge
安裝候選版

如果您想要安裝的特定 Azure IoT Edge 執行階段版本無法透過套件管理員取得，請使用本節中的步驟。 Microsoft 套件清單只包含一組有限的最新版本及其子版本，因此這些步驟適用於想要安裝較舊版本或候選版本的任何人員。

如果您使用 Ubuntu 嵌入式管理單元，您可以下載貼齊並將其離線安裝。如需詳細資訊，請參閱下載快照集並離線安裝。

您可以使用 curl 命令，直接從 IoT Edge GitHub 存放庫將元件檔案設為目標。

瀏覽至 Azure IoT Edge 版本，並尋找您想要設為目標的版本。
展開該版本的 [資產] 區段。
每個版本都應該有適用於 IoT Edge 和識別服務的新檔案。如果您要在離線裝置上安裝 IoT Edge，請事先下載這些檔案。否則，請使用下列命令來更新這些元件。
1. 尋找符合您 IoT Edge 裝置架構的 aziot-identity-service 檔案。以滑鼠右鍵按一下檔案連結，並複製連結位址。
2. 使用下列命令中的複製連結來安裝該版本的識別服務：
```
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 身分識別服務：

sudo snap remove azure-iot-identity

IoT Edge 執行階段移除後，其所建立的任何容器隨即停止，但仍會存在於您的裝置上。檢視所有容器以查看哪些容器保留下來。

sudo docker ps -a

刪除您裝置中的容器，包括兩個執行階段容器。

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 執行階段

線上貼齊

使用雲端身分識別來佈建裝置

部署模組

確認設定成功

離線或特定版本安裝 (選擇性)

解除安裝 IoT Edge

下一步

意見反應

意見反應

其他資源