Lernprogramm: Erstellen einer Cloudbereitstellung
Wichtig
Dies ist die Dokumentation zu Azure Sphere (Legacy). Azure Sphere (Legacy) wird am 27. September 2027 eingestellt, und Benutzer müssen bis zu diesem Zeitpunkt zu Azure Sphere (integriert) migrieren. Verwenden Sie die Versionsauswahl oberhalb des Inhaltsverzeichniss, um die Dokumentation zu Azure Sphere (Integriert) anzuzeigen.
In diesem Schnellstart erfahren Sie, wie Sie Ihre erste cloudbasierte Anwendungsbereitstellung erstellen. Bei der cloudbasierten Bereitstellung wird eine Anwendung über eine Bereitstellung bereitgestellt, die einer Gerätegruppe innerhalb des Ziels Produkt zugewiesen wurde.
In diesem Tutorial lernen Sie Folgendes:
- Ein Produkt erstellen
- Aktivieren der cloudbasierten Bereitstellung für Ihr Gerät
- Erstellen der Bereitstellung
- Auslösen der Bereitstellung
- Erneutes Aktivieren der Entwicklung und des Debuggens
Voraussetzungen
- Ihr Azure Sphere-Gerät ist mit Ihrem Computer und mit dem Internet verbunden.
- Sie haben das Lernprogramm abgeschlossen: Erstellen Sie eine allgemeine Anwendung und verfügen über eine Bildpaketdatei für Ihre Anwendung.
Ein Produkt erstellen
Ein Produkt identifiziert ein Modell des Azure Sphere-Geräts, das eine bestimmte Funktion ausführt und eine bestimmte Anwendung ausführt.
Wenn Sie noch kein Produkt haben, erstellen Sie eines mit dem Befehl azsphere product Create.
azsphere product create --name MyProduct --description "My First Product"
Produktnamen müssen innerhalb Ihres Azure Sphere-Mandanten eindeutig sein und die Groß-/Kleinschreibung wird nicht beachtet. Wenn der Name Leerzeichen enthält, schließen Sie ihn wie im Beispiel in doppelte Anführungszeichen in Befehle ein.
Der Befehl "azsphere product create" erstellt automatisch fünf Standardgerätegruppen für das neue Produkt: Entwicklung, Feldtest, Produktion, Feldtest os Evaluation und Production OS Evaluation. Gerätegruppen bieten ihnen eine Möglichkeit, Ihre Geräte entsprechend ihrer Verwendung zu organisieren.
Aktivieren der cloudbasierten Bereitstellung für Ihr Gerät
Bevor Sie den cloudbasierten Bereitstellungsprozess testen, muss Ihr Azure Sphere-Gerät bereit für den Empfang cloudbasierter Anwendungsupdates sein. Verwenden Sie den Befehl "azsphere device enable-cloud-test ", um Ihr Gerät vorzubereiten:
azsphere device enable-cloud-test --product MyProduct
Dieser Befehl:
- Identifiziert das Gerät als MyProduct-Modell, das im vorherigen Schritt erstellt wurde.
- Weist das Gerät der Gruppe "Feldtestgeräte" zu, die cloudbasierte Anwendungsupdates ermöglicht.
- Deaktiviert die Möglichkeit für das SDK, Anwendungen auf das Gerät zu laden, sodass nur cloudbasierte Anwendungen geladen werden können.
Der Azure Sphere-Sicherheitsdienst bestimmt anhand der Gerätegruppe und des Produkts, ob die Anwendung auf einem Gerät aktualisiert werden soll.
Erstellen der Bereitstellung
Bei einer Bereitstellung handelt es sich um einen Satz von Images, die über den Azure Sphere- Clouddienst auf den Geräten innerhalb einer bestimmten Gerätegruppe bereitgestellt werden können.
So erstellen Sie eine Bereitstellung
- Laden Sie das Bildpaket mit azsphere image add in Ihren Azure Sphere-Mandanten hoch.
- Erstellen Sie eine neue Bereitstellung für eine Gerätegruppe für die hochgeladenen Images mithilfe der Azsphere-Gerätegruppenbereitstellung.
- Laden Sie das Bildpaket hoch:
azsphere image add --image <path-to-image>
Die Ausgabe sollte etwa wie folgt aussehen:
Uploading image from file 'Blink.imagepackage':
--> Image ID: <image-ID>
--> Component ID: <component-ID>
--> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.
Im nächsten Schritt verwenden Sie die Bild-ID.
- Erstellen einer neuen Bereitstellung für eine Gerätegruppe:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>
or
azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>
Für das Produkt "MyProduct" und "Gerätegruppe Feldtest" können Sie dieses zweite Formular verwenden, um Ihre Bereitstellung ganz einfach zu erstellen:
azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>
Um mehrere Werte für --images die Eingabe einer Liste von Werten bereitzustellen, die durch Leerzeichen getrennt sind.
Der --device-group Parameter identifiziert die Gerätegruppe. Die Gerätegruppen-ID stellt eine GUID bereit, die die Gerätegruppe für alle Produkte eindeutig identifiziert. Alternativ können Sie das Produktnamen- und Gerätegruppennamenpaar im <Produktnamen>-/<Gerätegruppennamenformat> verwenden. Durch diese Namenskombination wird eine Gerätegruppe für ein bestimmtes Produkt eindeutig identifiziert.
Geben Sie die Gerätegruppe "Feldtest" und den Namen des Produkts an, das Sie in "Erstellen eines Produkts" erstellt haben.
Ersetzen Sie <die Image-ID> durch die Bild-ID des Bildpakets, das Sie im Lernprogramm erstellt haben: Erstellen Einer allgemeinen Anwendung. Informationen zum Abrufen der Image-ID finden Sie unter Azure Sphere CLI unter azsphere device-group deployment create for information on getting the image ID.
Um zu überprüfen, ob die Bereitstellung eingerichtet ist, verwenden Sie den Befehl "azsphere device image list-targeted ".
Auslösen der Bereitstellung
Mit den vorherigen Schritten wurden alle erforderlichen Elemente der Bereitstellung eingerichtet. Um den Download sofort auszulösen, drücken Sie die Reset-Taste auf dem Azure Sphere-Gerät. Das Herunterladen und Starten der Anwendung sollte nur wenige Minuten in Anspruch nehmen. Sobald der Vorgang abgeschlossen ist, beginnt die LED zu blinken.
Um zu überprüfen, ob die Anwendung auf Ihrem Gerät installiert wurde, verwenden Sie den befehl "azsphere device image list-installed ". Möglicherweise werden die Ergebnisse der Bereitstellung nicht sofort angezeigt. Wenn die Bereitstellung beim Ausführen des Befehls nicht aufgeführt ist, versuchen Sie es in einigen Minuten erneut. Die LED beginnt auf dem Azure Sphere-Gerät zu blinken, sobald die Bereitstellung abgeschlossen ist.
Nächste Schritte
Während Sie die Anwendungen weiter entwickeln und testen, möchten Sie sie wahrscheinlich querladen, bis Sie für eine breitere Bereitstellung bereit sind. Verwenden Sie azsphere device enable-cloud-test command, and enable the device for development and debugging, azsphere device enable-development.
Fahren Sie mit dem nächsten Artikel mit dem folgenden Inhalt fort:
Wenn Sie nicht bereit sind, Echtzeitanwendungen zu erstellen, möchten Sie möglicherweise auch:
- Untersuchen der Azure Sphere-Beispiele auf GitHub
- Weitere Informationen zu den Grundlagen der Azure Sphere-Bereitstellung
Problembehandlung
Wenn Probleme mit den oben genannten Vorgängen auftreten, finden Sie informationen zur Problembehandlung.