Podstawy aktualizacji oprogramowania (podgląd)

Korzystaj z funkcji Software updates w usłudze Azure Device Registry, aby na dużą skalę dostarczać aktualizacje OTA na swoje urządzenia. Importuj aktualizacje do przestrzeni nazw Azure Device Registry, a następnie używaj zadań i grup w tej przestrzeni, aby wdrożyć je na urządzenia.

Important

Aktualizacje oprogramowania Azure Device Registry są obecnie w fazie podglądu. Obecna wersja zapoznawcza dotyczy urządzeń podłączonych do IoT Hub. Nie używaj funkcji w wersji zapoznawczej do obciążeń produkcyjnych. W przypadku obciążeń produkcyjnych nadal korzystaj z Device Update for IoT Hub, który pozostaje powszechnie dostępny.

Zobacz dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta, wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane w wersji ogólnodostępnej.

Możliwość stosowania usługi

Feature	Operacje Azure IoT	Azure IoT Hub
Aktualizacje oprogramowania	Nie dotyczy	Preview

Aktualizacje oprogramowania i Device Update dla IoT Hub

Aktualizacje oprogramowania wprowadzają możliwości aktualizacji zdalnych (OTA) do Azure Device Registry. Używa tego samego formatu manifestu importu co Device Update dla IoT Hub i pozwala zarządzać aktualizacjami na poziomie przestrzeni nazw za pomocą grup i zadań Azure Device Registry.

Skorzystaj z poniższych wskazówek, aby wybrać właściwą opcję:

Jeśli...	Używanie
Potrzebne są aktualizacje bezprzewodowe dla obciążeń produkcyjnych	Device Update for IoT Hub, która pozostaje powszechnie dostępna i wspierana.
Ocena zarządzania aktualizacjami za pomocą przestrzeni nazw, grup i zadań Azure Device Registry	Aktualizacje oprogramowania (wersja zapoznawcza) opisane w tym artykule.

Pamiętaj o następujących kwestiach, jeśli już korzystasz z Device Update dla IoT Hub:

Nie możesz używać obu na tym samym hubie IoT. W tym podglądzie możesz używać aktualizacji oprogramowania tylko z hubami IoT, które nie mają istniejącej instancji Device Update for IoT Hub. Aby spróbować aktualizacji oprogramowania, podłącz IoT hub, który nie korzysta z Device Update for IoT Hub, do swojej przestrzeni nazw.
Urządzenia używają innego klienta. Urządzenia korzystające z agenta Device Update nie mogą otrzymywać aktualizacji w ramach aktualizacji oprogramowania. Aby otrzymywać aktualizacje oprogramowania, urządzenie korzysta z klienta aktualizacji oprogramowania w zunifikowanych SDK Azure IoT (podgląd).

Jak działają aktualizacje oprogramowania

Włączasz aktualizacje oprogramowania w obszarze nazw Azure Device Registry, zarówno podczas konfigurowania tego obszaru nazw, jak i później. Aby dowiedzieć się, jak, zobacz Wprowadzenie do Azure Device Registry (wersja zapoznawcza). Funkcja ta wprowadza następujące komponenty:

Aktualizacja oprogramowania: Aktualizacja, którą importujesz do przestrzeni nazw. Aktualizacja oprogramowania składa się z jednego lub więcej plików aktualizacji oraz manifestu importu. Po zaimportowaniu aktualizacji oprogramowania jest ona dostępna dla zadań aktualizacji oprogramowania i zadań aktualizacji wdrożeniowych w tej przestrzeni nazw.
Zadanie aktualizacji oprogramowania: Stosuje aktualizację oprogramowania do kompatybilnych urządzeń w grupie docelowej.
Zadanie aktualizacji wdrażania: Stosuje aktualizację oprogramowania do kompatybilnych urządzeń, gdy sprawdzają aktualizacje podczas wdrażania, zanim się zarejestrują i rozpoczną działanie.
Klient aktualizacji oprogramowania: Część zunifikowanych SDK Azure IoT (podgląd), której używa Twoja aplikacja na urządzeniu do sprawdzania, pobierania i instalowania aktualizacji oraz raportowania wyników.

