Aktualizace IoT Edge

Platí pro: IoT Edge 1.5 IoT Edge 1.4

Důležité

IoT Edge 1.5 LTS je podporovaná verze. IoT Edge 1,4 LTS končí životnost od 12. listopadu 2024.

Vzhledem k tomu, že služba IoT Edge vydává nové verze, aktualizujte IoT Edge zařízení o nejnovější funkce a vylepšení zabezpečení. Tento článek obsahuje informace o tom, jak aktualizovat IoT Edge zařízení, když je k dispozici nová verze.

Pokud chcete přejít na novější verzi, je potřeba aktualizovat dvě logické součásti IoT Edge zařízení.

• Subsystém zabezpečení – Běží na zařízení, zpracovává úlohy založené na zabezpečení a spouští moduly při spuštění zařízení. Subsystém zabezpečení můžete aktualizovat pouze ze samotného zařízení.

• IoT Edge runtime – modul runtime IoT Edge se skládá z modulů IoT Edge hub (edgeHub) a agenta IoT Edge (edgeAgent). V závislosti na struktuře nasazení můžete modul runtime aktualizovat buď ze zařízení, nebo vzdáleně.

Postup aktualizace

Prostřednictvím částí tohoto článku můžete aktualizovat jak kontejnery zabezpečovacího subsystému, tak runtime kontejnery na zařízení.

Vydání oprav

Při upgradu mezi verzemi oprav , například 1.5.1 na 1.5.2, není pořadí aktualizací důležité. Můžete upgradovat subsystém zabezpečení nebo běhové kontejnery v libovolném pořadí. Aktualizace mezi verzemi oprav:

1. Aktualizace subsystému zabezpečení
2. Aktualizace kontejnerů modulu runtime
3. Ověření shody verzí

Proces upgradu můžete kdykoli vyřešit .

Hlavní nebo dílčí verze

Při upgradu mezi hlavními nebo dílčími verzemi, například z verze 1.4 na verzi 1.5, aktualizujte subsystém zabezpečení i kontejnery modulu runtime. Před vydáním produktový tým otestuje subsystém zabezpečení a kombinaci verze kontejneru modulu runtime. Aktualizace mezi hlavními nebo dílčími verzemi produktu:

1. Na zařízení zastavte IoT Edge pomocí příkazu sudo iotedge system stop a uninstall.

2. Na zařízení upgradujte modul kontejneru, a to buď Docker , nebo Moby.

3. Na zařízení instalujte IoT Edge.

   Pokud importujete starou konfiguraci pomocí iotedge config import, upravte image [agent.config] vygenerovaného /etc/aziot/config.toml souboru tak, aby používala image 1.5 pro edgeAgent.

   Další informace najdete v tématu Konfigurování IoT Edge nastavení zařízení.

4. V IoT Hub aktualizujte nasazení modulu, aby odkazovalo na nejnovější systémové moduly.

5. Na zařízení spusťte IoT Edge pomocí sudo iotedge config apply.

Proces upgradu můžete kdykoli vyřešit .

Aktualizace subsystému zabezpečení

Subsystém zabezpečení IoT Edge zahrnuje sadu nativních komponent, které je potřeba aktualizovat pomocí správce balíčků na IoT Edge zařízení.

Pomocí příkazu iotedge versionzkontrolujte verzi subsystému zabezpečení spuštěného na vašem zařízení . Pokud používáte IoT Edge pro Linux na Windows, musíte se přes SSH připojit k virtuálnímu počítači s Linuxem a zkontrolovat verzi.

Ubuntu / Debian

Na zařízeních s Linuxem x64 použijte apt-get nebo svého vhodného správce balíčků k aktualizaci subsystému zabezpečení na nejnovější verzi.

Aktualizace apt:

sudo apt-get update

Poznámka

Pokyny k získání nejnovější konfigurace úložiště z Microsoft najdete v předběžných krocích Instalace IoT Edge.

