裝置更新模組代理程式可以與其他系統進程和IoT Edge模組一起執行,這些模組會連線到您 IoT 中樞 作為相同邏輯裝置的一部分。 本文說明如何將裝置更新代理程式布建為模組身分識別。
注意事項
使用最新的裝置更新代理參考實作 1.x 版本,以享受最新的改進。 請在您的IoT 裝置對應項的屬性區段中檢查已安裝的版本。 如需詳細資訊,請參閱 IoT 中樞 的裝置更新支援平台。
模組身分識別和裝置身分識別
您可以在每個 Azure IoT 中樞 裝置身分識別下建立最多 50 個模組身分識別。 每個模組身分識別都會隱含地產生模組身分識別對應項。 在裝置端,您可以使用 IoT 中樞 裝置 SDK 來建立模組,每個模組都會開啟與 IoT 中樞 的獨立連線。
模組身分識別和模組身分識別對應項提供與裝置身分識別和裝置對應項類似的功能,但數據粒度更精細。 如需更多資訊,請參閱了解及使用 IoT 中樞中的模組對應項。
當您將裝置更新代理程式佈建為模組身分識別時,裝置與裝置更新服務之間的所有 通訊 都必須透過模組對應項分身進行。 當您建立 裝置群組時,請記得為該裝置的模組對應項加上標記。 如果您從裝置層級 Agent 移轉為將 Agent 新增為模組身分識別,請移除先前透過裝置對應項通訊的舊 Agent。
支援的更新類型
Device Update 支援下列 IoT 裝置的無線更新類型:
- IoT Edge 和非 IoT Edge Linux 裝置:
- Eclipse ThreadX 裝置更新代理程式
- 閘道後方已中斷連線的裝置
準備套件更新
若要設定 IoT 裝置或 IoT Edge 裝置以安裝 套件型更新,請依照下列步驟新增 packages.microsoft.com 至電腦的存放庫:
在您要安裝裝置更新代理程式的機器或IoT裝置上開啟終端機視窗。
安裝符合您裝置作系統的存放庫組態,例如:
curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list將產生的清單複製到您的 sources.list.d 目錄。
sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/安裝 Microsoft GPG 公開金鑰。
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpgsudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
布建裝置更新代理程式
您可以在已啟用 IoT Edge 的裝置或非 IoT Edge IoT 裝置上,將裝置更新代理程式佈建為模組身分識別。 若要檢查您的裝置上是否已啟用IoT Edge,請參閱 檢視已註冊的裝置並擷取布建資訊。
您可以從 Releases 頁面上的 素材 區段下載範例影像以供使用。 在 Tutorial_RaspberryPi3.zip 中,swUpdate 檔案是可燒錄到 Raspberry Pi B3+ 開發板上的基礎映像檔。 .gz檔案是您可以透過裝置更新匯入的更新。 如需詳細資訊,請參閱使用Raspberry Pi 映像 IoT 中樞的 Azure 裝置更新。
在 IoT Edge 啟用的裝置上
請遵循下列指示,在已啟用IoT Edge的裝置上 布建裝置更新代理程式:
請遵循手動布建單一 Linux IoT Edge 裝置上的指示。
執行下列命令來安裝裝置更新映像更新代理程式:
sudo apt-get install deviceupdate-agent安裝裝置更新套件更新代理程式。
如需來自 packages.microsoft.com 的最新代理程式版本,請更新裝置上的套件清單,並使用下列專案來安裝裝置更新代理程式套件及其相依性:
sudo apt-get updatesudo apt-get install deviceupdate-agent針對候選版 (rc) 代理程式版本,將 .deb 檔案從 Releases 下載到您要安裝裝置更新代理程式的機器,然後執行下列命令:
sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"如果您正在為未連線裝置案例設定 Microsoft Connected Cache (MCC),請依照下列方式安裝傳遞最佳化 APT 外掛程式:
sudo apt-get install deliveryoptimization-plugin-apt
在未啟用 IoT Edge 的裝置上
請遵循這些指示,在未安裝IoT Edge的Linux IoT裝置上布建裝置更新代理程式。 你可以使用 Azure IoT 身份服務(AIS)或直接在裝置上設定憑證來配置代理程式。
Use Azure IoT Identity Service (AIS)
遵循安裝 Azure IoT 身分識別服務中的 指示,安裝最新版的 IoT 身分識別服務。
遵循 設定 Azure IoT 識別服務中的指示,設定 IoT 識別服務。 確保服務設定適當的裝置或模組身份,以便能向裝置更新代理提供連線資訊。
執行下列命令來安裝裝置更新代理程式:
sudo apt-get install deviceupdate-agent
使用連接字串
若要測試或限制裝置,您可以設定裝置更新代理程式,而不需使用IoT身分識別服務。 您可以使用 連接字串 從模組或裝置佈建裝置更新代理程式。
在 Azure 入口網站 中,複製主要 連接字串。 如果裝置更新代理程式設定為模組身分識別,請複製模組的主要 連接字串。 否則,請複製裝置的主要 連接字串。
在您安裝裝置更新代理程式的機器或 IoT 裝置的終端機視窗中,執行下列命令來 編輯裝置更新設定檔 :
- 若為 Ubuntu代理程式:
sudo nano /etc/adu/du-config.json。 - 若為 Yocto 參考映像:
sudo nano /adu/du-config.json。
- 若為 Ubuntu代理程式:
在du-config.json檔案中,設定具有
Place value here佔位元的所有值,然後輸入複製的主要 連接字串 做為connectionData域值。 如需範例,請參閱 範例「du-config.json」檔案內容。
使用 X.509 憑證
Device Update agent 1.3.0 版及更新版本支援使用 X.509 憑證向 IoT 中樞 進行驗證。 Azure IoT 中樞 支援兩種 X.509 憑證配置方法:
- CA 簽署的憑證(建議): 裝置使用由受信任的憑證授權中心(CA)簽發的憑證進行認證。
- 自簽憑證(基於拇指印):每個裝置識別碼都設定了憑證拇指印,IoT 中樞在認證時進行驗證。
設定 X.509 認證
請在 IoT 中樞 註冊裝置身份,並啟用 X.509 認證。
- 可透過以下方式配置裝置:
- 由受信任的憑證授權機構(CA)所簽發的憑證。
- 一張自簽且有登記指紋的證書。
- 在裝置上安裝裝置更新代理程式。
裝置配置服務(DPS)可用於配置裝置識別碼與憑證。 然而,DPS 並不提供模組身份。 裝置更新代理的設定仍必須在裝置上完成。
關於逐步設定說明,包括進階情境,如硬體支援金鑰(例如硬體安全模組(HSMs)或基於 PKCS#11 的金鑰儲存以進行安全金鑰處理),請參閱 X.509 認證指南:How to Use X.509 Client Certificate Authentication。
注意事項
裝置更新代理中的 X.509 認證支援使用標準的 Azure IoT 中樞 身份設定。 此功能並未整合至 Azure 裝置登錄(ADR)憑證管理(預覽版)。
設定裝置更新代理程式
安裝裝置更新代理程式後,請執行以下指令編輯裝置更新設定檔。
sudo nano /etc/adu/du-config.json
在 du-config.json 檔案中,設定所有帶有 Place value here 預留位置的值。
Azure IoT 身份服務(AIS)
-
"connectionType":"AIS" -
"connectionData":""(空字串)
注意事項
使用 Azure IoT 身份服務(AIS)時,必須設定該服務以提供正確的身份給裝置更新代理。 這包括在中 config.toml 設定身份,並確保代理與適當的裝置或模組身份相關聯。 若裝置更新代理以模組形式執行,必須設定對應的模組身份,使 AIS 能將模組的連線資訊回傳給代理程式。 關於設定細節,請參見 Configuring the Azure IoT Identity Service。
連接字串
-
"connectionType":"string" -
"connectionData":"HostName=<hub>.azure-devices.net;DeviceId=<device>;SharedAccessKey=<key>"(替換成你的IoT 中樞主機名稱、裝置 ID 和共享存取金鑰)
X.509 憑證
-
"connectionType":"x509" -
"connectionData":"HostName=<hub>.azure-devices.net;DeviceId=<device>;x509=true"(替換成你的IoT 中樞主機名稱和裝置ID) -
"connectionX509CertFilePath":"/etc/adu/certs/client.pem" -
"connectionX509PrivateKeyFilePath":"/etc/adu/certs/client.key" -
"connectionX509CaCertFilePath":"/etc/adu/certs/ca.pem"
完整設定細節請參閱 Azure 裝置更新代理程式設定指南。
更多資訊請參見: 裝置更新設定檔。 如需範例,請參閱 範例「du-config.json」檔案內容。
啟動裝置更新代理程式
啟動裝置更新代理程式,並確認它已成功在您的裝置上執行。
在已安裝裝置更新代理程式的機器或IoT裝置的終端機視窗中,執行下列命令來重新啟動代理程式:
sudo systemctl restart deviceupdate-agent執行下列命令來檢查代理程序狀態。
sudo systemctl status deviceupdate-agent您應該會看到狀態
OK。在 [IoT 中樞 入口網站] 頁面上,移至 [裝置] 或 [IoT Edge] 以尋找您設定的裝置,並查看以模組身分執行的裝置更新代理程式。 例如:
在 Proxy 伺服器後方啟用裝置更新代理程式
執行裝置更新代理程式的裝置會傳送 HTTPS 要求,以與 IoT 中樞 通訊。 如果您將裝置連線到使用 Proxy 伺服器的網路,您必須設定裝置更新系統服務以透過伺服器進行通訊。
在設定裝置更新前,請確認你已經有代理網址。 Proxy URL 的格式為 protocol://proxy_host:proxy_port。
執行下列命令來建立 systemd override 設定目錄和覆寫檔案:
sudo mkdir -p /etc/systemd/system/deviceupdate-agent.service.d
sudo nano /etc/systemd/system/deviceupdate-agent.service.d/override.conf
將 Proxy 詳細數據新增至組態
[Service]
Environment="HTTP_PROXY=http://your.proxy.server:port"
Environment="HTTPS_PROXY=http://your.proxy.server:port"
重新啟動代理程式以套用變更:
sudo systemctl daemon-reexec
sudo systemctl daemon-reload
sudo systemctl restart deviceupdate-agent
然後,您可以使用 來檢查已套用環境變數
sudo systemctl show deviceupdate-agent | grep -i proxy
建置並執行裝置更新代理程式
您也可以建置和修改自己的自訂裝置更新代理程式。 請遵循如何建置裝置更新代理程式以從來源建置裝置更新代理程式的指示。
成功建置代理程序之後,請遵循執行 IoT 中樞 參考代理程式的裝置更新來執行代理程式。 若要進行將代理程式併入映像所需的變更,請遵循 如何修改裝置更新代理程序代碼。
疑難排解
如果您遇到問題,請檢閱 IoT 中樞 疑難解答指南的裝置更新,以協助解決問題,並收集提供給Microsoft的必要資訊。