AWS IoT GreengrassInterface de linha de comando do kit de desenvolvimento - AWS IoT Greengrass
Pré-requisitosChangelog

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWS IoT GreengrassInterface de linha de comando do kit de desenvolvimento

A interface de linha de comando do kit de AWS IoT Greengrass desenvolvimento (GDK CLI) fornece recursos que ajudam você a desenvolver componentes personalizados do Greengrass. Você pode usar a CLI do GDK para criar, criar e publicar componentes personalizados. Ao criar um repositório de componentes com a CLI do GDK, você pode começar com um modelo ou componente da comunidade do Catálogo de Software do Greengrass. Em seguida, você pode escolher um sistema de compilação que empacote arquivos como arquivos ZIP, use um script de compilação do Maven ou do Gradle ou execute um comando de compilação personalizado. Depois de criar um componente, você pode usar a CLI do GDK para publicá-lo AWS IoT Greengrass no serviço. Assim, você pode usar o console ou AWS IoT Greengrass a API para implantar o componente em seus dispositivos principais do Greengrass.

Ao desenvolver componentes do Greengrass sem a CLI do GDK, você deve atualizar os URIs da versão e do artefato no arquivo de receita do componente sempre que criar uma nova versão do componente. Quando você usa a CLI do GDK, ela pode atualizar automaticamente os URIs de versão e artefato sempre que você publica uma nova versão do componente.

A CLI do GDK é de código aberto e está disponível em. GitHub Você pode personalizar e estender a CLI do GDK para atender às suas necessidades de desenvolvimento de componentes. Convidamos você a abrir problemas e fazer pull requests no GitHub repositório. Você pode encontrar a fonte da CLI do GDK no seguinte link: https://github.com/aws-greengrass/. aws-greengrass-gdk-cli

Pré-requisitos

Para instalar e usar a CLI do Greengrass Development Kit, você precisa do seguinte:

  • Uma Conta da AWS. Se você não tiver uma, consulte Configurar um Conta da AWS.

  • Um computador de desenvolvimento semelhante ao Windows, macOS ou Unix com conexão à Internet.

  • Para o GDK CLI versão 1.1.0 ou posterior, o Python 3.6 ou posterior instalado em seu computador de desenvolvimento.

    Para o GDK CLI versão 1.0.0, o Python 3.8 ou posterior está instalado em seu computador de desenvolvimento.

  • Git instalado em seu computador de desenvolvimento.

  • AWS Command Line Interface(AWS CLI) instalado e configurado com credenciais em seu computador de desenvolvimento. Para obter mais informações, consulte Instalação, atualização e desinstalação do AWS CLI e Configuração do AWS CLI no Guia do AWS Command Line Interface Usuário.

    nota

    Se você usa um Raspberry Pi ou outro dispositivo ARM de 32 bits, instale AWS CLI a V1. AWS CLI A V2 não está disponível para dispositivos ARM de 32 bits. Para obter mais informações, consulte Instalando, atualizando e desinstalando a AWS CLI versão 1.

  • Para usar a CLI do GDK para publicar componentes AWS IoT Greengrass no serviço, você deve ter as seguintes permissões:

    • s3:CreateBucket

    • s3:GetBucketLocation

    • s3:PutObject

    • greengrass:CreateComponentVersion

    • greengrass:ListComponentVersions

  • Para usar a CLI do GDK para criar um componente cujos artefatos existem em um bucket do S3 e não no sistema de arquivos local, você deve ter as seguintes permissões:

    • s3:ListBucket

    Esse recurso está disponível para o GDK CLI v1.1.0 e versões posteriores.

Changelog

A tabela a seguir descreve as alterações em cada versão da CLI do GDK. Para obter mais informações, consulte a página de lançamentos da CLI do GDK em. GitHub

Version (Versão)

Alterações

1.6.2
Correções de erros e melhorias

  • Corrige um problema em que o gradlew.bat do Windows não funciona devido ao caminho relativo.

  • Pequenas melhorias no registro, nos testes e no empacotamento.

1.6.1
Correções de erros e melhorias

  • Adiciona uma correção de segurança para análise de argumentos da CLI.

  • Permite que o GDK obtenha o nome de versão mais recente do Greengrass Testing Framework (GTF) como a versão padrão do GTF.

  • Permite que o GDK recomende aos clientes que usam uma versão mais antiga do GTF que eles atualizem para a versão mais recente.

1.6.0
Novos atributos

  • Adiciona uma verificação de validação da receita em relação ao esquema da receita do Greengrass durante os comandos e. component build component publish Essa atualização ajuda os desenvolvedores a identificar problemas acionáveis em suas receitas de componentes no início do processo de criação de componentes.

  • Adiciona um conjunto de testes de confiança ao modelo que pode ser baixado pelo test-e2e init comando. Esse conjunto de testes de confiança inclui oito testes genéricos que podem ser usados e ampliados para atender às necessidades básicas de testes de componentes.

