Enhetsuppdatering för plattformar som stöds av IoT Hub

Den här artikeln förklarar vilka operativsystem och komponenter som stöds av Enhetsuppdatering för IoT Hub (DU), oavsett om de är allmänt tillgängliga eller i förhandsversion.

Få support

Om du får problem när du använder tjänsten Enhetsuppdatering finns det flera sätt att söka support. Prova någon av följande kanaler för support:

Rapportera buggar – Den utveckling som sker i DU-produkten äger rum i enhetsuppdateringens öppen källkodsprojekt. Buggar kan rapporteras på problemsidan för projektet. Korrigeringar tar sig snabbt från projekten till produktuppdateringar.

Microsofts kundsupportteam – Användare som har en supportplan kan kontakta Microsofts kundsupportteam genom att skapa en supportbegäran direkt från Azure Portal.

Funktionsförfrågningar – DU-produkten spårar funktionsbegäranden via produktens community för diskussioner om enhetsuppdatering .

Linux-operativsystem

Enhetsuppdatering kan användas med en mängd olika Linux-operativsystem. Alla operativsystem stöds dock inte av Microsoft. Systemen som anges i följande tabell är Linux-distributioner där referensimplementeringen för enhetsuppdateringsagenten kan skapas och köras och har verifierats genom automatiserad testning med varje version.

Du kan skapa enhetsuppdateringsagenten från källan med referensimplementeringen för enhetsuppdateringsagenten, som fungerar som en startpunkt som kan anpassas eller utökas för dina enhetsuppdateringsbehov. Mer information finns i hur du skapar agenten för enhetsuppdateringar.

Det går att portera enhetsuppdateringsagenten med öppen källkod till andra operativsystem. Dessa versioner testas eller underhålls dock inte av Microsoft.

För vissa plattformar kan fördefinierade installationspaket också vara tillgängliga.

Operativsystem AMD64 ARM32v7 ARM64
Debian 11 (Bullseye) Debian 11 + AMD64 Debian 11 + ARM32v7 Debian 11 + ARM64
Debian 12 (Bookworm) Debian 12 + AMD64 Debian 12 + ARM32v7 Debian 12 + ARM64
Debian 13 (Trixie) Debian 13 + AMD64 Debian 13 + ARM32v7 Debian 13 + ARM64
Ubuntu Server 20.04 Ubuntu Server 20.04 + AMD64 Ubuntu Server 20.04 + ARM64
Ubuntu Server 22.04 Ubuntu Server 22.04 + AMD64 Ubuntu Server 22.04 + ARM64
Ubuntu Server 24.04 Ubuntu Server 24.04 + AMD64 Ubuntu Server 24.04 + ARM64

Versioner och support

Du hittar versionsresurser och versionsinformation för Enhetsuppdatering för IoT Hub på sidan Version för Enhetsuppdatering.

I följande tabell sammanfattas stöd för API:er, IoT Plug and Play (PnP)-modeller och referensagenter för enhetsuppdatering.

Enhetsuppdateringsagenter använder IoT Plug and Play-modeller (PnP) för att kommunicera med tjänsten. Modellerna som anges i följande tabell identifierar de gränssnitt som krävs för varje agentversion. Mer information finns i IoT Plug and Play i Azure Device Update för IoT Hub.

Använd en aktuell 1.x-version av referensimplementeringen för enhetsuppdateringsagenten och överväg den senaste tillgängliga versionen för att dra nytta av förbättringar. Den senaste referensimplementeringsversionen för enhetsuppdateringsagenten är 1.3.0.

Versionsinformation och resurser enhetuppdateringsagent Uppgradering som stöds från agentversionen DU PnP-modeller stöds API-versioner
1.3.0 1.3.0
1.1.0 dtmi:azure:iot:deviceUpdateContractModel; 3
dtmi:azure:iot:deviceUpdateModel; 3
2022.10.01
1.2.0 1.2.0
1.1.0 dtmi:azure:iot:deviceUpdateContractModel; 3
dtmi:azure:iot:deviceUpdateModel; 3
2022.10.01
1.1.0 1.1.0 1.0.x dtmi:azure:iot:deviceUpdateContractModel; 3
dtmi:azure:iot:deviceUpdateModel; 3
2022.10.01
1.0.0 1.0.0
1.0.1
1.0.2
0.8.x dtmi:azure:iot:deviceUpdateContractModel; 2
dtmi:azure:iot:deviceUpdateModel; 2
2022.10.01
0.0.8 (förhandsversion)(Inaktuell) 0.8.0
0.8.1
0.8.2
dtmi:azure:iot:deviceUpdateContractModel; 1
dtmi:azure:iot:deviceUpdateModel; 1
2022-10-01
2021-06-01-preview (föråldrad)

Nyare REST-tjänst-API-versioner stöder äldre agenter om inget annat anges. Portalen för enhetsuppdatering använder den senaste API-versionen.

Kommentar

Användare som har utökat från referensagenten och anpassat agenten ansvarar för att säkerställa att felkorrigeringar och säkerhetskorrigeringar införlivas. Du måste också se till att agenten skapas och konfigureras korrekt enligt tjänstens definition för att ansluta till tjänsten, utföra uppdateringar och hantera enheter från IoT-hubben.

Viktigt!

Varje Microsoft-produkt har en livscykel. Livscykeln börjar när en produkt släpps och slutar när den inte längre stöds. Genom att känna till viktiga datum i den här livscykeln kan du fatta välgrundade beslut om när du ska uppgradera eller göra andra ändringar i din programvara.
För Enhetsuppdatering för IoT Hub kommer ingen stabil API- eller agentversion att bli inaktuell utan en ersättande version. Avvecklade stabila versioner kommer att vara tillgängliga i minst tre år efter att utfasningen har tillkännagivits för att tillåta användare att migrera till de agent- och API-versioner som stöds. Förhandsversioner (Prereleases) agenter och API:er hanteras inte efter lanseringen av den stabila versionen. Förhandsversioner släpps för att testa nya funktioner, samla in feedback och identifiera och åtgärda problem. Förhandsversioner är tillgängliga under kompletterande användningsvillkor och rekommenderas inte för produktionsarbetsbelastningar. 0.7.0 (förhandsversion) stöds inte av de senaste tjänst- och API-versionerna.
Med den senaste stabila versionen rekommenderar vi att alla nuvarande kunder som kör 0.x.x uppgraderar sina enheter till 1.0.x för att få löpande support.