Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Interfaz de línea de comandos del kit de desarrollo de AWS IoT Greengrass
La interfaz de línea de comandos del kit de desarrollo de AWS IoT Greengrass (CLI del GDK) proporciona características que lo ayudan a desarrollar componentes personalizados de Greengrass. Puede usar la CLI del GDK para crear, compilar y publicar componentes personalizados. Al crear un repositorio de componentes con la CLI del GDK, puede partir de una plantilla o un componente de comunidad del catálogo de software de Greengrass. A continuación, puede elegir un sistema de compilación que agrupe los archivos como archivos ZIP, utilice un script de compilación de Maven o Gradle o ejecute un comando de compilación personalizado. Luego de crear un componente, puede usar la CLI del GDK para publicarlo en el servicio de AWS IoT Greengrass, de modo que puede usar la consola de AWS IoT Greengrass o la API para implementar el componente en los dispositivos principales de Greengrass.
Al desarrollar componentes de Greengrass sin la CLI del GDK, debe actualizar los URI de versión y artefacto del archivo de recetas del componente cada vez que cree una nueva versión del componente. Al utilizar la CLI del GDK, esta puede actualizar automáticamente los URI de versión y artefacto cada vez que publique una nueva versión del componente.
La CLI del GDK es de código abierto y está disponible en GitHub. Puede personalizar y ampliar la CLI del GDK para lograr los objetivos de desarrollo de componentes. Lo invitamos a consultar por incidencias y solicitudes de cambios en el repositorio de GitHub. Puede encontrar el origen de la CLI del GDK en el siguiente enlace: https://github.com/aws-greengrass/aws-greengrass-gdk-cli.
Requisitos previos
Para instalar y usar la CLI del kit de desarrollo de Greengrass, necesita lo siguiente:
-
Una Cuenta de AWS. Si no dispone de una, consulte Configura un Cuenta de AWS.
-
Una computadora de desarrollo similar a Windows, macOS o Unix con conexión a Internet.
-
Para la versión 1.1.0 de la CLI del GDK o versiones posteriores, debe tener Python 3.6 instalada en la computadora de desarrollo.
Para la versión 1.0.0 de la CLI del GDK, debe tener Python 3.8 instalada en la computadora de desarrollo.
-
Git instalado en su computadora de desarrollo.
-
AWS Command Line Interface (AWS CLI) instalado y configurado con credenciales en su computadora de desarrollo. Para obtener más información, consulte Instalar, actualizar y desinstalar la AWS CLI y Configurar la AWS CLI en la Guía del usuario de AWS Command Line Interface.
-
Para usar la CLI del GDK para publicar componentes en el servicio de AWS IoT Greengrass, debe contar con los siguientes permisos:
-
Para usar la CLI de GDK para crear un componente cuyos artefactos existan en un bucket de S3 y no en el sistema de archivos local, debe tener los siguientes permisos:
Esta característica está disponible para la versión 1.1.0 y posteriores de la CLI de GDK.
Registros de cambios
En la siguiente tabla, se describen los cambios en cada versión de la CLI del GDK. Para obtener más información, consulte la página de lanzamientos de la CLI del GDK en GitHub.
Versión
|
Cambios
|
1.6.2
|
- Mejoras y correcciones de errores
-
-
Soluciona el problema por el que el archivo gradlew.bat de Windows no funcionaba debido a la ruta relativa.
-
Mejoras mínimas en el registro, las pruebas y el empaquetado.
|
1.6.1
|
- Mejoras y correcciones de errores
-
-
Agrega una corrección de seguridad para el análisis de argumentos de la CLI.
-
Permite al GDK obtener el nombre de la versión más reciente de Greengrass Testing Framework (GTF) como versión GTF predeterminada.
-
Permite a GDK recomendar a los clientes que utilizan una versión anterior de GTF que la actualicen a la versión más reciente.
|
1.6.0 |
- Nuevas características
-
-
Agrega una comprobación de validación de receta con respecto al esquema de receta de Greengrass durante los comandos component build y component publish . Esta actualización ayuda a los desarrolladores a identificar problemas procesables en sus recetas de componentes en una fase temprana del proceso de creación de los componentes.
-
Agrega un conjunto de pruebas de confianza a la plantilla que se puede implementar con el comando test-e2e init . Este conjunto de pruebas de confianza incluye ocho pruebas genéricas que se pueden utilizar y ampliar para adaptarse a las necesidades básicas de las pruebas de componentes.
- Mejoras y correcciones de errores
-
|
1.5.0
|
- Mejoras y correcciones de errores
-
Actualiza los patrones reconocidos por la opción de compilación excludes cuando build_system está zip . Esta versión ahora reconocerá los patrones globales que coincidan con los nombres de las rutas en función de sus caracteres comodín. Esto permite especificar de forma personalizada los directorios de los que se debe excluir.
|
1.4.0 |
- Nuevas características
-
-
Agrega un nuevo comando config que inicia una petición interactiva para modificar los campos de un archivo de configuración del GDK existente.
-
Modifica los comandos gdk component build y gdk component
publish para comprobar que el tamaño de la receta cumple con los requisitos de Greengrass (<=16 000 bytes) antes de continuar.
- Mejoras y correcciones de errores
-
-
Agrega un registro adicional en el resultado del comando gdk component
build cuando un error de sintaxis de la receta impide que se complete la compilación para detectarlo.
-
Cambia el nombre de otf-options y otf-version a gtf-options y gtf-version , respectivamente, debido al cambio de nombre de Open Test Framework a Greengrass Testing Framework.
|
1.3.0 |
- Nuevas características
-
-
Agrega un nuevo comando test-e2e para permitir las pruebas integrales de los componentes mediante Open Test Framework.
-
Agrega una nueva opción de configuración, zip_name , para admitir nombres de archivos zip configurables con el sistema de compilación zip.
-
Permite que la propiedad region del archivo de configuración del GDK sea opcional.
- Mejoras y correcciones de errores
-
|
1.2.3 |
- Mejoras y correcciones de errores
-
-
Soluciona el problema que provocaba un error en la creación del bucket debido a un control de errores incorrecto.
-
Soluciona el problema por el que se eliminaban las estructuras de listas de la receta del componente.
|
1.2.2 |
- Mejoras y correcciones de errores
-
-
Las claves de recetas ya no diferencian mayúsculas de minúsculas.
-
Agrega una comprobación para determinar si hay un bucket en una Región de AWS y si el usuario puede acceder a él antes de crear uno nuevo. Requiere que el usuario cuente con el permiso GetBucketLocation .
-
Soluciona el problema con la palabra clave excludes del archivo de configuración de la CLI del GDK.
|
1.2.1 |
- Mejoras y correcciones de errores
-
-
Acepta la Región de AWS Canadá (Centro) (ca-central-1 ) en la entrada de configuración de la región en el archivo gdk-config.json .
-
Soluciona problemas con el argumento --region de la CLI del GDK para el comando publish .
|
1.2.0 |
- Nuevas características
-
-
Agrega la entrada options a la configuración build en el archivo de configuración de la CLI del GDK. Permite excludes en options para excluir ciertos archivos del artefacto zip cuando se utiliza el sistema de compilación zip .
-
Agrega el sistema de compilación gradlew para usar Gradle Wrapper para compilar componentes.
-
Suma compatibilidad con los archivos de compilación DSL de Kotlin para la opción de compilación gradle .
-
Agrega una entrada options a la configuración publish en el archivo de configuración de la CLI del GDK. Admite file_upload_args en options para proporcionar argumentos adicionales al cargar archivos en Amazon S3.
- Mejoras y correcciones de errores
-
-
Soluciona el problema por el que las compilaciones de Gradle no se borraban antes de ejecutar un comando de compilación.
-
Soluciona el problema por el que la compilación no se cerraba cuando se producía un error en el comando de compilación.
-
Mejora el formato de salida del comando gdk component list .
|
1.1.0
|
- Nuevas características
-
-
Agrega compatibilidad con el sistema de compilación de Gradle.
-
Agrega compatibilidad con el sistema de compilación de Maven en dispositivos Windows.
-
Agrega el argumento --bucket al comando component publish. Puede usar este argumento para especificar el bucket exacto en el que la CLI de GDK carga los artefactos de los componentes.
-
Agrega el argumento --name al comando component init. Puede usar esta opción para especificar la carpeta en la que la CLI del GDK inicializa el componente.
-
Suma compatibilidad con los artefactos de los componentes que existen en un bucket de S3, pero no en la carpeta de creación del componente local. Puede utilizar esta característica para reducir los costos de ancho de banda de los artefactos de componentes de gran tamaño, como los modelos de machine learning.
- Mejoras y correcciones de errores
-
-
Actualiza el comando component publish para comprobar si el componente está creado antes de publicarlo. Si el componente no está creado, este comando ahora lo crea automáticamente.
-
Soluciona el problema por el que el sistema de compilación zip no se puede compilar en dispositivos Windows cuando el nombre del archivo ZIP contiene letras mayúsculas.
-
Mejora el formato de los mensajes de registro y cambia el nivel de registro predeterminado a INFO en los dispositivos que ejecutan versiones de Python anteriores a la versión 3.8.
-
Cambia el requisito mínimo de la versión de Python a 3.6.
|
1.0.0
|
Versión inicial.
|