AWS IoT GreengrassInterfaccia a riga di comando del Development Kit - AWS IoT Greengrass

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS IoT GreengrassInterfaccia a riga di comando del Development Kit

L'interfaccia a riga di comando del AWS IoT Greengrass Development Kit (GDK CLI) fornisce funzionalità che aiutano a sviluppare componenti Greengrass personalizzati. Puoi usare la CLI GDK per creare, creare e pubblicare componenti personalizzati. Quando crei un repository di componenti con la CLI GDK, puoi iniziare da un modello o da un componente della community dal Greengrass Software Catalog. Quindi, puoi scegliere un sistema di compilazione che impacchetti i file come archivi ZIP, utilizzi uno script di compilazione Maven o Gradle o esegua un comando di compilazione personalizzato. Dopo aver creato un componente, puoi utilizzare la CLI di GDK per pubblicarlo sul servizio, in modo da poter utilizzare AWS IoT Greengrass la console o AWS IoT Greengrass l'API per distribuire il componente sui tuoi dispositivi principali Greengrass.

Quando sviluppate componenti Greengrass senza la CLI GDK, dovete aggiornare la versione e gli URI degli artefatti nel file di ricetta del componente ogni volta che create una nuova versione del componente. Quando usi la CLI di GDK, può aggiornare automaticamente la versione e gli URI degli artefatti ogni volta che pubblichi una nuova versione del componente.

La CLI GDK è open source e disponibile su. GitHub Puoi personalizzare ed estendere la CLI GDK per soddisfare le tue esigenze di sviluppo dei componenti. Ti invitiamo ad aprire problemi e scaricare richieste dal repository. GitHub Puoi trovare il codice sorgente della CLI di GDK al seguente link: https://github.com/aws-greengrass/. aws-greengrass-gdk-cli

Prerequisiti

Per installare e utilizzare la CLI del Greengrass Development Kit, è necessario quanto segue:

  • Un Account AWS. Se non lo hai, consultare Configura un Account AWS.

  • Un computer di sviluppo simile a Windows, macOS o UNIX con una connessione Internet.

  • Per la versione 1.1.0 o successiva della CLI di GDK, Python 3.6 o successiva installato sul computer di sviluppo.

    Per la versione 1.0.0 della CLI di GDK, Python 3.8 o successiva installata sul computer di sviluppo.

  • Git installato sul tuo computer di sviluppo.

  • AWS Command Line Interface(AWS CLI) installato e configurato con credenziali sul computer di sviluppo. Per ulteriori informazioni, vedere Installazione, aggiornamento e disinstallazione AWS CLI e configurazione di AWS CLI nella Guida per l'utente. AWS Command Line Interface

    Nota

    Se utilizzi un Raspberry Pi o un altro dispositivo ARM a 32 bit, installa V1. AWS CLI AWS CLI La versione 2 non è disponibile per i dispositivi ARM a 32 bit. Per ulteriori informazioni, vedere Installazione, aggiornamento e disinstallazione della AWS CLI versione 1.

  • Per utilizzare la CLI GDK per pubblicare componenti sul servizio, AWS IoT Greengrass è necessario disporre delle seguenti autorizzazioni:

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • Per utilizzare la CLI GDK per creare un componente i cui artefatti esistono in un bucket S3 e non nel file system locale, è necessario disporre delle seguenti autorizzazioni:

    • s3:ListBucket

    Questa funzionalità è disponibile per GDK CLI v1.1.0 e versioni successive.

Changelog

La tabella seguente descrive le modifiche in ogni versione della CLI GDK. Per ulteriori informazioni, consulta la pagina dei rilasci della CLI di GDK su. GitHub

Versione

Modifiche

1.6.2

Correzioni di bug e miglioramenti
  • Risolve un problema per cui Windows gradlew.bat non funziona a causa del percorso relativo.

  • Piccoli miglioramenti alla registrazione, al test e alla creazione di pacchetti.

1.6.1

Correzioni di bug e miglioramenti
  • Aggiunge una correzione di sicurezza per l'analisi degli argomenti della CLI.

  • Consente a GDK di ottenere il nome della release più recente di Greengrass Testing Framework (GTF) come versione GTF predefinita.

  • Consente a GDK di consigliare ai clienti che utilizzano una versione precedente di GTF di aggiornare alla versione più recente.

1.6.0

Nuove funzionalità
  • Aggiunge un controllo di convalida della ricetta rispetto allo schema della ricetta Greengrass durante component build i component publish comandi and. Questo aggiornamento aiuta gli sviluppatori a identificare i problemi risolvibili all'interno delle ricette dei componenti nelle prime fasi del processo di creazione dei componenti.

  • Aggiunge una suite di test di confidenza al modello che può essere richiamata dal comando. test-e2e init Questa suite di test di fiducia include otto test generici che possono essere utilizzati ed estesi per soddisfare le esigenze di test dei componenti di base.

Correzioni di bug e miglioramenti
  • Aggiorna la versione predefinita di Greengrass Testing Framework (GTF) utilizzata dal test-e2e comando alla versione 1.2.0.