Typowy proces aktualizacji wygląda tak:

Pliki aktualizacji i manifest importu przesyłasz do kontenera Azure Storage.
Importujesz aktualizację oprogramowania do swojej przestrzeni nazw.
Tworzysz zadanie skierowane do grupy lub, w celu onboardingu, przestrzeni nazw.
Każde urządzenie sprawdza, czy są dostępne aktualizacje, i raportuje swoje właściwości kompatybilności. Jeśli urządzenie jest kompatybilne, otrzymuje aktualizację.
Urządzenie pobiera i instaluje aktualizację, a następnie raportuje wynik. Monitorujesz postępy i wyniki na poziomie urządzenia podczas uruchomienia zadania.

Aktualizacje oprogramowania

Aktualizacja oprogramowania składa się z dwóch komponentów, które przesyłasz razem:

Pliki aktualizacji: Pakiet, który urządzenie instaluje. Ładunek danych może być obrazem oprogramowania sprzętowego, pakietem oprogramowania, skryptem lub wieloma powiązanymi plikami.
Manifest importu: plik JSON z rozszerzeniem .importmanifest.json opisującym aktualizację. Manifest importowy deklaruje:
- Zaktualizuj tożsamość: dostawca, nazwa i wersja, które jednoznacznie identyfikują aktualizację. Dostawca i nazwa razem identyfikują rodzinę aktualizacji, na przykład wszystkie wersje oprogramowania układowego dla danego modelu urządzenia.
- Właściwości kompatybilności: Właściwości urządzenia, które decydują, które urządzenia mogą zainstalować aktualizację. Więcej informacji można znaleźć w artykule Kompatybilność urządzeń.
- Instrukcje montażu: Kroki instalacji, ich kolejność oraz procedura obsługi dla każdego kroku. Handler informuje urządzenie, jak wykonać ten krok, na przykład instalując pakiet, uruchamiając skrypt lub zapisując obraz.
- Metadane pliku: Nazwa, rozmiar i skrót każdego pliku aktualizacyjnego. Usługa wykorzystuje te skróty do weryfikacji integralności pliku przy imporcie, a urządzenie może ich użyć do weryfikacji każdego pliku przed instalacją.

Każda aktualizacja oprogramowania wymaga manifestu importowego. Jeśli spróbujesz zaimportować pliki aktualizacji bez manifestu importu, import się nie udaje. Podczas importu możesz opcjonalnie zeskanować pliki aktualizacji pod kątem złośliwego oprogramowania. Skanowanie malware jest dostępne w wybranych regionach. Instrukcje krok po kroku znajdziesz w artykule Import aktualizacji oprogramowania.

Poniższy przykład pokazuje manifest importu dla aktualizacji opartej na obrazach:

{
  "updateId": {
    "provider": "Contoso",
    "name": "IrrigationControllerV2-Image",
    "version": "1.3.0"
  },
  "isDeployable": true,
  "compatibility": [
    {
      "manufacturer": "Contoso",
      "model": "IrrigationControllerV2"
    }
  ],
  "instructions": {
    "steps": [
      {
        "type": "inline",
        "description": "Update the device image to version 1.3.0",
        "handler": "microsoft/swupdate:1",
        "files": [
          "contoso-irrigation-controller-v2-1.3.0.swu"
        ],
        "handlerProperties": {
          "installedCriteria": "1.3.0"
        }
      }
    ]
  },
  "files": [
    {
      "filename": "contoso-irrigation-controller-v2-1.3.0.swu",
      "sizeInBytes": 112738816,
      "hashes": {
        "sha256": "wPdNKUSmWTZkR6Pum9oR/EIzdn5AvON4dsXME+/gHVw="
      }
    }
  ],
  "createdDateTime": "2026-10-01T06:56:51.2002204Z",
  "manifestVersion": "5.0"
}

Aktualizacje oprogramowania używają tego samego formatu manifestu importowego co Device Update dla IoT Hub. Aby dowiedzieć się, jak tworzyć manifest importu, zobacz:

Zgodność urządzenia

