Créer un déploiement
Important
Il s’agit de la documentation Azure Sphere (héritée). Azure Sphere (hérité) prend sa retraite le 27 septembre 2027 et les utilisateurs doivent migrer vers Azure Sphere (intégré) pour l’instant. Utilisez le sélecteur de version situé au-dessus du TOC pour afficher la documentation Azure Sphere (intégrée).
Pour déployer vos applications à partir du cloud, vous chargez les images d’application sur votre locataire Azure Sphere et vous 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 vous devez disposer du rôle Administrateur. En outre, vos appareils doivent être préparés à recevoir des déploiements cloud.
Remarque
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 du cloud, ils doivent avoir un produit et appartenir à un groupe d’appareils, et ils 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 <le nom> du produit par un nom pour votre produit, par exemple DW100. Pour plus d’informations sur cette commande, consultez azsphere product.
Les déploiements ciblant des groupes d’appareils, vous devez donc aussi affecter vos appareils à un groupe d’appareils qui permet les mises à jour cloud avant de pouvoir recevoir vos applications déployées. Par défaut, chaque produit a cinq groupes d’appareils : production, test de champ, développement, évaluation du système d’exploitation de test de champ et évaluation du système d’exploitation de production. Vous pouvez utiliser un de ces groupes d’appareils ou créer les vôtres. 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 ne disposent pas de la fonctionnalité appDevelopment. Quand ils arrivent de l’usine, les appareils n’ont pas cette fonctionnalité. Cependant, 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 préversions 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 de groupe d’appareils fournit un GUID, qui identifie de façon unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser le nom du produit et la <paire de noms de groupe d’appareils au format product-name>/<device-group-name> . Cette paire de noms identifie de façon univoque un groupe d’appareils pour un produit particulier. Pour plus d’informations, consultez la 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 tableau, et les deux sont gérées de la même façon quand 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. Quand vous créez le déploiement, vous devez inclure le nom du produit et le nom du groupe d’appareils (comme le montre l’exemple suivant), ou bien l’ID du groupe d’appareils.
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>or
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 de groupe d’appareils fournit un GUID, qui identifie de façon unique le groupe d’appareils sur tous les produits. Vous pouvez également utiliser le nom du produit et la <paire de noms de groupe d’appareils au format product-name>/<device-group-name> . Cette paire de noms identifie de façon univoque 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 respecter les règles suivantes :
- La taille totale du déploiement doit être inférieure à 1 Mio.
- Le déploiement ne peut avoir plus d’un fichier de configuration de carte.
Mettre à jour un déploiement
Pour mettre à jour un déploiement, utilisez l’image azsphere add et azsphere device-group deployment create commands again, comme décrit dans la section précédente, et spécifiez le chemin d’accès au fichier d’application mis à jour.