Software-Update-Konzepte (Vorschau)

Nutzen Sie Software-Updates, eine Funktion von Azure Device Registry, um Over-the-Air-Updates in großem Maßstab auf Ihren Geräten bereitzustellen. Importiere Updates in einen Azure Device Registry-Namensraum und nutze dann Jobs und Gruppen in diesem Namensraum, um sie auf Geräten bereitzustellen.

Wichtig

Die Software-Updates für Azure Device Registry befinden sich derzeit in der Vorschau. Die aktuelle Vorschau gilt für mit IoT Hub verbundene Geräte. Nutzen Sie keine Vorschaufunktionen für Produktionsworkloads. Für Produktionsworkloads verwenden Sie weiterhin Device Update for IoT Hub, das weiterhin allgemein verfügbar ist.

Die zusätzlichen Nutzungsbestimmungen für Microsoft Azure-Vorschauen enthalten rechtliche Bedingungen. Sie gelten für diejenigen Azure-Features, die sich in der Beta- oder Vorschauversion befinden oder aber anderweitig noch nicht zur allgemeinen Verfügbarkeit freigegeben sind.

Diagramm zeigt einen Software-Update-Job, der eine Gruppe von Geräten anspricht, und einen Onboarding-Update-Job, der Geräte anspricht, die innerhalb eines Azure Device Registry-Namensraums onboardet werden.

Anwendbarkeit des Dienstes

Feature Azure IoT-Vorgänge Azure IoT Hub
Software-Updates Nicht zutreffend Preview

Software-Updates und Geräte-Update für IoT Hub

Software-Updates bringen Over-the-Air-Update-Funktionen in das Azure Device Registry. Es verwendet dasselbe Import-Manifest-Format wie Device Update for IoT Hub und ermöglicht es, Updates auf Namensraumebene mithilfe von Azure Device Registry-Gruppen und -Jobs zu verwalten.

Verwenden Sie die folgenden Anleitungen, um die richtige Option zu wählen:

Wenn Sie... Verwenden
Benötigen Sie Over-the-Air-Updates für Produktionsworkloads? Geräte-Update für IoT Hub, das weiterhin allgemein verfügbar und unterstützt wird.
Sie möchten die Verwaltung von Updates über Azure Device Registry-Namensräume, Gruppen und Jobs evaluieren Software-Updates (Vorschau), die in diesem Artikel beschrieben werden.

Behalte folgende Überlegungen im Hinterkopf, wenn du bereits Device Update für IoT Hub nutzt:

  • Man kann nicht beide auf demselben IoT-Hub verwenden. In dieser Vorschau können Sie Software-Updates nur mit IoT-Hubs verwenden, die keine bestehende Device Update für IoT Hub-Instanz haben. Um Software-Updates auszuprobieren, verbinden Sie einen IoT hub, der Device Update for IoT Hub nicht verwendet, mit Ihrem Namensraum.
  • Geräte verwenden einen anderen Client. Geräte, die den Device Update Agent ausführen, können keine Updates von Software-Updates erhalten. Um Software-Updates zu erhalten, verwendet ein Gerät den Software-Update-Client in den einheitlichen Azure IoT SDKs (Vorschau).

Wie Software-Updates funktionieren

Sie aktivieren Software-Updates auf einem Azure Device Registry-Namensraum, entweder beim Einrichten des Namensraums oder später. Informationen dazu finden Sie unter Erste Schritte mit Azure Device Registry für Azure IoT Hub. Die Funktion führt folgende Komponenten ein:

  • Software-Update: Ein Update, das Sie in einen Namensraum importieren. Ein Software-Update besteht aus einer oder mehreren Aktualisierungsdateien und einem Import-Manifest. Nachdem du ein Software-Update importiert hast, steht es für Software-Update-Jobs und Onboarding-Update-Jobs in diesem Namensraum zur Verfügung.
  • Software-Update-Job: Wendet ein Software-Update auf die kompatiblen Geräte in einer Zielgruppe an.
  • Onboarding-Update-Job: Wendet ein Software-Update auf kompatible Geräte an, wenn sie während des Onboardings nach Updates suchen, bevor sie sich registrieren und den Betrieb aufnehmen.
  • Software-Update-Client: Der Teil der einheitlichen Azure IoT SDKs (Vorschau), den Ihre Geräteanwendung verwendet, um Softwareupdates zu prüfen, herunterzuladen und zu installieren sowie die Ergebnisse zu melden.

