Greengrass nucleus lite - AWS IoT Greengrass
VersõesSistema operacionalRequisitosCompatibilidadeDownload e instalaçãoConfiguraçãoArquivo de log localChangelog

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á.

Greengrass nucleus lite

O Greengrass nucleus lite (aws.greengrass.NucleusLite) é um runtime de dispositivo para dispositivos de borda restritos, otimizado para ocupar o mínimo de memória (usa menos de 5 MB de RAM). Ele foi introduzido com a AWS IoT Greengrass versão 2.14.0 e é compatível com versões anteriores de componentes AWS IoT Greengrass genéricos, da API Greengrass V2 e do SDK.

O Greengrass nucleus lite é oferecido como uma alternativa ao Greengrass nucleus (aws.greengrass.Nucleus) comum, e pode ser usado em frotas heterogêneas de dispositivos Greengrass.

Versões

Esse componente tem as seguintes versões:

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Sistema operacional

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

  • Linux (distribuições com systemd)

Para obter mais informações, consulte Greengrass nucleus.

Requisitos

Os dispositivos devem atender a determinados requisitos para instalar e executar o AWS IoT Greengrass nucleus lite e o software AWS IoT Greengrass Core. Para obter mais informações, consulte o Guia de configuração.

  • 5 MB de espaço RAM para o runtime do nucleus.

  • 5MB de armazenamento (disco/FLASH).

Dependências adicionais do sistema estão documentadas no Guia de configuração.

O componente do Greengrass nucleus é compatível para ser executado em uma VPC. Para implantá-lo em uma VPC, o procedimento a seguir é necessário:

  • O núcleo do Greengrass deve ter conectividade com AWS IoT dados, AWS IoT credenciais e Amazon S3.

Compatibilidade

O AWS IoT Greengrass nucleus lite é compatível com a API AWS IoT Greengrass v2 (subconjunto de) e é compatível. SDKs Não depende de nenhuma linguagem específica, runtimes/VMs mas os componentes adicionados a uma implantação podem exigir a presença de tempos de execução específicos (por exemplo: Java JVM, Python). Para obter mais informações sobre quais recursos oferecem suporte ao Greengrass nucleus lite, consulte Compatibilidade de recursos do Greengrass.

Download e instalação

Você pode baixar um pacote apt, compilar a partir do código-fonte, usar uma camada Yocto ou baixar uma imagem pré-construída do Yocto para um dispositivo compatível (por exemplo,). RaspberryPi No Console do AWS IoT Core, será possível baixar um kit de conexão contendo todas as credenciais e a configuração inicial do seu dispositivo. As instruções sobre como instalar estão incluídas em cada método de distribuição específico.

Você também pode seguir um tutorial para instalar o AWS IoT Greengrass nucleus lite e explorar o desenvolvimento de componentes do Greengrass. Para obter mais informações, consulte Tutorial: Conceitos básicos do AWS IoT Greengrass V2.

Configuração

O nucleus oferece os parâmetros de configuração a seguir. Alguns parâmetros exigem que o software AWS IoT Greengrass Core seja reiniciado para entrar em vigor.

iotRoleAlias

O alias de AWS IoT função que aponta para uma função do IAM de troca de tokens. O provedor de AWS IoT credenciais assume essa função para permitir que o dispositivo principal do Greengrass interaja com os serviços. AWS Para obter mais informações, consulte Autorizar dispositivos principais a interagir com os AWS serviços.

iotDataEndpoint

O endpoint de AWS IoT dados para seu. Conta da AWS

iotCredEndpoint

O endpoint AWS IoT de credenciais para seu. Conta da AWS

greengrassDataPlanePort

A porta usada para conexões de plano de dados. Para obter mais informações, consulte Conexão à porta 443 ou por um proxy de rede.

Importante

Você precisa especificar uma porta na qual o dispositivo possa fazer conexões de saída. Se você especificar uma porta bloqueada, o dispositivo não conseguirá se conectar AWS IoT Greengrass para receber implantações. Escolha uma das seguintes opções:

  • 443

  • 8443

  • Padrão: 8443

awsRegion

O Região da AWS para usar.

runWithDefault

O usuário do sistema usado para executar componentes.

Importante

Quando você implanta uma alteração nesse parâmetro de configuração, o software AWS IoT Greengrass principal é reiniciado para que a alteração entre em vigor.

