AWS IoT GreengrassInterface de ligne de commande du kit de développement - AWS IoT Greengrass
PrérequisJournal des modifications

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.

AWS IoT GreengrassInterface de ligne de commande du kit de développement

L'interface de ligne de commande du kit de AWS IoT Greengrass développement (GDK CLI) fournit des fonctionnalités qui vous aident à développer des composants Greengrass personnalisés. Vous pouvez utiliser la CLI GDK pour créer, créer et publier des composants personnalisés. Lorsque vous créez un référentiel de composants avec la CLI GDK, vous pouvez partir d'un modèle ou d'un composant communautaire du catalogue de logiciels Greengrass. Ensuite, vous pouvez choisir un système de compilation qui empaquète les fichiers sous forme d'archives ZIP, utilise un script de génération Maven ou Gradle ou exécute une commande de construction personnalisée. Après avoir créé un composant, vous pouvez utiliser la CLI GDK pour le publier sur le AWS IoT Greengrass service. Vous pouvez ainsi utiliser la AWS IoT Greengrass console ou l'API pour déployer le composant sur vos appareils principaux Greengrass.

Lorsque vous développez des composants Greengrass sans la CLI GDK, vous devez mettre à jour les URI de version et d'artefact dans le fichier de recette du composant chaque fois que vous créez une nouvelle version du composant. Lorsque vous utilisez la CLI GDK, elle peut automatiquement mettre à jour les URI de version et d'artefact pour vous chaque fois que vous publiez une nouvelle version du composant.

La CLI GDK est open source et disponible sur GitHub. Vous pouvez personnaliser et étendre la CLI GDK pour répondre à vos besoins de développement de composants. Nous vous invitons à ouvrir des problèmes et à extraire des requêtes sur le GitHub référentiel. Vous pouvez trouver la source de la CLI GDK sur le lien suivant : https://github.com/aws-greengrass/ aws-greengrass-gdk-cli.

Prérequis

Pour installer et utiliser la CLI du Greengrass Development Kit, vous avez besoin des éléments suivants :

  • Un Compte AWS. Si vous n'en avez pas, veuillez consulter Configurez un Compte AWS.

  • Un ordinateur de développement de type Windows, macOS ou Unix doté d'une connexion Internet.

  • Pour la version 1.1.0 ou ultérieure de GDK CLI, Python 3.6 ou version ultérieure est installé sur votre ordinateur de développement.

    Pour la version 1.0.0 de la CLI GDK, Python 3.8 ou version ultérieure installé sur votre ordinateur de développement.

  • Git installé sur votre ordinateur de développement.

  • AWS Command Line Interface(AWS CLI) installé et configuré avec des informations d'identification sur votre ordinateur de développement. Pour plus d'informations, consultez les sections Installation, mise à jour et désinstallation du AWS CLI et Configuration du AWS CLI dans le guide de l'AWS Command Line Interfaceutilisateur.

    Note

    Si vous utilisez un Raspberry Pi ou un autre appareil ARM 32 bits, installez la AWS CLI V1. AWS CLI La V2 n'est pas disponible pour les appareils ARM 32 bits. Pour plus d'informations, voir Installation, mise à jour et désinstallation de la AWS CLI version 1.

  • Pour utiliser la CLI GDK afin de publier des composants sur le AWS IoT Greengrass service, vous devez disposer des autorisations suivantes :

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • Pour utiliser la CLI GDK afin de créer un composant dont les artefacts existent dans un compartiment S3 et non dans le système de fichiers local, vous devez disposer des autorisations suivantes :

    • s3:ListBucket

    Cette fonctionnalité est disponible pour GDK CLI v1.1.0 et versions ultérieures.

Journal des modifications

Le tableau suivant décrit les modifications apportées à chaque version de la CLI GDK. Pour plus d'informations, consultez la page des versions de la CLI GDK sur GitHub.

Version

Modifications

1.6.2
Corrections de bugs et améliorations

  • Résout un problème selon lequel Windows gradlew.bat ne fonctionne pas en raison du chemin relatif.

  • Améliorations mineures apportées à la journalisation, aux tests et à l'empaquetage.

1.6.1
Corrections de bugs et améliorations

  • Ajoute un correctif de sécurité pour l'analyse des arguments de la CLI.

  • Permet au GDK d'obtenir le nom de la dernière version de Greengrass Testing Framework (GTF) comme version GTF par défaut.

  • Permet à GDK de recommander aux clients utilisant une ancienne version de GTF de passer à la dernière version.

1.6.0
Nouvelles fonctionnalités

  • Ajoute un contrôle de validation de recette par rapport au schéma de recette Greengrass pendant les commandes component build etcomponent publish. Cette mise à jour aide les développeurs à identifier les problèmes réalisables dans leurs recettes de composants plus tôt dans le processus de création des composants.

  • Ajoute au modèle une suite de tests de confiance qui peut être extraite vers le bas par la test-e2e init commande. Cette suite de tests de confiance comprend huit tests génériques qui peuvent être utilisés et étendus pour répondre aux besoins de test des composants de base.

Corrections de bugs et améliorations

  • Met à jour la version par défaut de Greengrass Testing Framework (GTF) utilisée par la test-e2e commande vers la version 1.2.0.

