Déploiement de vos composants sur un appareil - Amazon Lookout for Vision

Avis de fin de support : le 31 octobre 2025, le support d'Amazon Lookout for Vision AWS sera interrompu. Après le 31 octobre 2025, vous ne pourrez plus accéder à la console Lookout for Vision ni aux ressources Lookout for Vision. Pour plus d'informations, consultez ce billet de blog.

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.

Déploiement de vos composants sur un appareil

Pour déployer le composant modèle et le composant d'application client sur un appareil AWS IoT Greengrass Version 2 principal, vous devez utiliser la AWS IoT Greengrass V2 console ou l'CreateDeploymentAPI. Pour plus d'informations, consultez la section Créer des déploiements ou le Guide du AWS IoT Greengrass Version 2 développeur. Pour plus d'informations sur la mise à jour d'un composant déployé sur un périphérique principal, consultez la section Réviser les déploiements.

Autorisations IAM pour le déploiement de composants

Pour déployer un composant, AWS IoT Greengrass V2 vous devez disposer des autorisations suivantes :

  • greengrass:ListComponents

  • greengrass:ListComponentVersions

  • greengrass:ListCoreDevices

  • greengrass:CreateDeployment

  • greengrass:GetDeployment

  • greengrass:ListDeployments

CreateDeploymentet GetDeployment ont des actions dépendantes. Pour plus d'informations, consultez la section Actions définies par AWS IoT Greengrass V2.

Pour plus d'informations sur la modification des autorisations IAM, consultez la section Modification des autorisations d'un utilisateur.

Déploiement de vos composants (console)