Właściwości kompatybilności w dokumencie importu określają, które urządzenia mogą zainstalować aktualizację oprogramowania. Gdy urządzenie sprawdza aktualizacje, raportuje własne właściwości kompatybilności. Azure Device Registry porównuje te właściwości z właściwościami kompatybilności zadeklarowanymi w aktualizacji oprogramowania.

Definiujesz właściwości zgodności jako pary nazwa-wartość. Każda aktualizacja oprogramowania musi deklarować co najmniej jedną właściwość kompatybilności. manufacturer i model są powszechnym wyborem, ale nie są wymagane. Użyj dowolnych właściwości pasujących do twojej floty, takich jak region lub environment.

Sekcja compatibility manifestu importu to tablica zestawów właściwości. Przykład:

"compatibility": [
  {
    "manufacturer": "Contoso",
    "model": "IrrigationControllerV2"
  }
]

Dopasowywanie działa następująco:

Urządzenie musi spełniać wszystkie właściwości w zestawie. Poprzednia aktualizacja dotyczy tylko urządzeń, które raportują zarówno manufacturer jako Contoso, jak i model jako IrrigationControllerV2. Nie dotyczy urządzenia Contoso SoilSensorV1 ani urządzenia IrrigationControllerV2, które wskazuje innego producenta.
Urządzenie musi pasować tylko do jednego zestawu. Jeśli zadeklarujesz więcej niż jeden zestaw właściwości, jedna aktualizacja oprogramowania może dotyczyć wielu typów urządzeń.
Każdy zestaw właściwości należy do jednej rodziny aktualizacji. Nie możesz używać dokładnie tego samego zestawu właściwości kompatybilności z więcej niż jedną kombinacją dostawcy i nazwy. Zaplanuj razem grupy aktualizacji i właściwości zgodności. Więcej informacji można znaleźć w artykule Pojęcia związane z importem.

Grupa może zawierać urządzenia o różnych właściwościach kompatybilności. Zadanie aktualizacji oprogramowania stosuje aktualizację tylko do zgodnych urządzeń w grupie docelowej. Na przykład, jeśli grupa zawiera 18 IrrigationControllerV2 urządzeń i sześć SoilSensorV1 urządzeń, aktualizacja dla IrrigationControllerV2 tych urządzeń jest stosowana do 18 kompatybilnych urządzeń. Sześć SoilSensorV1 urządzeń nie jest dotkniętych.

Wskazówka

Urządzenia raportują swoje właściwości zgodności do Azure Device Registry, więc możesz użyć ich w zapytaniu grupy do tworzenia grup zawierających tylko urządzenia, do których ma zastosowanie aktualizacja.

Zadania, grupy i zachowanie wdrażania

Wdrażasz aktualizację oprogramowania, tworząc zadanie w przestrzeni nazw. Aktualizacja oprogramowania obsługuje dwa typy zadań:

Typ zadania	Target	Kiedy należy go używać
Aktualizacja oprogramowania	Grupa usługi Azure Device Registry	Zaktualizuj zarejestrowane urządzenia, które już działają. Grupa definiuje zakres zadania, a właściwości kompatybilności decydują, na których urządzeniach w tym zakresie zostanie zainstalowana aktualizacja.
Aktualizacja wdrożenia	Przestrzeń nazw Azure Device Registry	Doprowadź urządzenia do wymaganej wersji oprogramowania w momencie ich wdrażania, zanim zaczną działać. Na przykład użyj aktualizacji wdrożeniowej dla urządzeń, które spędziły pewien czas w magazynie i mają starsze oprogramowanie.

Zadanie aktualizacji oprogramowania nie kończy się po dotarciu do kompatybilnych urządzeń w momencie jego rozpoczęcia. Podczas gdy wykonywanie zadania jest aktywne, nadal stosuje aktualizację do:

Urządzenia, które były offline w momencie rozpoczęcia zadania, po ponownym połączeniu i sprawdzeniu aktualizacji.
Urządzenia należące do grupy docelowej. Członkostwo w grupie nie jest aktualizowane automatycznie: nowe urządzenia dołączają do grupy przy następnym odświeżaniu członkostwa. Więcej informacji można znaleźć w artykule Członkostwo w pamięci podręcznej i odświeżenie.
Na przykład urządzenia, które kwalifikują się do aktualizacji, ponieważ ich zgłaszane właściwości kompatybilności się zmieniają.