Ein typischer Update-Ablauf sieht so aus:

  1. Du lädst die Update-Dateien und das Importmanifest in einen Azure Storage-Container hoch.
  2. Du importierst das Software-Update in deinen Namensraum.
  3. Du erstellst einen Job, der eine Gruppe anspricht oder, zum Onboarding, den Namespace.
  4. Jedes Gerät überprüft Updates und meldet seine Kompatibilitätseigenschaften. Wenn das Gerät kompatibel ist, erhält es das Update.
  5. Das Gerät lädt das Update herunter und installiert es und meldet dann das Ergebnis. Sie überwachen den Fortschritt und die Ergebnisse auf Geräteebene während des Job-Runs.

Software-Updates

Ein Software-Update besteht aus zwei Komponenten, die Sie zusammen hochladen:

  • Aktualisierungsdateien: Die Payload, die das Gerät installiert. Die Nutzlast kann ein Firmware-Abbild, ein Softwarepaket, ein Skript oder mehrere verwandte Dateien sein.
  • Import-Manifest: Eine JSON-Datei mit der .importmanifest.json Erweiterung, die das Update beschreibt. Das Importmanifest gibt an:
    • Aktualisierungsidentität: Der Anbieter, Name und Version, die das Update eindeutig identifizieren. Der Anbieter und der Name zusammen identifizieren eine Update-Familie, zum Beispiel alle Firmware-Versionen für ein Gerätemodell.
    • Kompatibilitätseigenschaften: Die Geräteeigenschaften, die bestimmen, welche Geräte das Update installieren können. Weitere Informationen finden Sie unter Gerätekompatibilität.
    • Installationsanleitungen: Die Installationsschritte, ihre Reihenfolge und der Handler für jeden Schritt. Der Handler teilt dem Gerät mit, wie dieser Schritt angewendet werden soll, zum Beispiel durch das Installieren eines Pakets, das Ausführen eines Skripts oder das Schreiben eines Images.
    • Dateimetadaten: Name, Größe und Hash jeder Update-Datei. Der Dienst verwendet die Hashes, um die Dateiintegrität beim Import zu überprüfen, und das Gerät kann sie nutzen, um jede Datei vor der Installation zu überprüfen.

Jedes Software-Update erfordert ein Importmanifest. Wenn du versuchst, Update-Dateien ohne Import-Manifest zu importieren, schlägt der Import fehl. Beim Importieren kannst du die Update-Dateien optional auf Malware scannen. Malware-Scans sind in ausgewählten Regionen verfügbar. Für Schritt-für-Schritt-Anweisungen siehe Software-Update importieren.

Das folgende Beispiel zeigt ein Importmanifest für ein imagebasiertes Update:

{
  "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"
}

Software-Updates verwenden dasselbe Import-Manifest-Format wie Device Update for IoT Hub. Um zu lernen, wie man ein Importmanifest erstellt, siehe:

Gerätekompatibilität

Die Kompatibilitätseigenschaften in einem Importmanifest bestimmen, welche Geräte ein Software-Update installieren können. Wenn ein Gerät nach Updates sucht, meldet es seine eigenen Kompatibilitätseigenschaften. Das Azure Device Registry vergleicht diese Eigenschaften mit den im Softwareupdate deklarierten Kompatibilitätseigenschaften.

