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.

Préparation des AWS IoT emplois

AWS IoT Device Management Le catalogue de packages logiciels étend les AWS IoT tâches grâce à des paramètres de substitution et à l'intégration avec l'indexation du AWS IoT parc, les groupes d'objets dynamiques et le nom réservé à l' AWS IoT objet nommé shadow.

Paramètres de substitution pour les AWS IoT tâches

Vous pouvez utiliser des paramètres de substitution comme espace réservé dans votre document de AWS IoT travail. Lorsque le service de tâches rencontre un paramètre de substitution, il pointe la tâche vers l'attribut d'une version logicielle nommée pour la valeur du paramètre. Vous pouvez utiliser ce processus pour créer un document de travail unique et transmettre les métadonnées au travail par le biais d'attributs à usage général. Par exemple, vous pouvez transmettre un Amazon Simple Storage Service (Amazon S3)URL, un package logiciel Amazon Resource Name (ARN) ou une signature dans le document de travail via les attributs de version du package.

Les paramètres de substitution doivent être formatés dans le document de travail comme suit :

Dans l'exemple suivant, il existe un package logiciel nommé samplePackage et sa version de package nommée possède 2.1.5 les attributs suivants :

Pours3URL, le paramètre du document de travail est écrit comme suit :

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
}

Poursignature, le paramètre du document de travail est écrit comme suit :

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
}

Le document de travail complet est rédigé comme suit :

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
      },
    ],
    "signature": [
      "samplePackage" : "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
    ]
  }
}

Une fois la substitution effectuée, le document de travail suivant est déployé sur les appareils :

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile"
      },
    ],
    "signature": [
      "samplePackage" : "aaaaabbbbbcccccdddddeeeeefffffggggghhhhhiiiiijjjj"
    ]
  }
}

Paramètres de substitution (affichage avant et après)

Les paramètres de substitution rationalisent la création d'un document de travail à l'aide de divers indicateurs, par exemple $default pour la version du package par défaut. Il n'est donc plus nécessaire de saisir manuellement des métadonnées de version de package spécifiques pour chaque déploiement de tâches, car ces indicateurs sont remplis automatiquement avec les métadonnées référencées dans la version de package spécifique. Pour plus d'informations sur les attributs de version de package, par exemple $default pour la version de package par défaut, consultezPréparation du document de travail et de la version du package pour le déploiement.

Dans le AWS Management Console, cliquez sur le bouton Aperçu de la substitution dans la fenêtre de l'éditeur de fichier d'instructions de déploiement lors du déploiement d'une tâche pour une version de package afin d'afficher le document de tâche avec et sans les paramètres de substitution.

En utilisant le paramètre « before substitution » dans le DescribeJob et GetJobDocumentAPIs, vous pouvez afficher la API réponse avant et après la suppression des paramètres de substitution. Reportez-vous aux exemples suivants avec le DescribeJob et GetJobDocument APIs :

Pour plus d'informations sur les AWS IoT tâches, la création de documents de tâches et le déploiement de tâches, consultez la section Tâches.

Préparation du document de travail et de la version du package pour le déploiement

Lorsqu'une version de package est créée, son draft état indique qu'elle est en cours de préparation pour le déploiement. Pour préparer la version du package en vue du déploiement, vous devez créer un document de tâche, enregistrer le document dans un emplacement accessible à la tâche (tel qu'Amazon S3) et confirmer que la version du package possède les valeurs d'attribut que vous souhaitez que le document de tâche utilise. (Remarque : vous ne pouvez mettre à jour les attributs d'une version de package que lorsqu'elle est dans l'draftétat.)

Lorsque vous créez un AWS IoT Job ou un modèle de Job pour un déploiement à package unique, vous disposez des options suivantes pour personnaliser votre document de travail :

Fichier d'instructions de déploiement (recipe)

Artifactattribut de version

Version du package

Lorsque vous êtes satisfait de la version du package, publiez-la via la page des détails du package logiciel dans la AWS IoT console ou en lançant l'UpdatePackageVersionAPIopération. Vous pouvez ensuite référencer la version du package lorsque vous créez la tâche via la AWS IoT console ou en exécutant l'CreateJobAPIopération.

Nommer les packages et les versions lors du déploiement

Pour déployer une version de package logiciel sur un appareil, vérifiez que le package logiciel et la version du package référencés dans le document de travail correspondent au package logiciel et à la version du package indiqués dans le destinationPackageVersions paramètre de l'CreateJobAPIopération. S'ils ne correspondent pas, vous recevrez un message d'erreur vous demandant de faire correspondre les deux références. Pour plus d'informations sur les messages d'erreur du catalogue de packages logiciels, consultezMessages d'erreur généraux relatifs au dépannage.

Outre les packages logiciels et les versions de package référencés dans le document de tâche, vous pouvez inclure des packages logiciels et des versions de package supplémentaires dans le destinationPackageVersions paramètre de l'CreateJobAPIopération non référencé dans le document de tâche. Assurez-vous que les informations d'installation nécessaires sont incluses dans le document de travail pour que les appareils installent correctement les versions supplémentaires du package logiciel. Pour plus d'informations sur l'CreateJob APIopération, consultez CreateJob.

Cibler les emplois par le biais de groupes d'objets AWS IoT dynamiques

Le catalogue de logiciels fonctionne avec l'indexation de la flotte, AWS IoT les tâches et les AWS IoT groupes d'objets dynamiques pour filtrer et cibler les appareils de votre flotte afin de sélectionner la version du package à déployer sur vos appareils. Vous pouvez exécuter une requête d'indexation du parc en fonction des informations relatives au package actuel de votre appareil et cibler ces éléments pour une AWS IoT tâche. Vous pouvez également publier des mises à jour logicielles, mais uniquement pour les appareils cibles éligibles. Par exemple, vous pouvez spécifier que vous souhaitez déployer une configuration uniquement sur les appareils qui exécutent actuellement le iot-device-client 1.5.09. Pour plus d'informations, consultez Create a dynamic thing group.

Ombre nommée réservée et versions de package

S'il est configuré, les AWS IoT tâches peuvent mettre à jour le nom réservé à un objet nommé shadow ($package) lorsque la tâche est terminée avec succès. Dans ce cas, vous n'avez pas besoin d'associer manuellement une version de package à l’Ombre réservée nommée d’un objet.

Vous pouvez choisir d'associer ou de mettre à jour manuellement une version de package à l'ombre nommée réservée à l'objet dans les situations suivantes :

Vous pouvez ajouter ou mettre à jour une version de package pour un objet réservé nommé shadow ($package) par le biais de la console ou de l'UpdateThingShadowAPIopération. Pour plus d'informations, consultez Associer une version de package à un AWS IoT objet.

Désinstallation d'un progiciel et de sa version

$nullest un espace réservé qui invite le service AWS IoT Jobs à supprimer le package logiciel et la version du package existants de l'ombre nommée réservée à l'appareil. $package Pour plus d'informations, veuillez consulter Ombre nommée réservée.

Pour utiliser cette fonctionnalité, remplacez le nom de version à la fin du nom de ressource destinationPackageVersionAmazon (ARN) par$null. Ensuite, vous devez demander à votre service de supprimer le logiciel de l'appareil.

L'autorisation ARN utilise le format suivant :

arn:aws:iot:<regionCode>:111122223333:package/<packageName>/version/$null

Par exemple,

$ aws iot create-job \
    ... \
    --destinationPackageVersions ["arn:aws:iot:us-east-1:111122223333:package/samplePackage/version/$null"]