1.5.0

Correzioni di bug e miglioramenti

Aggiorna i modelli riconosciuti dall'opzione excludes build quando lo build_system èzip. Questa versione ora riconoscerà i pattern globulari che corrispondono ai nomi dei percorsi in base ai loro caratteri jolly. Ciò consente di specificare in modo personalizzato le directory da cui escludere.

1.4.0
Nuove funzionalità
  • Aggiunge un nuovo config comando che avvia un prompt interattivo per modificare i campi all'interno di un file di configurazione GDK esistente.

  • Modifica i gdk component publish comandi gdk component build and per verificare che la dimensione della ricetta rientri nei requisiti di Greengrass (<=16000 byte) prima di procedere.

Correzioni di bug e miglioramenti
  • Aggiunge una registrazione aggiuntiva nell'output del gdk component build comando quando un errore di sintassi della ricetta impedisce il completamento della compilazione per rendersene conto.

  • Rinomina gtf-version rispettivamente otf-options e otf-version in gtf-options e, a causa della ridenominazione di Open Test Framework in Greengrass Testing Framework.

1.3.0
Nuove funzionalità
  • Aggiunge un nuovo test-e2e comando per supportare il end-to-end test dei componenti utilizzando Open Test Framework.

  • Aggiunge una nuova opzione di configurazione per supportare nomi di file zip configurabili con il sistema di compilazione zip. zip_name

  • Rende region facoltativa la proprietà nel file di configurazione GDK.

Correzioni di bug e miglioramenti
  • Risolve un problema per cui viene creata una nuova directory anche quando il modello o il repository specificato non esiste durante l'inizializzazione di un progetto GDK con l'argomento. --name

1.2.3
Correzioni di bug e miglioramenti
  • Risolve un problema in cui la creazione del bucket non riesce a causa di una gestione errata degli errori.

  • Risolve un problema per cui le strutture degli elenchi nella ricetta del componente vengono rimosse.

1.2.2
Correzioni di bug e miglioramenti
  • I codici delle ricette non distinguono più tra maiuscole e minuscole.

  • Aggiunge un controllo per determinare se un bucket esiste in un bucket Regione AWS ed è accessibile dall'utente prima di creare un nuovo bucket. Richiede che l'utente disponga dell'GetBucketLocationautorizzazione.

  • Risolve un problema con la excludes parola chiave nel file di configurazione della CLI GDK.

1.2.1
Correzioni di bug e miglioramenti
  • Accetta la voce di configurazione della regione Canada (Centralca-central-1) () Regione AWS nel gdk-config.json file.

  • Risolve i problemi con l'argomento --region GDK CLI del comando. publish

1.2.0
Nuove funzionalità
  • Aggiunge la options voce alla build configurazione nel file di configurazione GDK CLI. Supporta excludes under options per escludere determinati file dall'artefatto zip quando si utilizza il sistema di compilazione. zip

  • Aggiunge il sistema di gradlew compilazione per utilizzare Gradle Wrapper per creare componenti.

  • Aggiunge il supporto per i file di build Kotlin DSL per l'opzione build. gradle

  • Aggiunge una options voce alla publish configurazione nel file di configurazione GDK CLI. Supporta quanto file_upload_args segue options per fornire argomenti aggiuntivi durante il caricamento di file su Amazon S3.

Correzioni di bug e miglioramenti
  • Risolve un problema per cui le build di Gradle non venivano pulite prima di eseguire un comando di compilazione.

  • Risolve un problema per cui la build non usciva quando il comando build fallisce.

  • Migliora il formato di output del gdk component list comando.

1.1.0

Nuove funzionalità
  • Aggiunge il supporto per il sistema di build Gradle.

  • Aggiunge il supporto per il sistema di build Maven sui dispositivi Windows.

  • Aggiunge l'--bucketargomento al comando di pubblicazione del componente. Puoi usare questo argomento per specificare il bucket esatto in cui la CLI di GDK carica gli artefatti dei componenti.

  • Aggiunge l'--nameargomento al comando component init. È possibile utilizzare questa opzione per specificare la cartella in cui la CLI GDK inizializza il componente.

  • Aggiunge il supporto per gli artefatti dei componenti che esistono in un bucket S3 ma non nella cartella di build del componente locale. Puoi utilizzare questa funzionalità per ridurre i costi della larghezza di banda per componenti di grandi dimensioni, come i modelli di machine learning.

Correzioni di bug e miglioramenti
  • Aggiorna il comando di pubblicazione del componente per verificare se il componente è stato creato prima di pubblicare il componente. Se il componente non è stato creato, questo comando ora lo crea automaticamente.

  • Risolve un problema per cui il sistema di compilazione zip non riesce a creare su dispositivi Windows quando il nome del file ZIP contiene lettere maiuscole.

  • Migliora il formato dei messaggi di registro e modifica il livello di registro predefinito INFO su dispositivi che eseguono versioni di Python precedenti alla 3.8.

  • Modifica il requisito minimo della versione di Python in Python 3.6.

1.0.0

Versione iniziale.