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émarrage avec le Catalogue de Logiciels
Vous pouvez créer et gérer le catalogue des packages AWS IoT Device Management logiciels via AWS Management Console les opérations d' AWS IoT Core API et AWS Command Line Interface (AWS CLI).
**Note**
L'activation AWS IoT de l'indexation du parc est obligatoire pour utiliser le catalogue de packages logiciels. Les opérations de base telles que la création d'une version de package logiciel dans AWS Management Console et l'utilisation de la commande `CreatePackage` API échoueront si l'indexation du AWS IoT parc n'est pas activée.
Pour plus d'informations sur l'utilisation de l'indexation du AWS IoT parc avec le Software Package Catalog, consultez[Préparation de l'indexation de la flotte](preparing-fleet-indexing.md).
**Utilisation de la console**
Pour utiliser le AWS Management Console, connectez-vous à votre AWS compte et accédez à [AWS IoT Core](https://console.aws.amazon.com/iot/home). Dans le volet de navigation, choisissez **Software packages**. Vous pouvez ensuite créer et gérer des packages et leurs versions à partir de cette section.
**Utilisation des opérations d'API ou de CLI**
Vous pouvez utiliser les opérations de l' AWS IoT Core API pour créer et gérer les fonctionnalités du catalogue de packages logiciels. Pour plus d'informations, consultez les [AWS IoT sections Référence des API AWS](https://docs.aws.amazon.com/iot/latest/apireference/) [SDKs et boîtes à outils](https://aws.amazon.com/developer/tools/). Les AWS CLI commandes gèrent également votre catalogue. Pour plus d'informations, consultez la [AWS IoT Référence de commande CLI;](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).
**Topics**
+ [Création d'un package logiciel et d'une version de package](creating-package-and-version.md)
+ [Déploiement d'une version de package via AWS IoT des tâches](deploying-package-version.md)
+ [Associer une version de package à un AWS IoT objet](associating-package-version.md)
# Création d'un package logiciel et d'une version de package
Vous pouvez utiliser les étapes suivantes pour créer un package et une version initiale via le AWS Management Console.
**Pour créer un progiciel**
1. Connectez-vous à votre AWS compte et accédez à la [AWS IoT console](https://console.aws.amazon.com/iot/home).
1. Dans le panneau de navigation, choisissez **Progiciel**.
1. Sur la page du **AWS IoT package logiciel**, choisissez **Créer un package**. La boîte de dialogue **Activer les dépendances pour la gestion des packages** s'affiche.
1. Sous **Indexation du parc**, sélectionnez **Ajouter des packages logiciels et une version de l'appareil**. Cela est nécessaire pour le catalogue des packages logiciels et fournit une indexation de la flotte et des mesures relatives à votre flotte.
1. [Facultatif] Si vous souhaitez que les AWS IoT tâches mettent à jour l'ombre nommée réservée une fois les tâches terminées avec succès, sélectionnez **Mettre à jour automatiquement les ombres des tâches**. Si vous ne souhaitez pas que les AWS IoT jobs soient mis à jour, ne cochez pas cette case.
1. [Facultatif] Pour accorder aux AWS IoT jobs le droit de mettre à jour l'ombre nommée réservée, sous **Sélectionner un rôle**, choisissez **Créer un rôle**. Si vous ne souhaitez pas que les AWS IoT jobs effectuent cette mise à jour, ce rôle n'est pas obligatoire.
1. Créez ou sélectionnez un rôle.
1. Si vous **n'avez pas de rôle** à cette fin : lorsque la boîte de dialogue **Créer un rôle** apparaît, entrez un **nom de rôle**, puis choisissez **Créer**.
1. Si vous **avez un rôle** à cette fin : dans **Sélectionner un rôle**, choisissez votre rôle, puis assurez-vous que la case **Attacher la politique au rôle IAM** est cochée.
1. Choisissez **Confirmer**. La page **Créer un nouveau package** apparaît.
1. Sous **Détails du package**, entrez un **nom de package**.
1. Sous **Description du package**, entrez les informations qui vous aideront à identifier et à gérer ce package.
1. [Facultatif] Vous pouvez utiliser des balises pour vous aider à classer et gérer ce package. Pour ajouter des balises, développez les **balises**, choisissez la balise **Ajouter** et entrez une paire clé-valeur. Vous pouvez ajouter jusqu'à 50 balises. Pour plus d'informations, consultez la section [Marquage de vos AWS IoT ressources](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**Pour ajouter une version de package lors de la création d'un nouveau package**
1. Dans **Version initiale**, entrez un **nom de version**.
Nous vous recommandons d'utiliser le [SemVer format](https://semver.org/) (par exemple,`1.0.0.0`) pour identifier de manière unique la version de votre package. Vous pouvez également utiliser une stratégie de formatage différente mieux adaptée à votre cas d'utilisation. Pour de plus amples informations, veuillez consulter [Cycle de vie des versions du package](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. Sous **Description de la version**, entrez les informations qui vous aideront à identifier et à gérer cette version du package.
**Note**
La case à cocher **Version par défaut** est désactivée car les versions de package sont créées dans un `draft` état. Vous pouvez attribuer un nom à la version par défaut une fois que vous avez créé la version du package et que vous avez modifié l'état en`published`. Pour de plus amples informations, veuillez consulter [Cycle de vie des versions du package](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. [Facultatif] Pour vous aider à gérer cette version ou à communiquer des informations à vos appareils, entrez une ou plusieurs paires nom-valeur pour les **attributs de version**. Choisissez **Ajouter un attribut** pour chaque paire nom-valeur que vous entrez. Pour de plus amples informations, veuillez consulter [Attributs de version](preparing-to-use-software-package-catalog.md#version-attributes).
1. [Facultatif] Vous pouvez utiliser des balises pour vous aider à classer et gérer ce package. Pour ajouter des balises, développez les **balises**, choisissez la balise **Ajouter** et entrez une paire clé-valeur. Vous pouvez ajouter jusqu'à 50 balises. Pour plus d'informations, consultez la section [Marquage de vos AWS IoT ressources](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. Choisissez **Suivant**.
**Associer la nomenclature du logiciel à une version du package (facultatif)**
1. À **l'étape 3 : Version SBOMs (facultatif)**, dans la fenêtre des **configurations SBOM**, choisissez le format de fichier SBOM par défaut et le mode de validation utilisés pour valider votre nomenclature logicielle avant qu'elle ne soit associée à la version de votre package.
1. Dans la fenêtre **Ajouter un fichier SBOM**, entrez le nom de ressource Amazon (ARN) représentant votre bucket Amazon S3 versionné et le format de fichier SBOM préféré si le type par défaut ne fonctionne pas.
**Note**
Vous pouvez ajouter un seul fichier SBOM ou un seul fichier zip en contenant plusieurs SBOMs si vous avez plusieurs nomenclatures logicielles pour la version de votre package.
1. Dans la fenêtre **Fichier SBOM ajouté, vous pouvez afficher le fichier** SBOM que vous avez ajouté pour la version de votre package.
1. Choisissez **Créer un package et une version**. La page de version du package apparaît et vous pouvez voir l'état de validation de votre fichier SBOM dans la fenêtre du fichier **SBOM ajouté**. L'état initial sera celui où `In progress` le fichier SBOM est en cours de validation.
**Note**
Les statuts de validation des fichiers SBOM sont`Invalid file`,,, `Not started` `In progress` `Validated (SPDX)``Validated (CycloneDX)`, et les raisons de l'échec de la validation.
# Déploiement d'une version de package via AWS IoT des tâches
Vous pouvez utiliser les étapes suivantes pour déployer une version de package via le AWS Management Console.
**Prérequis :**
Avant de commencer, vous devez exécuter les actions suivantes :
+ Enregistrez AWS IoT des choses avec AWS IoT Core. Pour savoir comment ajouter vos appareils AWS IoT Core, voir [Créer un objet](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Facultatif] Créez un AWS IoT groupe d'objets ou un groupe d'objets dynamique pour cibler les appareils sur lesquels vous allez déployer la version du package. Pour savoir comment créer un groupe d'objets, voir [Création d'un groupe d'objets statique](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Pour savoir comment créer un groupe d'objets dynamique, voir [Création d'un groupe d'objets dynamique](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Créez un package logiciel et une version de package. Pour de plus amples informations, veuillez consulter [Création d'un package logiciel et d'une version de package](creating-package-and-version.md).
+ Création d'un document de tâche Pour plus d'informations, consultez [Préparation du document de travail et de la version du package pour le déploiement](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).
**Pour déployer une AWS IoT tâche**
1. Sur la [AWS IoT console](https://console.aws.amazon.com/iot/home), sélectionnez **Packages logiciels**.
1. Choisissez le package logiciel que vous souhaitez déployer. La page de **détails du package logiciel** s'affiche.
1. Choisissez la version du package que vous souhaitez déployer, sous **Versions**, puis choisissez **Deploy job version**.
1. Si c'est la première fois que vous déployez une tâche via ce portail, une boîte de dialogue décrivant les exigences s'affiche. Vérifiez ces informations, puis choisissez **Acknowledge**.
1. Entrez un nom pour le déploiement ou laissez le nom généré automatiquement dans le champ **Nom**.
1. [Facultatif] Dans le champ **Description**, entrez une description identifiant l'objectif ou le contenu du déploiement, ou laissez les informations générées automatiquement.
**Remarque :** Nous vous recommandons de ne pas utiliser d'informations personnellement identifiables dans les champs Nom et description du Job.
1. [Facultatif] Ajoutez les balises à associer à cette tâche.
1. Choisissez **Suivant**.
1. Sous **Objectifs du travail**, choisissez les objets ou les groupes d'objets qui devraient recevoir le travail.
1. Dans le champ **Fichier de travail**, spécifiez le fichier JSON du document de travail.
1. Ouvrez **Jobs integration with the Package Catalog service**.
1. Sélectionnez les packages et les versions spécifiés dans votre document de travail.
**Note**
Vous devez choisir les mêmes packages et versions de package que ceux spécifiés dans le document de travail. Vous pouvez en inclure d'autres, mais la tâche émettra des instructions uniquement pour les packages et les versions inclus dans le document de tâche. Pour plus d'informations, voir [Nommer les packages et les versions lors du déploiement](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).
1. Choisissez **Suivant**.
1. Sur la page de configuration du job, sélectionnez l'un des types de job suivants dans la boîte de dialogue de configuration du job :
+ **Tâche de capture instantanée :** une tâche de capture instantanée est terminée lorsqu'elle est terminée sur les appareils et les groupes cibles.
+ **Tâche continue :** une tâche continue s'applique aux groupes d'objets et s'exécute sur tout appareil que vous ajoutez ultérieurement à un groupe cible spécifique.
1. Dans la boîte de dialogue **Configurations supplémentaires - facultatives**, passez en revue les configurations de tâche facultatives suivantes et effectuez vos sélections en conséquence. Pour plus d'informations, consultez les sections [Configurations de déploiement, de planification et d'abandon des tâches](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) et [Configurations du délai d'exécution des tâches et des nouvelles tentatives.](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry)
+ Configuration du déploiement
+ Planification d’une Configuration.
+ Configuration du délai d'expiration des exécutions de tâches
+ Exécutions de tâches nouvelle tentative de configuration
+ Interruption de la configuration
1. Passez en revue les offres d'emploi, puis choisissez **Soumettre**.
Une fois que vous avez créé la tâche, la console génère une signature JSON et la place dans votre document de tâche. Vous pouvez utiliser la AWS IoT console pour consulter le statut d'une tâche, annuler ou supprimer une tâche. Pour gérer les tâches, accédez au [hub de tâche de la console](https://console.aws.amazon.com/iot/home#/jobhub).
# Associer une version de package à un AWS IoT objet
Après avoir installé le logiciel sur votre appareil, vous pouvez associer une version de package à un AWS IoT objet réservé nommé shadow. Si les AWS IoT tâches ont été configurées pour mettre à jour l'ombre nommée réservée à l'objet une fois la tâche déployée et terminée avec succès, vous n'avez pas besoin de suivre cette procédure. Pour de plus amples informations, veuillez consulter [Ombre nommée réservée](preparing-to-use-software-package-catalog.md#reserved-named-shadow).
**Prérequis :**
Avant de commencer, vous devez exécuter les actions suivantes :
+ Créez un ou AWS IoT plusieurs objets et établissez la télémétrie à travers. AWS IoT Core Pour plus d'informations, consultez la section [Mise en route avec AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).
+ Créez un package logiciel et une version de package. Pour de plus amples informations, veuillez consulter [Création d'un package logiciel et d'une version de package](creating-package-and-version.md).
+ Installez la version logicielle du package sur l'appareil.
**Note**
L'association d'une version de package à un AWS IoT objet ne met pas à jour ni n'installe le logiciel sur le périphérique physique. La version du package doit être déployée sur l'appareil.
**Pour associer une version de package à un AWS IoT objet**
1. Surle volet de navigation de la [AWS IoT console](https://console.aws.amazon.com/iot/home), développez le menu **Tous les appareils** et choisissez **Objets**.
1. Identifiez l' AWS IoT objet que vous souhaitez mettre à jour dans la liste et choisissez le nom de l'objet pour afficher sa page de détails.
1. Dans la section **Détails**, sélectionnez **Packages et versions**.
1. Choisissez **Ajouter au package et à la version**.
1. Pour **Choisir un package d'appareil**, choisissez le package logiciel de votre choix.
1. Pour **Choisir une version**, choisissez la version logicielle de votre choix.
1. Choisissez **Ajouter un package d'appareil**.
Le package et la version apparaissent dans la liste **des packages et versions sélectionnés**.
1. Répétez ces étapes pour chaque package et version que vous souhaitez associer à cet élément.
1. Lorsque vous avez terminé, choisissez **Ajouter les détails du package et de la version**. La page de **détails de l'objet** s'ouvre et vous pouvez voir le nouveau package et la nouvelle version dans la liste.