Créer un déploiement

  • Article

Pour déployer vos applications à partir du cloud, vous chargez les images d’application dans votre catalogue Azure Sphere et créez un déploiement pour distribuer les images aux appareils Azure Sphere. Pour créer un déploiement, vous devez être connecté à Azure et disposer des autorisations RBAC appropriées. En outre, vos appareils doivent être prêts à recevoir des déploiements cloud.

Note

Chaque composant d’un déploiement doit avoir un GUID unique. Si vous basez votre application sur un exemple Azure Sphere, n’oubliez pas de créer un GUID unique pour votre application avant de créer un déploiement afin d’éviter d’éventuels conflits.

Préparer les appareils

Pour que vos appareils puissent recevoir des applications à partir du cloud, ils doivent avoir un produit et appartenir à un groupe d’appareils, et ne peuvent pas avoir la fonctionnalité AppDevelopment installée.

Si vous n’avez pas encore créé de produit pour vos appareils, vous devez le faire avant de pouvoir créer un déploiement. Pour créer un produit :

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

Remplacez MyProduct> par <un nom pour votre produit, par exemple DW100. Pour plus d’informations sur cette commande, consultez az sphere product .

Les déploiements ciblent les groupes d’appareils. Vous devez donc également affecter vos appareils à un groupe d’appareils qui active les mises à jour cloud avant qu’ils puissent recevoir vos applications déployées. Par défaut, chaque produit a cinq groupes d’appareils : Production, Test sur le terrain, Développement, Évaluation du système d’exploitation de test sur le terrain et Évaluation du système d’exploitation de production. Vous pouvez utiliser l’un de ces groupes d’appareils ou créer le vôtre. Pour savoir si un groupe d’appareils accepte les mises à jour cloud, utilisez az sphere device-group show.

Les appareils doivent également être préparés pour le chargement cloud, ce qui signifie qu’ils n’ont pas la fonctionnalité appDevelopment . Lorsqu’ils sont expédiés à partir de l’usine, les appareils n’ont pas cette fonctionnalité. Toutefois, si vous avez utilisé un appareil pour le développement d’applications, vous avez probablement ajouté cette fonctionnalité avec la commande az sphere device enable-development .

Pour supprimer la fonctionnalité, utilisez az sphere device enable-cloud-test :

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

Pour plus d’informations, consultez création de déploiement.

Créer un déploiement pour un groupe d’appareils

Les déploiements peuvent contenir à la fois des applications et des configurations de carte, et les deux sont gérés de la même façon lorsque vous créez un déploiement. Les déploiements sont des ensembles d’images à distribuer à tous les appareils au sein d’un groupe d’appareils. Chaque déploiement est lié à un groupe d’appareils spécifique au sein d’un produit spécifique. Vous devez inclure le nom du produit et le nom du groupe d’appareils (comme le montre l’exemple suivant) ou l’ID du groupe d’appareils lorsque vous créez le déploiement.

Pour créer un déploiement :

  1. Chargez le package d’image :

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

  2. Créez un déploiement pour un groupe d’appareils :

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

Pour fournir plusieurs valeurs pour --images entrer une liste de valeurs séparées par des espaces.

Le --images paramètre fournit l’ID d’image du fichier de package d’image pour l’application. L’image est chargée dans votre catalogue actuel.

Le --regional-data-boundary paramètre spécifie la limite de données régionales pour cette image. Les valeurs autorisées sont EU et None. La valeur par défaut est None. Si aucune valeur n’est spécifiée, la valeur par défaut est utilisée.

Par exemple (certains paramètres supprimés par souci de concision) :

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

Règles pour un déploiement valide

Pour être valide, un déploiement doit suivre les règles suivantes :

  • La taille totale du déploiement doit être inférieure à 1 Mio.
  • Le déploiement ne peut pas avoir plus d’un fichier de configuration de carte.

Mettre à jour un déploiement

Pour mettre à jour un déploiement, utilisez à nouveau les commandes az sphere image add et az sphere deployment create , comme décrit dans la section précédente, et spécifiez le chemin d’accès au fichier d’application mis à jour.