Zkontrolujte, které verze IoT Edge jsou k dispozici:

apt list -a aziot-edge

Aktualizovat IoT Edge:

sudo apt-get install aziot-edge

Spuštění apt-get install aziot-edge upgraduje subsystém zabezpečení a nainstaluje službu identit, aziot-identity-service jako požadovanou závislost.

Red Hat Enterprise Linux

Zkontrolujte, které verze IoT Edge jsou k dispozici:

yum list aziot-edge

Pokud chcete aktualizovat na nejnovější verzi IoT Edge, použijte následující příkaz. Aktualizuje také službu identit na nejnovější verzi:

sudo yum install aziot-edge

Linux na Windows

Informace o IoT Edge pro Linux v aktualizacích Windows najdete v tématu EFLOW Updates.

Windows

Poznámka

Kontejnery Windows v současné době nepodporují IoT Edge spuštěné na zařízeních Windows. Ke spuštění IoT Edge na Windows použijte kontejner Linuxu.

Pak znovu použít konfiguraci, aby se zajistilo, že se systém plně aktualizuje.

sudo iotedge config apply

Aktualizace kontejnerů modulu runtime

Způsob, jakým aktualizujete agenta IoT Edge a kontejnery centra IoT Edge, závisí na tom, jestli ve svém nasazení používáte kumulativní značky (například 1.5) nebo konkrétní značky (například 1.5.1).

Pomocí příkazů iotedge logs edgeAgent nebo iotedge logs edgeHub zkontrolujte verzi modulů IoT Edge agenta a IoT Edge hubu, které jsou aktuálně na vašem zařízení. Pokud používáte IoT Edge pro Linux na Windows, musíte se přes SSH připojit k virtuálnímu počítači s Linuxem a zkontrolovat verze modulu runtime.

Porozumění značkám IoT Edge

Obrazy agenta IoT Edge a hubu IoT Edge používají značky, které odpovídají IoT Edge verzi, ke které jsou přiřazeny. K označení imagí modulu runtime použijte dvě různé metody:

• Postupné značky – K zajištění nejnovějšího obrazu, který odpovídá těmto číslicím, použijte pouze první dvě hodnoty čísla verze. Například 1.5 se aktualizuje vždy, když je k dispozici nová verze, která ukazuje na nejnovější verzi 1.5.x. Pokud modul runtime kontejneru na vašem zařízení IoT Edge znovu stáhne image, moduly runtime se aktualizují na nejnovější verzi. Nasazení z portálu Azure jsou ve výchozím nastavení nastavena na průběžné značky. Tento přístup použijte pro účely vývoje.

• Konkrétní značky – K explicitnímu nastavení verze použijte všechny tři hodnoty čísla verze. Například verze 1.5.0 se po počáteční verzi nezmění. Nové číslo verze můžete deklarovat v manifestu nasazení, až budete připraveni k aktualizaci. Tento přístup použijte pro produkční účely.

Aktualizujte obrázek s rolling tagem

Pokud ve svém nasazení používáte kumulativní značky (například mcr.microsoft.com/azureiotedge-hub:**1.5**), musíte vynutit modul runtime kontejneru na vašem zařízení, aby načítával nejnovější verzi image.

Odstraňte místní verzi image ze zařízení IoT Edge. Na Windows počítačích odinstalace subsystému zabezpečení odebere také image modulu runtime, takže tento krok nemusíte opakovat.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Možná budete muset k odebrání obrázků použít příznak vynucení -f .

Služba IoT Edge načítá nejnovější verze imagí modulu runtime a automaticky je spustí na vašem zařízení znovu.

Aktualizace určitého obrázku značky

Pokud ve svém nasazení použijete konkrétní značky (například mcr.microsoft.com/azureiotedge-hub:**1.5.1**), aktualizujte značku v manifestu nasazení a změny použijte na zařízení.

1. Na IoT Hub na portálu Azure vyberte zařízení IoT Edge a vyberte Set Modules.