Man definiert Kompatibilitätseigenschaften als Name-Wert-Paare. Jedes Softwareupdate muss mindestens eine Kompatibilitätseigenschaft deklarieren. manufacturer und model sind gängige Optionen, aber sie sind nicht zwingend erforderlich. Verwenden Sie beliebige Eigenschaften, die zu Ihrer Flotte passen, wie zum Beispiel region oder environment.

Der compatibility Abschnitt des Importmanifests ist ein Array von Eigenschaftssätzen. Beispiele:

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

Das Matching funktioniert wie folgt:

  • Ein Gerät muss mit jeder Eigenschaft in einer Menge übereinstimmen. Das vorherige Update gilt nur für Geräte, die sowohl manufacturer als Contoso als auch model als IrrigationControllerV2 melden. Sie gilt nicht für ein Contoso-Gerät SoilSensorV1 oder für ein IrrigationControllerV2 Gerät, das einen anderen Hersteller angibt.
  • Ein Gerät muss nur zu einem Set passen. Wenn Sie mehr als einen Eigenschaftssatz deklarieren, kann ein einziges Software-Update auf mehrere Gerätetypen angewendet werden.
  • Jede Eigenschaftsmenge gehört zu einer Update-Familie. Du kannst nicht exakt dieselbe Menge an Kompatibilitätseigenschaften mit mehr als einer Kombination aus Anbieter und Name verwenden. Plane deine Update-Familien und Kompatibilitätseigenschaften gemeinsam. Weitere Informationen finden Sie unter Konzepte für den Import.

Eine Gruppe kann Geräte mit unterschiedlichen Kompatibilitätseigenschaften enthalten. Ein Software-Update-Job wendet das Update nur auf die kompatiblen Geräte in der Zielgruppe an. Wenn beispielsweise eine Gruppe 18 IrrigationControllerV2 Geräte und sechs SoilSensorV1 Geräte enthält, wird ein Update für IrrigationControllerV2 Geräte auf die 18 kompatiblen Geräte angewendet. Die sechs SoilSensorV1 Geräte sind nicht betroffen.

Tip

Geräte melden ihre Kompatibilitätseigenschaften an die Azure Device Registry, sodass Sie sie in einer Gruppenabfrage verwenden können, um Gruppen zu erstellen, die nur die Geräte enthalten, für die ein Update gilt.

Jobs, Gruppen und Rollout-Verhalten

Du deployest ein Software-Update, indem du einen Job im Namensraum erstellst. Software-Update unterstützt zwei Jobtypen:

Auftragstyp Target Wann wird es verwendet?
Softwareupdate Eine Azure Device Registry group Aktualisieren Sie registrierte Geräte, die bereits in Betrieb sind. Die Gruppe definiert den Geltungsbereich des Jobs, und Kompatibilitätseigenschaften bestimmen, welche Geräte in diesem Geltungsbereich das Update installieren.
Onboarding-Update Der Azure Device Registry-Namensraum Bringen Sie Geräte während des Onboardings auf eine erforderliche Softwareversion, bevor sie in Betrieb genommen werden. Verwenden Sie zum Beispiel ein Onboarding-Update für Geräte, die eine Zeit lang gelagert wurden und mit älterer Firmware ausgestattet sind.

Ein Software-Update-Job stoppt nicht, nachdem er die Geräte erreicht hat, die bei seinem Start kompatibel sind. Während der Job-Run aktiv ist, wird das Update weiterhin angewendet auf:

  • Geräte, die offline waren, als der Job begann, nachdem sie sich wieder verbunden haben und nach Updates gesucht haben.
  • Geräte, die sich der Zielgerätegruppe anschließen. Die Gruppenmitgliedschaft wird nicht automatisch aktualisiert: Neue Geräte treten der Gruppe beim nächsten Aktualisieren der Mitgliedschaft bei. Weitere Informationen finden Sie unter Zwischengespeicherte Gruppenmitgliedschaft und Aktualisierung.
  • Geräte, die für das Update infrage kommen, zum Beispiel, weil sich ihre gemeldeten Kompatibilitätseigenschaften ändern.