Zadanie aktualizacji onboardingu pozostaje aktywne, dopóki go nie zakończysz, więc kompatybilne urządzenia nadal otrzymują aktualizację podczas onboardingu.

Informacje o stanach zadań, harmonogramowaniu i monitorowaniu zawiera artykuł Jobs concepts (podgląd).

Uwagi dotyczące Device SDK

Urządzenia otrzymują aktualizacje oprogramowania za pośrednictwem klienta aktualizacji oprogramowania w zunifikowanych SDK Azure IoT (podgląd). Weź na uwadze następujące kwestie, planując oprogramowanie urządzenia:

Obsługiwane urządzenia: W tej wersji zapoznawczej klient aktualizacji oprogramowania jest przeznaczony głównie dla urządzeń opartych na Linuksie, które mają więcej niż 32 MB dostępnej pamięci.
Integracja: SDK to biblioteka, a nie gotowy do uruchomienia agent. Integrujesz klienta aktualizacji oprogramowania z aplikacją na urządzeniu i dostarczasz logikę pobierania, instalacji i wdrażania aktualizacji na Twoim sprzęcie. Microsoft udostępnia przykłady, które pomogą Ci zacząć.
Dwa sposoby sprawdzania aktualizacji: Urządzenie, które jest wdrażane, sprawdza aktualizacje wdrażania, zanim się zarejestruje. Zarejestrowane urządzenie sprawdza, czy są dostępne aktualizacje oprogramowania z zadania aktualizacji oprogramowania. To aplikacja na urządzeniu decyduje, kiedy sprawdzać dostępność aktualizacji.
Łączność: Urządzenie sprawdza aktualizacje i raportuje wyniki przez połączenie z usługą Device Provisioning Service. Nie potrzebuje osobnego endpointu ani poświadczenia, aby otrzymywać aktualizacje.
Bezpieczeństwo: Zanim klient aktualizacji oprogramowania pobierze jakiekolwiek pliki aktualizacyjne, weryfikuje podpis informacji o aktualizacji otrzymanych od usługi. Urządzenia pobierają pliki aktualizacji tylko przez HTTPS, więc treść aktualizacji jest zawsze szyfrowana podczas transportu. Upewnij się, że Twoje urządzenia mogą nawiązywać połączenia HTTPS wychodzące, aby pobierać pliki aktualizacji.
Raportowanie statusu: Po próbie instalacji urządzenie zgłasza wynik, w tym kody błędów, jeśli instalacja się nie powiodła. Wynik pojawia się w wynikach wykonania zadania na poziomie urządzenia.
Twoja odpowiedzialność: Jesteś odpowiedzialny za weryfikację integracji w swoim środowisku, w tym za zachowanie mechanizmu odzyskiwania, jeśli instalacja się nie powiedzie lub urządzenie uruchomi się ponownie podczas aktualizacji.

Ograniczenia wersji zapoznawczej

Bieżąca wersja zapoznawcza ma następujące ograniczenia:

Aktualizacje oprogramowania dla urządzeń podłączonych do IoT Hub. Urządzenia i zasoby Operacje Azure IoT nie są obsługiwane w tej wersji zapoznawczej.
Nie możesz używać aktualizacji oprogramowania z centrum IoT, które ma istniejące wystąpienie usługi Device Update for IoT Hub.
Każda aktualizacja oprogramowania wymaga manifestu importu. Nie możesz utworzyć manifestu importu w portalu Azure.
Klient aktualizacji oprogramowania obecnie nie obsługuje aktualizacji proxy ani aktualizacji korzystających z kroków odwołania (aktualizacji nadrzędnych i podrzędnych).

Aby poznać ograniczenia dotyczące importowanych aktualizacji, takie jak maksymalny rozmiar aktualizacji, zobacz Limity usługi Device Update dla IoT Hub. Aby poznać ograniczenia dotyczące grup i zadań, zobacz Koncepcje grup (podgląd) oraz Koncepcje zadań (podgląd).

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-05