Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Étape 6 : Déployez votre composant Avec AWS IoT Greengrass, vous pouvez déployer des composants sur des appareils individuels ou des groupes d'appareils. Lorsque vous déployez un composant, il AWS IoT Greengrass installe et exécute le logiciel de ce composant sur chaque machine cible. Vous spécifiez les composants à déployer et la mise à jour de configuration à déployer pour chaque composant. Vous pouvez également contrôler la manière dont le déploiement est déployé sur les appareils ciblés par le déploiement. Pour de plus amples informations, veuillez consulter [Déployer AWS IoT Greengrass des composants sur des appareils](manage-deployments.md). Dans cette section, vous allez redéployer votre composant Hello World sur votre appareil principal Greengrass. ## Déployez votre composant (console) 1. Dans le menu de navigation de la [AWS IoT Greengrass console](https://console.aws.amazon.com/greengrass), sélectionnez **Composants**. 1. Sur la page **Composants**, sous l'onglet **Mes composants**, choisissez **com.example.HelloWorld**. 1. Dans la page **com.example.HelloWorld**page, choisissez **Déployer**. 1. Dans **Ajouter au déploiement**, choisissez **Créer un nouveau déploiement**, puis **Suivant**. 1. Sur la page **Specify target (Spécifier une cible)**, procédez comme suit : 1. Dans la case **Nom**, saisissez **Deployment for MyGreengrassCore**. 1. Pour **Cible de déploiement**, choisissez l'**appareil principal** et le nom de l' AWS IoT appareil principal. La valeur par défaut de ce didacticiel est*MyGreengrassCore*. 1. Choisissez **Suivant**. 1. Sur la page **Sélectionner les composants**, sous **Mes composants**, vérifiez que **com.example.HelloWorld**le composant est sélectionné, puis choisissez **Next**. 1. Sur la page **Configurer les composants**, sélectionnez **com.example.HelloWorld**, puis procédez comme suit : 1. Choisissez **Configure component (Configurer un composant)**. 1. Sous **Configuration update (Mise à jour de la configuration)**, dans **Configuration to merge (Configuration à fusionner)**, saisissez la configuration suivante. ``` { "Message": "universe" } ``` Cette mise à jour de configuration définit le `Message` paramètre Hello World sur `universe` pour l'appareil dans ce déploiement. 1. Choisissez **Confirmer**. 1. Choisissez **Suivant**. 1. Sur la page **Configure advanced settings (Configurer les paramètres avancés)**, conservez les paramètres de configuration par défaut et choisissez **Next (Suivant)**. 1. Sur la page **Review (Révision)**, choisissez **Deploy (Déployer)**. 1. Vérifiez que le déploiement est terminé correctement. L'exécution du déploiement peut prendre plusieurs minutes. Consultez le journal Hello World pour vérifier la modification. Exécutez la commande suivante sur votre appareil principal Greengrass. ------ #### [ Linux or Unix ] ``` sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log ``` ------ #### [ Windows Command Prompt (CMD) ] ``` type C:\greengrass\v2\\logs\\com.example.HelloWorld.log ``` ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait ``` ------ Vous devriez voir des messages similaires à ceux de l'exemple suivant. ``` Hello, universe! Greetings from your first Greengrass component. ``` **Note** Si les messages du journal ne changent pas, le déploiement a échoué ou n'a pas atteint le périphérique principal. Cela peut se produire si votre appareil principal n'est pas connecté à Internet ou n'est pas autorisé à récupérer des artefacts de votre compartiment S3. Exécutez la commande suivante sur votre appareil principal pour afficher le fichier journal du logiciel AWS IoT Greengrass Core. Ce fichier inclut les journaux du service de déploiement de l'appareil principal Greengrass. ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ``` type C:\greengrass\v2\\logs\\greengrass.log ``` La `type` commande écrit le contenu du fichier sur le terminal. Exécutez cette commande plusieurs fois pour observer les modifications apportées au fichier. ``` gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait ``` Pour de plus amples informations, veuillez consulter [Résolution des problèmes AWS IoT Greengrass V2](troubleshooting.md). ## Déployez votre composant (AWS CLI) **Pour déployer votre composant Hello World** 1. Sur votre ordinateur de développement, créez un fichier appelé `hello-world-deployment.json` et copiez-y le code JSON suivant. Ce fichier définit les composants et les configurations à déployer. ``` { "components": { "com.example.HelloWorld": { "componentVersion": "1.0.0", "configurationUpdate": { "merge": "{\"Message\":\"universe\"}" } } } } ``` Ce fichier de configuration indique de déployer la version `1.0.0` du composant Hello World que vous avez développée et publiée lors de la procédure précédente. `configurationUpdate`Spécifie de fusionner la configuration du composant dans une chaîne codée en JSON. Cette mise à jour de configuration définit le `Message` paramètre Hello World sur `universe` pour l'appareil dans ce déploiement. 1. Exécutez la commande suivante pour déployer le composant sur votre appareil principal Greengrass. Vous pouvez effectuer un déploiement sur des objets, qui sont des appareils individuels, ou sur des groupes d'objets, qui sont des groupes d'appareils. *MyGreengrassCore*Remplacez-le par le nom de l' AWS IoT objet correspondant à votre appareil principal. ------ #### [ Linux or Unix ] ``` aws greengrassv2 create-deployment \ --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \ --cli-input-json file://hello-world-deployment.json ``` ------ #### [ Windows Command Prompt (CMD) ] ``` aws greengrassv2 create-deployment ^ --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^ --cli-input-json file://hello-world-deployment.json ``` ------ #### [ PowerShell ] ``` aws greengrassv2 create-deployment ` --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ` --cli-input-json file://hello-world-deployment.json ``` ------ La commande produit une réponse similaire à l'exemple suivant. ``` { "deploymentId": "deb69c37-314a-4369-a6a1-3dff9fce73a9", "iotJobId": "b5d92151-6348-4941-8603-bdbfb3e02b75", "iotJobArn": "arn:aws:iot:region:account-id:job/b5d92151-6348-4941-8603-bdbfb3e02b75" } ``` 1. Vérifiez que le déploiement est terminé correctement. L'exécution du déploiement peut prendre plusieurs minutes. Consultez le journal Hello World pour vérifier la modification. Exécutez la commande suivante sur votre appareil principal Greengrass. ------ #### [ Linux or Unix ] ``` sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log ``` ------ #### [ Windows Command Prompt (CMD) ] ``` type C:\greengrass\v2\\logs\\com.example.HelloWorld.log ``` ------ #### [ PowerShell ] ``` gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait ``` ------ Vous devriez voir des messages similaires à ceux de l'exemple suivant. ``` Hello, universe! Greetings from your first Greengrass component. ``` **Note** Si les messages du journal ne changent pas, le déploiement a échoué ou n'a pas atteint le périphérique principal. Cela peut se produire si votre appareil principal n'est pas connecté à Internet ou n'est pas autorisé à récupérer des artefacts de votre compartiment S3. Exécutez la commande suivante sur votre appareil principal pour afficher le fichier journal du logiciel AWS IoT Greengrass Core. Ce fichier inclut les journaux du service de déploiement de l'appareil principal Greengrass. ``` sudo tail -f /greengrass/v2/logs/greengrass.log ``` ``` type C:\greengrass\v2\\logs\\greengrass.log ``` La `type` commande écrit le contenu du fichier sur le terminal. Exécutez cette commande plusieurs fois pour observer les modifications apportées au fichier. ``` gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait ``` Pour de plus amples informations, veuillez consulter [Résolution des problèmes AWS IoT Greengrass V2](troubleshooting.md).