Correções de erros e melhorias

  • Atualiza a versão padrão do Greengrass Testing Framework (GTF) usada pelo test-e2e comando para a versão 1.2.0.

1.5.0
Correções de erros e melhorias

Atualiza os padrões reconhecidos pela opção de excludes construção quando build_system estiverzip. Esta versão agora reconhecerá padrões globais que correspondem aos nomes de caminho com base em seus caracteres curinga. Isso permite a especificação personalizada de quais diretórios excluir.
1.4.0
Novos atributos

  • Adiciona um novo config comando que inicia um prompt interativo para modificar campos em um arquivo de configuração existente do GDK.

  • Modifica os gdk component publish comandos gdk component build e para verificar se o tamanho da receita está dentro dos requisitos do Greengrass (<=16000 bytes) antes de continuar.

Correções de erros e melhorias

  • Adiciona registro adicional na saída do gdk component build comando quando um erro de sintaxe da receita está impedindo a conclusão da compilação para fins de reconhecimento.

  • Renomeia otf-options e otf-version para gtf-options e gtf-version respectivamente, devido à renomeação do Open Test Framework para Greengrass Testing Framework.
1.3.0
Novos atributos

  • Adiciona um novo test-e2e comando para oferecer suporte ao end-to-end teste de componentes usando o Open Test Framework.

  • Adiciona uma nova opção de configuração,zip_name, para oferecer suporte a nomes de arquivos zip configuráveis com o sistema de compilação zip.

  • Torna a region propriedade no arquivo de configuração do GDK opcional.

Correções de erros e melhorias

  • Corrige um problema em que um novo diretório é criado mesmo quando o modelo ou repositório especificado não existe ao inicializar um projeto GDK com o argumento. --name
1.2.3
Correções de erros e melhorias

  • Corrige um problema em que a criação do bucket falha devido ao tratamento incorreto de erros.

  • Corrige um problema em que as estruturas de lista na receita do componente são removidas.
1.2.2
Correções de erros e melhorias

  • As chaves da receita não diferenciam mais maiúsculas de minúsculas.

  • Adiciona uma verificação para determinar se um bucket existe em um Região da AWS e está acessível pelo usuário antes de criar um novo bucket. Requer que o usuário tenha a GetBucketLocation permissão.

  • Corrige um problema com a excludes palavra-chave no arquivo de configuração da CLI do GDK.
1.2.1
Correções de erros e melhorias

  • Aceita o Canadá (Central) (ca-central-1) Região da AWS na entrada de configuração da região no gdk-config.json arquivo.

  • Corrige problemas com o argumento da CLI do --region GDK para o publish comando.
1.2.0
Novos atributos

  • Adiciona a options entrada à build configuração no arquivo de configuração da CLI do GDK. excludesSuporta options a exclusão de determinados arquivos do artefato zip ao usar o sistema de zip compilação.

  • Adiciona o sistema de gradlew compilação para usar o Gradle Wrapper para criar componentes.

  • Adiciona suporte para arquivos de compilação Kotlin DSL para a opção de compilação. gradle

  • Adiciona uma options entrada à publish configuração no arquivo de configuração da CLI do GDK. Suporta o file_upload_args under options para fornecer argumentos adicionais ao fazer o upload de arquivos para o Amazon S3.

Correções de erros e melhorias

  • Corrige um problema em que as compilações do Gradle não eram limpas antes de executar um comando de compilação.

  • Corrige um problema em que a compilação não saía quando o comando de compilação falhava.

  • Melhora o formato de saída do gdk component list comando.

1.1.0
Novos atributos

  • Adiciona suporte ao sistema de compilação Gradle.

  • Adiciona suporte para o sistema de compilação Maven em dispositivos Windows.

  • Adiciona o --bucket argumento ao comando de publicação do componente. Você pode usar esse argumento para especificar o bucket exato em que a CLI do GDK carrega artefatos do componente.

  • Adiciona o --name argumento ao comando init do componente. Você pode usar essa opção para especificar a pasta em que a CLI do GDK inicializa o componente.

  • Adiciona suporte para artefatos de componentes que existem em um bucket do S3, mas não na pasta local de criação de componentes. Você pode usar esse recurso para reduzir os custos de largura de banda para artefatos de componentes grandes, como modelos de aprendizado de máquina.

Correções de erros e melhorias

  • Atualiza o comando de publicação do componente para verificar se o componente foi criado antes de publicá-lo. Se o componente não foi criado, esse comando agora cria o componente para você.

  • Corrige um problema em que o sistema de compilação zip falha na compilação em dispositivos Windows quando o nome do arquivo ZIP contém letras maiúsculas.

  • Melhora o formato da mensagem de log e altera o nível de log padrão para INFO em dispositivos que executam versões do Python anteriores à 3.8.

  • Altera o requisito mínimo da versão do Python para Python 3.6.

1.0.0

Versão inicial.