1.5.0
Corrections de bugs et améliorations

Met à jour les modèles reconnus par l'option de excludes construction quand build_system c'est le caszip. Cette version reconnaîtra désormais les modèles globulaires qui correspondent aux noms de chemin en fonction de leurs caractères génériques. Cela permet de spécifier de manière personnalisée les répertoires à exclure.
1.4.0
Nouvelles fonctionnalités

  • Ajoute une nouvelle config commande qui lance une invite interactive pour modifier les champs d'un fichier de configuration GDK existant.

  • Modifie les gdk component publish commandes gdk component build et pour vérifier que la taille de la recette est conforme aux exigences de Greengrass (<=16 000 octets) avant de continuer.

Corrections de bugs et améliorations

  • Ajoute une journalisation supplémentaire à la sortie de la gdk component build commande lorsqu'une erreur de syntaxe de recette empêche la fin de la compilation pour prise de conscience.

  • Renomme gtf-version respectivement le otf-options et et otf-version le, en raison du changement du nom d'Open Test Framework en Greengrass Testing Framework. gtf-options
1.3.0
Nouvelles fonctionnalités

  • Ajoute une nouvelle test-e2e commande pour prendre en charge le end-to-end test des composants à l'aide d'Open Test Framework.

  • Ajoute une nouvelle option de configurationzip_name, pour prendre en charge les noms de fichiers zip configurables avec le système de compilation zip.

  • Rend la region propriété dans le fichier de configuration GDK facultative.

Corrections de bugs et améliorations

  • Résout le problème de création d'un nouveau répertoire même lorsque le modèle ou le référentiel spécifié n'existe pas lors de l'initialisation d'un projet GDK avec l'--nameargument.
1.2.3
Corrections de bugs et améliorations

  • Résout un problème d'échec de la création d'un compartiment en raison d'une mauvaise gestion des erreurs.

  • Résout un problème de suppression des structures de liste dans la recette du composant.
1.2.2
Corrections de bugs et améliorations

  • Les touches de recette ne distinguent plus les majuscules et minuscules.

  • Ajoute une vérification pour déterminer si un compartiment existe dans un Région AWS et est accessible par l'utilisateur avant de créer un nouveau compartiment. Nécessite que l'utilisateur dispose de GetBucketLocation cette autorisation.

  • Résout un problème lié au excludes mot clé dans le fichier de configuration de la CLI GDK.
1.2.1
Corrections de bugs et améliorations

  • Accepte l'entrée de configuration Canada (Centralca-central-1) () Région AWS dans la région du gdk-config.json fichier.

  • Résout les problèmes liés à l'argument --region GDK CLI de la publish commande.
1.2.0
Nouvelles fonctionnalités

  • Ajoute l'optionsentrée à la build configuration dans le fichier de configuration de la CLI GDK. Supporte excludes under options pour exclure certains fichiers de l'artefact zip lors de l'utilisation du système de zip compilation.

  • Ajoute le système de gradlew génération pour utiliser Gradle Wrapper pour créer des composants.

  • Ajoute la prise en charge des fichiers de construction Kotlin DSL pour l'option de gradle construction.

  • Ajoute une options entrée à la publish configuration dans le fichier de configuration de la CLI GDK. Supporte le file_upload_args under options pour fournir des arguments supplémentaires lors du téléchargement de fichiers sur Amazon S3.

Corrections de bugs et améliorations

  • Résout un problème selon lequel les versions de Gradle n'étaient pas nettoyées avant d'exécuter une commande de génération.

  • Résout un problème selon lequel le build ne se terminait pas lorsque la commande build échouait.

  • Améliore le format de sortie de la gdk component list commande.

1.1.0
Nouvelles fonctionnalités

  • Ajoute le support pour le système de construction Gradle.

  • Ajoute la prise en charge du système de compilation Maven sur les appareils Windows.

  • Ajoute l'--bucketargument à la commande de publication du composant. Vous pouvez utiliser cet argument pour spécifier le compartiment exact dans lequel la CLI GDK télécharge les artefacts des composants.

  • Ajoute l'--nameargument à la commande d'initialisation du composant. Vous pouvez utiliser cette option pour spécifier le dossier dans lequel la CLI GDK initialise le composant.

  • Ajoute la prise en charge des artefacts de composants qui existent dans un compartiment S3 mais pas dans le dossier de construction du composant local. Vous pouvez utiliser cette fonctionnalité pour réduire les coûts de bande passante pour les artefacts de composants volumineux, tels que les modèles d'apprentissage automatique.

Corrections de bugs et améliorations

  • Met à jour la commande de publication du composant pour vérifier si le composant est créé avant de le publier. Si le composant n'est pas créé, cette commande le crée désormais pour vous.

  • Résout un problème en raison duquel le système de génération zip ne parvient pas à générer sur les appareils Windows lorsque le nom du fichier ZIP contient des majuscules.

  • Améliore le format des messages de journal et remplace le niveau de journal par défaut INFO sur les appareils exécutant des versions de Python antérieures à 3.8.

  • Modifie la version minimale requise pour Python en Python 3.6.

1.0.0

Première version.