Esse objeto contém as informações a seguir:

posixUser

O nome ou ID do usuário do sistema e, opcionalmente, do grupo do sistema que o dispositivo do nucleus usa para executar componentes genéricos. Especifique o usuário e o grupo separando-os por dois pontos (:), no seguinte formato: user:group. O grupo é opcional. Se você não especificar um grupo, o software AWS IoT Greengrass Core usará o grupo primário para o usuário. Por exemplo, é possível especificar ggc_user ou ggc_user:ggc_group. Para obter mais informações, consulte Configurar o usuário que executa os componentes.

networkProxy

(Opcional) O proxy de rede para ser usado em todas as conexões. Para obter mais informações, consulte Conectar-se à porta 443 ou por meio de um proxy de rede.

Importante

Quando você implanta uma alteração nesse parâmetro de configuração, a alteração entrará em vigor após a próxima reinicialização do software AWS IoT Greengrass principal.

Esse objeto contém as informações a seguir:

noProxyAddresses

(Opcional) Uma lista separada por vírgulas de endereços IP ou nomes de host isentos do proxy.

proxy

O proxy para se conectar. Esse objeto contém as informações a seguir:

url

O URL do servidor de proxy, no formato http://host:port.

  • scheme: o esquema, que deve ser http.

  • host: o nome do host ou endereço IP do servidor de proxy.

  • port: (opcional) o número da porta. Se você não especificar a porta, o dispositivo principal do Greengrass usa valore padrão a seguir:

    • http: 80

Arquivo de log local

As mensagens são registradas no stdout e os arquivos de log são gerenciados pelo systemd.

Para exibir os logs desse componente

  • Use journalctl para exibir os logs.

Changelog

Versão

Alterações

2.3.0
Novos recursos

  • Support para usar o TPM 2.0 para autorização do IoT Core MQTT.

  • Os pacotes apt de amostra agora suportam mais sistemas operacionais: Ubuntu 22.04, Ubuntu 24.04, Debian 12 e Debian 13.

  • RestartComponent O IPC agora é suportado.

Correções de bugs e melhorias

  • As implantações locais não precisam mais de acesso à Internet.

  • GetConfiguration foi atualizado para corresponder ao comportamento de execução do Greengrass Nucleus. (Alteração significativa)

  • Melhorias e correções de erros gerais.

2.2.2
Correções de bugs e melhorias

  • Corrige falhas nas implantações revisadas contendo versões de componentes inalteradas quando um componente inalterado tinha um executável em execução como artefato.

  • Corrige a interpolação de variáveis da receita quando o valor interpolado tiver mais de quatro subobjetos aninhados.

  • Corrige a interpolação de variáveis da receita, incluindo aspas e caracteres especiais do shell.

  • Corrige o vazamento de fds quando as conexões de MQTT falham.

2.2.1
Correções de bugs e melhorias

  • Corrige um problema em que o nucleus falha na obtenção das credenciais do TES.

2.2.0
Novos recursos

  • Adiciona suporte para artefato URIs de imagem de contêiner.

Correções de bugs e melhorias

  • Melhorias e correções de erros gerais.

2.1.0
Novos recursos

  • Adiciona suporte a proxy de HTTP, que pode ser configurado usando a opção de configuração networkProxy.

Correções de bugs e melhorias

  • Reduz a exigência da libcurl de 7.86 para 7.82 para acomodar dispositivos que executem versões da libcurl mais antigas.

  • Atualiza os logs do journalctl para que sejam atribuídos aos componentes em vez do executor de receitas.

  • Melhora as respostas de erro para chamadas de IPC.

  • Adiciona novas tentativas para tentativas de download do S3 para artefatos de componentes genéricos.

  • Correções de erros secundárias.

2.0.2
Correções de bugs e melhorias

  • Corrige as dependências dos pacotes de apt para incluírem cgroup-tools.

2.0.1
Correções de bugs e melhorias

  • Adiciona suporte à interpolação de variáveis de receita para a seção de tempo limite da receita do Greengrass.

  • Adiciona suporte ao comando ValidateAuthorizationToken IPC para o gerenciador de fluxo.

  • Corrige os avisos de aprovisionamento da frota.

  • Adiciona novas tentativas e recuos ao receptor de tarefas.

  • Melhorias e correções de erros gerais.

2.0.0

Versão inicial.