Erstellen einer Cloudbereitstellung

  • Artikel

Um Ihre Anwendungen aus der Cloud bereitzustellen, laden Sie Anwendungsimages in einen Azure Sphere-Katalog hoch und erstellen eine Bereitstellung, um 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.

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.

Vorbereiten von Geräten

Bevor 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:

Verwenden des Portals

    • Melden Sie sich beim Azure-Portal an.
    • Um den Azure Sphere-Dienst zu suchen, geben Sie in der oberen Suchleiste Azure Sphere ein, und wählen Sie ihn aus. Die Seite Azure Sphere wird angezeigt.
  2. Wählen Sie den Katalog aus, in dem Sie eine Bereitstellung erstellen möchten. Stellen Sie sicher, dass Ihr Abonnementfilter entsprechend festgelegt ist, um alle Kataloge und Ressourcengruppen anzuzeigen.
  3. Wählen Sie auf der linken Seite der KatalogseiteDie Option Produkte verwalten> aus.
  4. Klicken Sie oben auf der Katalogseite auf + Erstellen .
  5. Geben Sie einen Namen und eine Beschreibung für das Produkt ein. Aktivieren Sie das Kontrollkästchen, um anzugeben, ob Standardgerätegruppen erstellt werden sollen. Wenn diese Option markiert ist, werden die folgenden Standardgerätegruppen erstellt: Entwicklung, Feldtest, Auswertung des Feldtestbetriebssystems, Produktion, Produktionsbetriebssystemauswertung.
  6. Klicken Sie abschließend unten auf der Seite auf Erstellen .

Wenn Sie keine Standardgerätegruppen erstellen möchten, muss eine Gerätegruppe manuell erstellt und dem Produkt zugeordnet werden:

  1. Wählen Sie auf der linken Seite die Option Gerätegruppen verwalten> aus.
  2. Klicken Sie oben auf der Seite auf + Erstellen .
  3. Wählen Sie das Produkt aus, das aus den obigen Schritten erstellt wurde.
  4. Geben Sie einen Namen für die Gerätegruppe und eine kurze Beschreibung ein.
  5. Wählen Sie den Betriebssystemfeed für die Gerätegruppe aus. Der RetailEval-Feed empfängt vorab veröffentlichte Betriebssystemversionen vor dem Retail-Feed . RetailEval wird daher nicht für Produktionsgeräte empfohlen. Wählen Sie den Retail-Feed für Produktionsgeräte aus.
  6. Wählen Sie die Updaterichtlinie für die Gerätegruppe aus. UpdateAll bedeutet, dass Geräte in der Gruppe Betriebssystem- und Anwendungsupdates erhalten, wenn sie verfügbar sind. No3rdPartyAppUpdates bedeutet, dass Geräte in der Gruppe nur Betriebssystemupdates annehmen.

Verwenden der CLI

Tipp

Es wird empfohlen, die Standardwerte für die Abonnement-, Ressourcengruppen- und Katalogparameter zu konfigurieren. Dies trägt zur Verringerung der Redundanz bei und kann die CLI-Befehlssyntax erheblich verkürzen.

Sofern Sie das aktive Abonnement nicht festgelegt haben, ist der --subscription Parameter für alle Befehle erforderlich. Sie können das aktive Abonnement mit dem Befehl az account set --subscription <subscription-name>festlegen.

Verwenden Sie den az sphere product create Befehl.

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog  --name MyProduct --description "My new product"

Verwenden Sie den az sphere device-group create Befehl, um eine Gerätegruppe zu erstellen und sie dem Produkt zuzuordnen.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

Bereitstellungen zielen auf Gerätegruppen ab. Geräte müssen einer Gerätegruppe zugewiesen werden, für die Cloudupdates aktiviert sind, bevor Geräte bereitgestellte 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.

Geräte innerhalb der Gerätegruppe müssen für das Laden in die Cloud vorbereitet werden. Dies bedeutet, dass sie nicht über die AppDevelopment-Funktion verfügen dürfen. Geräte, die direkt aus dem Werk ausgeliefert werden, verfügen in der Regel nicht über die AppDevelopment-Funktion . Die Funktion wird hinzugefügt, wenn der Befehl az sphere device enable-development verwendet wird.

Verwenden Sie az sphere device enable-cloud-test, um die AppDevelopment-Funktion zu entfernen:

Verwenden der CLI

Verwenden Sie den az sphere device enable-cloud-test Befehl.

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

Erstellen einer Bereitstellung für eine Gerätegruppe

Bereitstellungen sind Sätze von Images, die auf alle Geräte innerhalb einer Gerätegruppe verteilt werden sollen. Eine Bereitstellung kann sowohl Anwendungen als auch Boardkonfigurationen enthalten. 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.

Verwenden des Portals

    • Melden Sie sich beim Azure-Portal an.
    • Um den Azure Sphere-Dienst zu suchen, geben Sie in der oberen Suchleiste Azure Sphere ein, und wählen Sie ihn aus. Die Seite Azure Sphere wird angezeigt.
  2. Wählen Sie den Katalog aus, in dem Sie eine Bereitstellung erstellen möchten. Stellen Sie sicher, dass Ihr Abonnementfilter entsprechend festgelegt ist, um alle Kataloge und Ressourcengruppen anzuzeigen.
  3. Wählen Sie auf der linken Seite die Option Produkte verwalten> aus.
  4. Auf der nächsten Seite wird eine Tabelle mit allen erstellten Produkten angezeigt. Wählen Sie das Produkt aus, für das Sie eine Bereitstellung erstellen möchten.
  5. Eine Tabelle zeigt alle Gerätegruppen an, die dem ausgewählten Produkt zugeordnet sind. Wählen Sie die Gerätegruppe aus, für die Sie eine Bereitstellung erstellen möchten.
  6. Wählen Sie die Registerkarte Bereitstellungen aus.
  7. Klicken Sie unter der Registerkarte Bereitstellungen auf +Erstellen .
  8. Wählen Sie in der angezeigten Ansicht ein vorhandenes Bild aus, oder klicken Sie auf +Hinzufügen , um ein neues Bild hochzuladen.
  9. Klicken Sie unten in der Ansicht auf +Erstellen.

Verwenden der CLI

Führen Sie die Schritte unter Vorbereiten von Geräten aus, bevor Sie fortfahren, und führen Sie dann die folgenden Schritte aus:

  1. Laden Sie ein Imagepaket hoch, und notieren Sie sich dabei die vom Befehl zurückgegebene imageId:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. Verwenden Sie den azsphere image-package show Befehl , um die imageId des Imagepakets abzurufen:

    azsphere image-package show --image-package myImage.imagepackage

    Hinweis

    image-package show wird in der Azure CLI-Erweiterung derzeit nicht unterstützt.

    Der Befehl gibt Informationen zum Imagepaket zurück, einschließlich der imageId:

    Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

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

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

Mehrere Bilder können für den --images Parameter mithilfe einer durch Leerzeichen getrennten Liste von Bild-IDs bereitgestellt werden.

Verwenden Sie az sphere device-group list, um Gerätegruppen in einem Katalog aufzulisten.

Verwenden Sie az sphere image list, um alle Bilder in einem Katalog aufzulisten.

Aktualisieren einer Bereitstellung

Es ist nicht möglich, eine Bereitstellung zu aktualisieren. Stattdessen muss eine neue Bereitstellung erstellt werden. Wiederholen Sie die Schritte aus dem vorherigen Abschnitt, und aktualisieren Sie die Parameter bei Bedarf.