AWS IoT GreengrassInterfaz de línea de comandos del kit de desarrollo - AWS IoT Greengrass

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.

AWS IoT GreengrassInterfaz de línea de comandos del kit de desarrollo

La interfaz de línea de comandos (CLI de GDK) del kit de AWS IoT Greengrass desarrollo proporciona funciones que le ayudan a desarrollar componentes personalizados de Greengrass. Puede usar la CLI de GDK para crear, compilar y publicar componentes personalizados. Al crear un repositorio de componentes con la CLI de GDK, puede partir de una plantilla o un componente comunitario del catálogo de software de Greengrass. A continuación, puede elegir un sistema de compilación que empaquete los archivos como archivos ZIP, utilice un script de compilación de Maven o Gradle o ejecute un comando de compilación personalizado. Después de crear un componente, puede usar la CLI de GDK para publicarlo en el AWS IoT Greengrass servicio, de modo que puede usar la AWS IoT Greengrass consola o la API para implementar el componente en sus dispositivos principales de Greengrass.

Al desarrollar componentes de Greengrass sin la CLI de GDK, debe actualizar las URIs 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 de GDK, esta puede actualizar automáticamente las URIs de versión y artefacto cada vez que publique una nueva versión del componente.

La CLI de GDK es de código abierto y está disponible en GitHub. Puede personalizar y ampliar la CLI de GDK para satisfacer sus necesidades de desarrollo de componentes. Lo invitamos a abrir las ediciones y a introducir solicitudes en el GitHub repositorio. Puede encontrar la fuente de la CLI de 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 Configure un Cuenta de AWS.

  • Un ordenador de desarrollo similar a Windows, macOS o Unix con conexión a Internet.

  • Para la versión 1.1.0 o posterior de GDK CLI, Python 3.6 o posterior está instalado en el equipo de desarrollo.

    Para la versión 1.0.0 de GDK CLI, Python 3.8 o posterior instalada en su equipo de desarrollo.

  • Git instalado en tu ordenador de desarrollo.

  • AWS Command Line Interface(AWS CLI) instalado y configurado con credenciales en tu ordenador de desarrollo. Para obtener más información, consulte Instalación, actualización y desinstalación AWS CLI y configuración del AWS CLI en la Guía del AWS Command Line Interface usuario.

    nota

    Si utiliza una Raspberry Pi u otro dispositivo ARM de 32 bits, instale AWS CLI la V1. AWS CLI La versión 2 no está disponible para dispositivos ARM de 32 bits. Para obtener más información, consulte Instalación, actualización y desinstalación de la AWS CLI versión 1.

  • Para usar la CLI de GDK para publicar componentes en el AWS IoT Greengrass servicio, debe tener los siguientes permisos:

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • 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:

    • s3:ListBucket

    Esta función está disponible para GDK CLI v1.1.0 y versiones posteriores.

Registros de cambios

En la siguiente tabla se describen los cambios en cada versión de la CLI de GDK. Para obtener más información, consulte la página de versiones de la CLI de GDK en GitHub.

Versión

Cambios

1.6.2

Mejoras y correcciones de errores
  • Soluciona un problema por el que el archivo gradlew.bat de Windows no funcionaba debido a la ruta relativa.

  • Mejoras menores en el registro, las pruebas y el empaquetado.

1.6.1

Mejoras y correcciones de errores
  • Añade 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 utilicen una versión anterior del GTF que la actualicen a la última versión.

1.6.0

Nuevas características
  • Añade una comprobación de validación de recetas con respecto al esquema de recetas de Greengrass durante los comandos component build ycomponent 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 componentes.

  • Añade un conjunto de pruebas de confianza a la plantilla que se puede desplegar con un test-e2e init comando. 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
  • Actualiza la versión predeterminada de Greengrass Testing Framework (GTF) utilizada por el test-e2e comando a la versión 1.2.0.

1.5.0

Mejoras y correcciones de errores

Actualiza los patrones reconocidos por la opción de excludes construcción 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
  • Añade un nuevo config comando que inicia un mensaje interactivo para modificar los campos de un archivo de configuración de GDK existente.

  • Modifica los gdk component publish comandos gdk component build y para comprobar que el tamaño de la receta cumple con los requisitos de Greengrass (<=16000 bytes) antes de continuar.

Mejoras y correcciones de errores
  • Añade un registro adicional en el resultado del gdk component build comando 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
  • Añade un nuevo test-e2e comando para permitir las end-to-end pruebas de componentes mediante Open Test Framework.

  • Añade una nueva opción de configuración,zip_name, para admitir nombres de archivos zip configurables con el sistema de compilación zip.

  • Hace que la region propiedad del archivo de configuración del GDK sea opcional.

Mejoras y correcciones de errores
  • Soluciona un problema por el que se crea un nuevo directorio incluso cuando la plantilla o el repositorio especificados no existen al inicializar un proyecto de GDK con el --name argumento.

1.2.3
Mejoras y correcciones de errores
  • Soluciona un problema por el que la creación del bucket fallaba debido a una gestión incorrecta de los errores.

  • Soluciona un problema por el que se eliminaban las estructuras de listas de la receta del componente.

1.2.2
Correcciones de errores y mejoras
  • Las claves de recetas ya no distinguen entre mayúsculas y minúsculas.

  • Añade una comprobación para determinar si un depósito existe en un depósito Región de AWS y si el usuario puede acceder a él antes de crear uno nuevo. Requiere que el usuario tenga el GetBucketLocation permiso.

  • Soluciona un problema con la excludes palabra clave del archivo de configuración CLI de GDK.

1.2.1
Mejoras y correcciones de errores
  • Acepta la entrada de configuración de Canadá (Centralca-central-1) () Región de AWS en la región del gdk-config.json archivo.

  • Soluciona problemas con el argumento CLI de --region GDK del publish comando.

1.2.0
Nuevas características
  • Añade la options entrada a la build configuración en el archivo de configuración CLI de GDK. Permite excludes options excluir ciertos archivos del artefacto zip cuando se utiliza el sistema de zip compilación.

  • Agrega el sistema de gradlew compilación para usar Gradle Wrapper para compilar componentes.

  • Añade compatibilidad con los archivos de compilación DSL de Kotlin para la opción de compilación. gradle

  • Añade una options entrada a la publish configuración en el archivo de configuración CLI de GDK. Admite la file_upload_args opción under options para proporcionar argumentos adicionales al cargar archivos a Amazon S3.

Mejoras y correcciones de errores
  • Corrige un problema por el que las compilaciones de Gradle no se limpiaban antes de ejecutar un comando de compilación.

  • Soluciona un 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 gdk component list comando.

1.1.0

Nuevas características
  • Añade compatibilidad con el sistema de compilación de Gradle.

  • Añade compatibilidad con el sistema de compilación Maven en dispositivos Windows.

  • Añade el --bucket argumento al comando de publicación del componente. Puede usar este argumento para especificar el depósito exacto en el que la CLI de GDK carga los artefactos de los componentes.

  • Añade el --name argumento al comando component init. Puede usar esta opción para especificar la carpeta en la que la CLI de GDK inicializa el componente.

  • Añade 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 función para reducir los costes de ancho de banda de los artefactos de componentes de gran tamaño, como los modelos de aprendizaje automático.

Mejoras y correcciones de errores
  • Actualiza el comando de publicación del componente para comprobar si el componente está creado antes de publicarlo. Si el componente no está creado, este comando ahora lo crea automáticamente.

  • Soluciona un 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 3.8.

  • Cambia el requisito mínimo de la versión de Python a Python 3.6.

1.0.0

Versión inicial.