Teilen über

Erstellen einer Bereitstellung

  • Artikel

Um Ihre Anwendungen aus der Cloud bereitzustellen, laden Sie die Anwendungsimages in Ihren Azure Sphere-Mandanten hoch und erstellen eine Bereitstellung, um die Images an Azure Sphere-Geräte zu verteilen. Zum Erstellen einer Bereitstellung müssen Sie bei Azure Sphere angemeldet sein und über die Administratorrolle verfügen. Darüber hinaus müssen Ihre Geräte auf den Empfang von Cloudbereitstellungen vorbereitet sein.

Hinweis

Jede Komponente in einer Bereitstellung muss über eine eindeutige GUID verfügen. Wenn Sie Ihre Anwendung auf einem Azure Sphere-Beispiel basieren, denken Sie daran, vor dem Erstellen einer Bereitstellung eine eindeutige GUID für Ihre Anwendung zu erstellen, um mögliche Konflikte zu vermeiden.

Vorbereiten der Geräte

Bevor Ihre Geräte Anwendungen aus der Cloud empfangen können, müssen sie über ein Produkt verfügen und zu einer Gerätegruppe gehören, und die AppDevelopment-Funktion kann nicht installiert sein.

Wenn Sie noch kein Produkt für Ihre Geräte erstellt haben, müssen Sie dies tun, bevor Sie eine Bereitstellung erstellen können. So erstellen Sie ein Produkt:

azsphere product create --name <product-name>

Ersetzen Sie <product-name> durch einen Namen für Ihr Produkt, z. B. DW100. Weitere Informationen zu diesem Befehl finden Sie unter azsphere product .

Bereitstellungen sind Zielgerätegruppen, sodass Sie Ihre Geräte auch einer Gerätegruppe zuweisen müssen, die Cloudupdates ermöglicht, bevor sie Ihre bereitgestellten Anwendungen empfangen können. Standardmäßig verfügt jedes Produkt über fünf Gerätegruppen: Produktion, Feldtest, Entwicklung, Auswertung des Betriebssystems für Feldtests und Produktionsbetriebssystemauswertung. Sie können eine dieser Gerätegruppen verwenden oder eine eigene erstellen. Verwenden Sie azsphere device-group show, um herauszufinden, ob eine Gerätegruppe Cloudupdates akzeptiert.

Die Geräte müssen auch für das Laden in die Cloud vorbereitet werden, was bedeutet, dass sie nicht über die AppDevelopment-Funktion verfügen. Geräte verfügen nicht über diese Funktion, wenn sie ab Werk ausgeliefert werden. Wenn Sie jedoch ein Gerät für die Anwendungsentwicklung verwendet haben, haben Sie diese Funktion wahrscheinlich mit dem Befehl azsphere device enable-development hinzugefügt (in früheren Vorschauversionen des SDK als azsphere device prep-debug bezeichnet).

Verwenden Sie azsphere device enable-cloud-test, um die Funktion zu entfernen:

azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'

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 Paar Produktname und Gerätegruppenname im <Format product-name>/<device-group-name> verwenden. Dieses Namenspaar identifiziert eindeutig eine Gerätegruppe für ein bestimmtes Produkt. Weitere Informationen finden Sie unter Bereitstellungserstellung.

Erstellen einer Bereitstellung für eine Gerätegruppe

Bereitstellungen können sowohl Anwendungen als auch Boardkonfigurationen enthalten, und beide werden beim Erstellen einer Bereitstellung auf die gleiche Weise behandelt. Bereitstellungen sind Sätze von Images, die auf alle Geräte innerhalb einer Gerätegruppe verteilt werden sollen. Jede Bereitstellung ist mit einer bestimmten Gerätegruppe innerhalb eines bestimmten Produkts verknüpft. Sie müssen entweder den Produktnamen und den Gerätegruppennamen (wie im folgenden Beispiel gezeigt) oder die Gerätegruppen-ID einschließen, wenn Sie die Bereitstellung erstellen.

So erstellen Sie eine Bereitstellung:

  1. Laden Sie das Imagepaket hoch:

    azsphere image add --image <path-to-image>  --regional-data-boundary <value>

  2. Erstellen Sie eine neue Bereitstellung für eine Gerätegruppe:

    azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

    Oder

    azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>

Um mehrere Werte für --images anzugeben, geben Sie eine Liste von Werten ein, 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 Paar Produktname und Gerätegruppenname im <Format product-name>/<device-group-name> verwenden. Dieses Namenspaar identifiziert eindeutig eine Gerätegruppe für ein bestimmtes Produkt.

Der --images Parameter stellt die Image-ID der Imagepaketdatei für die Anwendung bereit. Das Image wird in Ihren aktuellen Mandanten hochgeladen.

Der --regional-data-boundary Parameter gibt die regionale Datengrenze für dieses Bild an. Zulässige Werte sind EU und None. Der Standardwert ist None. Wenn kein Wert angegeben wird, wird der Standardwert verwendet.

Zum Beispiel:

azsphere image add --image my-app.imagepackage --regional-data-boundary "None"

azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

Regeln für eine gültige Bereitstellung

Um gültig zu sein, muss eine Bereitstellung die folgenden Regeln befolgen:

  • Die Gesamtgröße der Bereitstellung muss kleiner als 1 MiB sein.
  • Die Bereitstellung darf nicht mehr als eine Boardkonfigurationsdatei enthalten.

Aktualisieren einer Bereitstellung

Verwenden Sie zum Aktualisieren einer Bereitstellung die Befehle azsphere image add und azsphere device-group deployment create erneut, wie im vorherigen Abschnitt beschrieben, und geben Sie den Pfad zur aktualisierten Anwendungsdatei an.