Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bevor Sie ein Software-Update auf eine Gruppe von Geräten oder auf Geräte, die einem Namespace hinzugefügt werden, bereitstellen können, müssen Sie das Update in Ihren Azure-Geräteregistrierungs-Namespace importieren. Jedes Software-Update besteht aus einer oder mehreren Aktualisierungsdateien und einem Import-Manifest. Das Importmanifest beschreibt die Identität des Updates, die Geräte mit denen es kompatibel ist und wie es installiert werden soll, sodass das Azure Device Registry weiß, für welche Geräte das Update gilt.
Dieser Artikel zeigt Ihnen, wie Sie ein Software-Update aus einem Azure Storage-Container in einen Namespace importieren und wie Sie ein importiertes Update löschen, das Sie nicht mehr benötigen.
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. Diese Vorschau wird ohne Service-Level-Vereinbarung bereitgestellt, und die Funktionalität sowie das Portal-Erlebnis können sich ändern, bevor sie allgemein verfügbar wird. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbedingungen für Microsoft Azure-Vorschauversionen.
Prerequisites
- Ein aktives Azure-Abonnement. Wenn Sie kein Konto haben, erstellen Sie ein kostenloses Konto.
- Ein Azure Device Registry-Namensraum mit aktivierten Software-Updates. Um einen Namensraum zu erstellen und Softwareupdates zu aktivieren, siehe Erste Schritte mit Azure Device Registry.
- Berechtigungen zum Lesen der Aktualisierungsdateien in Ihrem Speicherkonto, wie zum Beispiel die Rolle Storage Blob Data Contributor.
- Berechtigungen zum Importieren von Softwareupdates in den Namespace, wie zum Beispiel die Rolle Device Update Content Administrator auf der Softwareupdates-Instanz, die mit Ihrem Namespace verknüpft ist.
- Ein Azure Storage-Konto mit einem Container, der Ihre Update-Dateien enthält, und einem Import-Manifest:
-
Update-Dateien: Die Dateien, die dein Gerät installiert, wie ein Image, ein Paket oder ein Skript (zum Beispiel
.swuoder.sh). -
Import-Manifest: Eine JSON-Datei mit der
.importmanifest.jsonErweiterung, die das Update beschreibt. Jedes Software-Update erfordert ein Importmanifest. Informationen zum Erstellen finden Sie unter Ein Update für den Import vorbereiten und dem Schema des Importmanifests.
-
Update-Dateien: Die Dateien, die dein Gerät installiert, wie ein Image, ein Paket oder ein Skript (zum Beispiel
Gehe zu Software-Updates in deinem Namespace
- Wechseln Sie im Azure-Portal zu Ihrem Azure Device Registry-Namensraum.
- Im Ressourcenmenü unter Operationen wählen Sie Softwareupdates (Vorschau).
- Auf der Seite Software-Updates (Vorschau) wählen Sie den Reiter Importe , um die bereits in den Namensraum importierten Software-Updates anzuzeigen.
Wenn du noch keine Updates importiert hast, zeigt die Seite Keine Updates zum Anzeigen.
Importiere ein Software-Update
Bei Software-Updates (Vorschau) wählen Sie + Importieren.
Bei Import-Software-Updates wähle unter Dateiauswahl+ Dateien hinzufügen.
Wählen Sie das Speicherkonto aus, das Ihre Update-Dateien enthält, und wählen Sie dann Weiter aus.
Wählen Sie den Container aus, der Ihre Update-Dateien enthält, und wählen Sie dann Weiter aus.
Wähle bei Select files die Update-Dateien und die Import-Manifest-Datei (mit der Erweiterung
.importmanifest.json) aus, die du importieren möchtest.Schließen Sie die Dateiauswahl, um zu Software-Updates importieren zurückzukehren.
Im Beschreibungsfeld geben Sie optional eine Beschreibung für das Update ein.
Wählen Sie unter Malware-Scan, Update-Dateien auf Malware scannen, wenn Sie möchten, dass die Update-Dateien vor dem Import auf bekannte Malware überprüft werden. Malware-Scans sind in ausgewählten Regionen verfügbar.
Klicken Sie auf Importieren.
Wenn der Import erfolgreich ist, erscheint das Update in der Imports-Liste mit Name, Anbieter, Version und Beschreibung. Sie können es jetzt mit einem Software-Update-Job oder einem Onboarding-Update-Job bereitstellen.
Beheben Sie ein fehlendes Importmanifest
Wenn du Dateien aktualisieren ohne Importmanifest auswählst, schlägt der Import mit der Meldung " Kein Importmanifest wurde gefunden" fehl.
- Überprüfen Sie das Fehlerbanner auf der Seite Import-Software-Updates . Es erinnert Sie daran, dass Import-Manifestdateien die Dateierweiterung
.importmanifest.jsonverwenden. - Füge ein Import-Manifest hinzu, das das Update für deinen Speichercontainer beschreibt.
- Wähle Dateien ersetzen und dann deine Update-Dateien sowie das Import-Manifest aus.
- Wählen Sie erneut Import aus.
Note
In dieser Vorschau können Sie kein Importmanifest im Azure-Portal erstellen oder bearbeiten. Erstellen Sie das Importmanifest, bevor Sie das Update importieren.
Import-Eltern- und Kind-Updates
Ein Importmanifest kann auf andere Updates verweisen. Zum Beispiel kann ein Parent-Update auf ein oder mehrere Kind-Updates verweisen, die zusammen oder in einer bestimmten Reihenfolge installiert werden müssen. Wenn Sie ein Elternupdate zusammen mit den Kind-Updates importieren, zeigt die Import-Liste das Eltern-Update mit den zugehörigen Kind-Updates an.
Note
In dieser Vorschau installiert der Software-Update-Client in den einheitlichen Azure IoT-SDKs keine Updates, die auf andere Updates verweisen. Um auf Geräte zu deployen, die den Software-Updates-Client verwenden, importiere Updates, deren Importmanifeste keine Kind-Updates referenzieren. Weitere Informationen finden Sie unter Einschränkungen während der Vorschau.
Software-Update löschen
Wenn du kein importiertes Update mehr brauchst, kannst du es aus dem Namensraum löschen.
- Auf der Seite Software-Updates (Vorschau) wählen Sie den Reiter Importe .
- Wähle das Kontrollkästchen neben dem Update, das du löschen möchtest.
- Klicken Sie auf Löschen.
- Wenn Sie dazu aufgefordert werden, wählen Sie " Löschen" aus, um dies zu bestätigen.
Das Löschen eines Software-Updates wirkt sich nicht auf Geräte aus, die es bereits installiert haben. Allerdings kannst du das Update in einem neuen Job nicht mehr verwenden.