Erstellen einer Bereitstellung

  • Artikel

Um Ihre Anwendungen aus der Cloud bereitzustellen, laden Sie die Anwendungsimages in Ihren Azure Sphere-Katalog hoch und erstellen eine Bereitstellung, um die Images an Azure Sphere-Geräte zu verteilen. Zum Erstellen einer Bereitstellung müssen Sie bei Azure angemeldet sein und über die entsprechenden RBAC-Berechtigungen 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:

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription

Ersetzen Sie <MyProduct> durch einen Namen für Ihr Produkt, z. B. DW100. Weitere Informationen zu diesem Befehl finden Sie unter az sphere 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 az sphere 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 az sphere device enable-development hinzugefügt.

Verwenden Sie zum Entfernen der Funktion az sphere device enable-cloud-test:

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device-group <device-group-ID>

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:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>

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

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>

Um mehrere Werte für --images anzugeben, geben Sie eine Liste von Werten ein, die durch Leerzeichen getrennt sind.

Der --images Parameter stellt die Image-ID der Imagepaketdatei für die Anwendung bereit. Das Bild wird in Ihren aktuellen Katalog 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.

Beispiel (einige Parameter wurden aus Platzgründen entfernt):

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

az sphere deployment create --product "DW100" --device-group "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 erneut die Befehle az sphere image add und az sphere deployment create , wie im vorherigen Abschnitt beschrieben, und geben Sie den Pfad zur aktualisierten Anwendungsdatei an.