Tutoriel : Créer un déploiement cloud

Ce guide de démarrage rapide vous montre comment créer votre premier déploiement d’application cloud. Un déploiement cloud délivre une application par le biais d’un déploiement attribué à un groupe d’appareils au sein du produit cible.

Dans ce tutoriel, vous allez apprendre à :

Prérequis

• Votre appareil Azure Sphere est connecté à votre ordinateur et à Internet.
• Vous avez terminé le tutoriel : Créer une application de haut niveau et disposer d’un fichier de package d’images pour votre application.

Créer un produit

Un produit identifie un modèle d’appareil Azure Sphere qui exécute une fonction spécifique et exécute une application particulière.

Si vous ne disposez pas déjà d’un produit, créez-en un à l’aide de la commande azsphere product create.

azsphere product create --name MyProduct --description "My First Product"

Les noms de produits doivent être uniques au sein de votre locataire Azure Sphere et ne respectent pas la casse. Si le nom contient des espaces, placez-le entre guillemets doubles dans les commandes, comme dans l’exemple.

La commande azsphere product create crée automatiquement cinq groupes d’appareils par défaut pour le nouveau produit : développement, test de champ, production, évaluation du système d’exploitation de test de champ et évaluation du système d’exploitation de production. Les groupes d’appareils vous permettent d’organiser vos appareils en fonction de la façon dont vous les utilisez.

Activer le déploiement basé sur le cloud pour votre appareil

Avant de tester le processus de déploiement cloud, votre appareil Azure Sphere doit être prêt à accepter les mises à jour d’applications cloud. Utilisez la commande azsphere device enable-cloud-test pour préparer votre appareil :

azsphere device enable-cloud-test --product MyProduct

azsphere device enable-cloud-test --productname MyProduct

Cette commande :

• Identifie l’appareil comme modèle MyProduct, qui a été créé à l’étape précédente.
• Affecte l’appareil au groupe d’appareils Test de champ, qui active les mises à jour d’applications cloud.
• Désactive la possibilité pour le SDK de charger des applications sur l’appareil, afin que seules les applications cloud puissent être chargées.

Le service de sécurité Azure Sphere utilise le groupe d’appareils et le produit pour déterminer s’il faut mettre à jour l’application sur un appareil.

Créer le déploiement

Un déploiement est un ensemble d’images pouvant être déployées à partir du service cloud Azure Sphere sur les appareils d’un groupe d’appareils particulier.

Pour créer un déploiement :

1. Chargez le package d’images sur votre locataire Azure Sphere à l’aide de l’ajout d’images azsphere.
2. Créez un déploiement pour un groupe d’appareils pour les images chargées à l’aide d’azsphere device-group deployment create.

azsphere image add --image <path-to-image>

Uploading image from file 'Blink.imagepackage':
 --> Image ID:       <image-ID>
 --> Component ID:   <component-ID>
 --> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.

azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>

azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>

azsphere device-group deployment create --devicegroupid <device-group-ID> --filepath <path-to-image-package>

azsphere device-group deployment create --devicegroupname <device-group-name> --productname <product-name> --filepath <path-to-image-package>

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.

Spécifiez le groupe d’appareils Field Test et le nom du produit que vous avez créé dans Créer un produit.

Remplacez <l’ID> d’image par l’ID d’image du package d’images que vous avez créé dans le tutoriel : Créer une application de haut niveau. Pour azure Sphere CLI, consultez azsphere device-group deployment create for information on getting the image ID.

Pour vérifier que le déploiement est configuré, utilisez la commande azsphere device image list-targeted.

Déclencher le déploiement

Les étapes précédentes configurent tous les éléments de déploiement requis. Pour déclencher le téléchargement immédiatement, appuyez sur le bouton Reset (Réinitialiser) de l’appareil Azure Sphere. L’application doit être téléchargée et démarrer en quelques minutes, et le voyant LED doit commencer à clignoter.

Pour vérifier que l’application a été installée sur votre appareil, utilisez la commande azsphere device image list-installed. Les résultats du déploiement peuvent ne pas être visibles immédiatement. Si le déploiement n’est pas répertorié lorsque vous exécutez la commande, réessayez en quelques minutes. La LED commence à clignoter sur l’appareil Azure Sphere dès que le déploiement est terminé.

Étapes suivantes

Quand vous développez et testez des applications, vous avez probablement envie d’en charger des versions test jusqu’à ce que vous soyez prêt à les déployer plus largement. Pour inverser la commande azsphere device enable-cloud-test et activer l’appareil pour le développement et le débogage, utilisez azsphere device enable-development.

Passez à l’article suivant pour savoir comment :

Si vous n’êtes pas prêt à créer des applications en temps réel, vous pouvez également souhaiter :

• Explorer les exemples Azure Sphere sur GitHub
• En savoir plus sur les principes de base du déploiement Azure Sphere

Résolution des problèmes

Si vous rencontrez des problèmes avec les opérations ci-dessus, reportez-vous aux conseils de résolution des problèmes.