Créer un déploiement
Pour déployer vos applications à partir du cloud, vous chargez les images d’application sur votre locataire 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 Sphere et disposer du rôle Administrateur. 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 :
azsphere product create --name <product-name>
Remplacez product-name> par <un nom pour votre produit, par exemple DW100. Pour plus d’informations sur cette commande, consultez azsphere 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 azsphere 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 azsphere device enable-development (appelée azsphere device prep-debug dans les versions préliminaires antérieures du SDK).
Pour supprimer la fonctionnalité, utilisez azsphere device enable-cloud-test :
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
Le --device-group paramètre identifie le groupe d’appareils. L’ID du groupe d’appareils fournit un GUID, qui identifie de manière unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser la paire nom du produit et nom du groupe d’appareils au <format product-name>/<device-group-name> . Cette paire de noms identifie de façon unique un groupe d’appareils pour un produit particulier. 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 :
Chargez le package d’image :
azsphere image add --image <path-to-image> --regional-data-boundary <value>Créez un déploiement pour un groupe d’appareils :
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>Ou
azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>
Pour fournir plusieurs valeurs pour --images entrer une liste de valeurs séparées par des espaces.
Le --device-group paramètre identifie le groupe d’appareils. L’ID du groupe d’appareils fournit un GUID, qui identifie de manière unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser la paire nom du produit et nom du groupe d’appareils au <format product-name>/<device-group-name> . Cette paire de noms identifie de façon unique un groupe d’appareils pour un produit particulier.
Le --images paramètre fournit l’ID d’image du fichier de package d’image pour l’application. L’image est chargée sur votre locataire 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 :
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
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 azsphere image add et azsphere device-group 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.