Utilisez la procédure suivante pour déployer le composant d'application client sur un périphérique principal. L'application client dépend du composant du modèle (lui-même dépendant de l'agent Lookout for Vision Edge). Le déploiement du composant d'application client lance également le déploiement du composant modèle et de l'agent Lookout for Vision Edge.

Note

Vous pouvez ajouter vos composants à un déploiement existant. Vous pouvez également déployer des composants dans un groupe d'objets.

Pour exécuter cette procédure, vous devez disposer d'un périphérique AWS IoT Greengrass V2 principal configuré. Pour plus d'informations, veuillez consulter Configuration de votre appareil AWS IoT Greengrass Version 2 principal.

Pour déployer vos composants sur un appareil
  1. Ouvrez la AWS IoT Greengrass console à l'adresse https://console.aws.amazon.com/iot/.

  2. Dans le volet de navigation de gauche, sous Greengrass, choisissez Deployments.

  3. Sous Déploiements, choisissez Créer.

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

    1. Sous Deployment information (Informations sur le déploiement), saisissez ou modifiez le nom convivial de votre déploiement.

    2. Sous Cible de déploiement, sélectionnez le périphérique principal et entrez le nom de la cible.

    3. Choisissez Suivant.

  5. Sur la page Sélectionner les composants, procédez comme suit :

    1. Sous Mes composants, choisissez le nom du composant de votre application client (com.lookoutvison.EdgeAgentPythonExample).

    2. Choisissez Next (Suivant)

  6. Sur la page Configurer les composants, conservez la configuration actuelle et choisissez Next.

  7. Sur la page Configurer les paramètres avancés, conservez les paramètres actuels et choisissez Next.

  8. Sur la page Révision, choisissez Déployer pour commencer à déployer votre composant.

Vérification de l'état du déploiement (console)

Vous pouvez vérifier l'état de votre déploiement depuis la AWS IoT Greengrass V2 console. Si le composant de votre application client utilise l'exemple de recette et de codeCréation du composant de l'application client, consultez le journal des composants de l'application client une fois le déploiement terminé. En cas de réussite, le journal inclut une liste des modèles Lookout for Vision déployés sur le composant.

Pour plus d'informations sur l'utilisation du AWS SDK pour vérifier l'état du déploiement, voir Vérifier l'état du déploiement.

Pour vérifier l'état du déploiement
  1. Ouvrez la AWS IoT Greengrass console à l'adresse https://console.aws.amazon.com/iot/

  2. Dans le volet de navigation de gauche, choisissez Core devices.

  3. Dans la section Appareils principaux de Greengrass, choisissez votre appareil principal.

  4. Choisissez l'onglet Déploiements pour afficher l'état actuel du déploiement.

  5. Une fois les déploiements réussis (le statut est terminé), ouvrez une fenêtre de terminal sur le périphérique principal et consultez le journal des composants de l'application client sur. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Si votre déploiement utilise l'exemple de recette et de code, le journal inclut le résultat delookoutvision_edge_agent_example.py. Par exemple :

    Model Details model_component:"ModelComponent"

Déploiement des composants (SDK)

Utilisez la procédure suivante pour déployer le composant d'application client, le composant de modèle et l'agent Amazon Lookout for Vision Edge sur votre appareil principal.

  1. Créez un deployment.json fichier pour définir la configuration de déploiement de vos composants. Ce fichier doit ressembler à l'exemple suivant.

    { "targetArn":"targetArn", "components": { "com.lookoutvison.EdgeAgentPythonExample": { "componentVersion": "1.0.0", "configurationUpdate": { } } } }
    • Dans le champ targetArn, remplacez targetArn par l'Amazon Resource Name (ARN) de l'objet ou du groupe d'objets à cibler pour le déploiement, au format suivant :

      • Objet : arn:aws:iot:region:account-id:thing/thingName

      • Groupe d'objets : arn:aws:iot:region:account-id:thinggroup/thingGroupName

  2. Vérifiez si la cible de déploiement comporte un déploiement existant que vous souhaitez réviser. Procédez comme suit :

    1. Exécutez la commande suivante pour répertorier les déploiements pour la cible de déploiement. targetArnRemplacez-le par le nom de ressource Amazon (ARN) de l'objet ou du groupe d'AWSobjets IoT cible. Pour obtenir les ARN des objets présents dans la région AWS actuelle, utilisez la commandeaws iot list-things.

      aws greengrassv2 list-deployments --target-arn targetArn

      La réponse contient une liste du dernier déploiement pour la cible. Si la réponse est vide, cela signifie que la cible n'a pas de déploiement existant et vous pouvez passer à l'étape 3. Sinon, copiez le contenu deploymentId de la réponse pour l'utiliser à l'étape suivante.

    2. Exécutez la commande suivante pour obtenir les détails du déploiement. Ces détails incluent les métadonnées, les composants et la configuration des tâches. deploymentIdRemplacez-le par l'ID de l'étape précédente.

      aws greengrassv2 get-deployment --deployment-id deploymentId
    3. Copiez l'une des paires clé-valeur suivantes de la réponse de la commande précédente dans deployment.json. Vous pouvez modifier ces valeurs pour le nouveau déploiement.

      • deploymentName— Le nom du déploiement.

      • components— Les composants du déploiement. Pour désinstaller un composant, supprimez-le de cet objet.

      • deploymentPolicies— Les politiques du déploiement.

      • tags— Les tags du déploiement.

  3. Exécutez la commande suivante pour déployer les composants sur l'appareil. Notez la valeur de deploymentId dans la réponse.

    aws greengrassv2 create-deployment \ --cli-input-json file://path/to/deployment.json
  4. Exécutez la commande suivante pour obtenir l'état du déploiement. deployment-idRemplacez la valeur que vous avez notée à l'étape précédente. Le déploiement s'est terminé avec succès si la valeur est de deploymentStatus 1. COMPLETED

    aws greengrassv2 get-deployment --deployment-id deployment-id
  5. Une fois les déploiements réussis, ouvrez une fenêtre de terminal sur le périphérique principal et consultez le journal des composants de l'application client sur. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Si votre déploiement utilise l'exemple de recette et de code, le journal inclut le résultat delookoutvision_edge_agent_example.py. Par exemple :

    Model Details model_component:"ModelComponent"