Étape 6 : Déployez votre composant - AWS IoT Greengrass

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

AvecAWS 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 plus d’informations, consultez Déployer AWS IoT Greengrass des composants sur des appareils.

Dans cette section, vous allez redéployer votre composant Hello World sur votre appareil principal Greengrass.

  1. Dans le menu de navigation de la AWS IoT Greengrassconsole, sélectionnez Composants.

  2. Sur la page Composants, sous l'onglet Mes composants, sélectionnez com.example.HelloWorld.

  3. Sur la page com.example.HelloWorld, choisissez Deploy (Déployer).

  4. Dans Ajouter au déploiement, choisissez Créer un nouveau déploiement, puis Suivant.

  5. Sur la page Specify target (Spécifier une cible), procédez comme suit :

    1. Dans la case Nom, saisissez Deployment for MyGreengrassCore.

    2. Pour Cible de déploiement, choisissez l'appareil principal et le nom de l'AWS IoTappareil principal. La valeur par défaut de ce didacticiel est MyGreengrassCore.

    3. Choisissez Suivant.

  6. Sur la page Sélectionner les composants, sous Mes composants, vérifiez que le com.example.HelloWorldcomposant est sélectionné, puis choisissez Next.

  7. Sur la page Configurer les composants com.example.HelloWorld, choisissez et effectuez les opérations suivantes :

    1. Choisissez Configure component (Configurer un composant).

    2. 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.

    3. Choisissez Confirmer.

    4. Choisissez Suivant.

  8. 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).

  9. Sur la page Review (Révision), choisissez Deploy (Déployer).

  10. 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.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    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.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Pour plus d’informations, consultez Résolution des problèmes AWS IoT Greengrass V2.

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. configurationUpdateSpé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.

  2. 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. MyGreengrassCoreRemplacez-le par le nom de l'AWS IoTobjet 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"
}

  3. 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.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    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.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Pour plus d'informations, consultez Résolution des problèmes AWS IoT Greengrass V2.