2. Na kartě Moduly vyberte Nastavení modulu runtime.

3. V nastavení modulu runtime aktualizujte hodnotu identifikátoru URI image v části Agent Edge s požadovanou verzí. mcr.microsoft.com/azureiotedge-agent:1.5.1 Například ještě nevybírejte Použít.

4. Vyberte kartu Edge Hub a aktualizujte hodnotu identifikátoru URI obrázku se stejnou požadovanou verzí. Například: mcr.microsoft.com/azureiotedge-hub:1.5.1.

5. Chcete-li uložit změny, vyberte Použít .

6. Vyberte Zkontrolovat a vytvořit, zkontrolujte nasazení, jak je vidět v souboru JSON, a vyberte Vytvořit.

Aktualizace identifikátorů URI partnerského modulu

Pokud používáte partnerské moduly, aktualizujte nasazení modulů pomocí identifikátorů URI imagí poskytovaných partnerem. Pokud chcete získat aktualizovaný identifikátor URI image kontejneru, obraťte se na vydavatele modulu IoT Edge. Aktualizujte konfigurace zařízení pomocí nového identifikátoru URI image poskytnutého vydavatelem.

1. Přihlaste se k portálu Azure a přejděte na svůj IoT Hub.
2. V levém podokně vyberte Zařízení v nabídce Správa zařízení .
3. Ze seznamu vyberte IoT Edge zařízení, které používá partnerový modul.
4. Na horním panelu vyberte Nastavit moduly.
5. Zvolte partnerský modul IoT Edge, který chcete aktualizovat pomocí nového identifikátoru URI obrazu.
6. Aktualizujte hodnotu identifikátoru URI image pomocí nového identifikátoru URI image poskytnutého vydavatelem.
7. Chcete-li uložit změny, vyberte Použít .
8. Vyberte Zkontrolovat a vytvořit, zkontrolujte nasazení, jak je vidět v souboru JSON, a vyberte Vytvořit.

Ověření shody verzí

1. Na vašem zařízení použijte iotedge version ke kontrole verze subsystému zabezpečení. Výstup obsahuje čísla hlavní verze, druhotné verze a revizní verze. Například iotedge 1.5.13.

2. V nastavení runtime nasazení zařízení ověřte, že verze adres URI image edgeHub i edgeAgent odpovídají hlavní a vedlejší verzi subsystému zabezpečení. Pokud je verze subsystému zabezpečení 1.5.15, verze imagí jsou 1.5. Například mcr.microsoft.com/azureiotedge-hub:1.5 a mcr.microsoft.com/azureiotedge-agent:1.5.

Poznámka

Aktualizujte kontejnery subsystému zabezpečení IoT Edge a modulu runtime na stejnou podporovanou verzi verze. I když jsou podporované neodpovídající verze, Microsoft neotestovaly všechny kombinace verzí.

Nejnovější verzi Azure IoT Edge najdete v Azure IoT Edge verzích.

Řešení problémů

Protokoly systému můžete kdykoli zobrazit spuštěním následujících příkazů ze zařízení.

• Začněte řešit potíže pomocí příkazu pro kontrolu . Spustí kolekci testů konfigurace a připojení pro běžné problémy.

  sudo iotedge check --verbose
  

• Pokud chcete zobrazit stav systému IoT Edge, spusťte:

  sudo iotedge system status 
  

• Pokud chcete zobrazit protokoly součástí hostitele, spusťte:

  sudo iotedge system logs
  

• Pokud chcete zkontrolovat opakované problémy hlášené agentem edgeAgent a edgeHubem, spusťte:

  Nezapomeňte nahradit <module> vlastním názvem modulu. Pokud nedojde k žádným problémům, nezobrazí se žádný výstup.

  sudo iotedge logs <module>
  

Další informace najdete v tématu Řešení problémů vašeho zařízení IoT Edge.

Další kroky

Prohlédněte si nejnovější verze Azure IoT Edge.