Ein Onboarding-Update-Job bleibt aktiv, bis du ihn beendest, sodass kompatible Geräte das Update weiterhin erhalten, beim Onboarding.

Für Job-Status, Terminplanung und Überwachung siehe Jobs-Konzepte (Vorschau).

Hinweise zum Geräte-SDK

Geräte erhalten Software-Updates über den Software-Updates-Client in den einheitlichen Azure IoT SDKs (Vorschau). Beachten Sie bei der Planung Ihrer Gerätesoftware folgende Überlegungen:

  • Unterstützte Geräte: In dieser Vorschau ist der Software-Update-Client hauptsächlich für Linux-basierte Geräte mit mehr als 32 MB verfügbarem Speicher konzipiert.
  • Integration: Das SDK ist eine Bibliothek, kein einsatzbereiter Agent. Sie integrieren den Software-Update-Client in Ihre Geräteanwendung und stellen die Logik bereit, die Ihre Hardware herunterlädt, installiert und aktualisiert. Microsoft stellt Ihnen Beispiele zur Verfügung, um Ihnen den Einstieg zu erleichtern.
  • Zwei Möglichkeiten, Updates zu überprüfen: Ein Gerät, das in Onboarding aufgenommen wird, überprüft vor der Registrierung nach Onboarding-Updates. Ein registriertes Gerät prüft im Rahmen eines Software-Update-Jobs auf Software-Updates. Ihre Geräteanwendung entscheidet, wann sie nach Updates sucht.
  • Konnektivität: Das Gerät prüft Updates und meldet Ergebnisse über seine Device Provisioning Service-Verbindung. Es braucht keinen separaten Endpunkt oder eine separate Zugangsberechtigung, um Updates zu erhalten.
  • Sicherheit: Bevor er Update-Dateien herunterlädt, überprüft der Software-Update-Client die Signatur der Update-Informationen, die er vom Dienst erhält. Geräte laden Update-Dateien nur über HTTPS herunter, daher werden Update-Inhalte während der Übertragung immer verschlüsselt. Stellen Sie sicher, dass Ihre Geräte ausgehende HTTPS-Verbindungen herstellen können, um Update-Dateien herunterzuladen.
  • Statusmeldung: Nach einem Installationsversuch meldet das Gerät das Ergebnis, einschließlich Fehlercodes, falls die Installation fehlgeschlagen ist. Das Ergebnis erscheint in den Ergebnissen auf Geräteebene der Jobausführung.
  • Ihre Verantwortung: Sie sind verantwortlich für die Validierung der Integration in Ihrer eigenen Umgebung, einschließlich des Wiederherstellungsverhaltens, falls eine Installation fehlschlägt oder das Gerät während eines Updates neu startet.

Einschränkungen bei der Vorschau

Die aktuelle Vorschau hat die folgenden Einschränkungen:

  • Software-Updates unterstützen mit IoT Hub verbundene Geräte. Azure IoT Einsatz-Geräte und -Assets werden in dieser Vorschau nicht unterstützt.
  • Man kann keine Software-Updates mit einem IoT Hub verwenden, der bereits eine Device Update für IoT Hub-Instanz hat.
  • Jedes Software-Update erfordert ein Importmanifest. Du kannst kein Importmanifest im Azure-Portal erstellen.
  • Der Software-Update-Client unterstützt derzeit keine Proxy-Updates oder Updates, die Referenzschritte (Parent- und Child-Updates) verwenden.

Für Grenzwerte, die für importierte Updates gelten, wie die maximale Update-Größe, siehe Device Update für IoT Hub-Grenzwerte. Für Einschränkungen, die für Gruppen und Jobs gelten, siehe Gruppenkonzepte (Vorschau) und Jobkonzepte (Vorschau).