Núcleo Greengrass - AWS IoT Greengrass
VersõesSistema operacionalRequisitosDependênciasDownload 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á.

Núcleo Greengrass

O componente do núcleo do Greengrass (aws.greengrass.Nucleus) é um componente obrigatório e o requisito mínimo para executar o software AWS IoT Greengrass Core em um dispositivo. Você pode configurar esse componente para personalizar e atualizar seu software AWS IoT Greengrass Core remotamente. Implante esse componente para definir configurações como proxy, função do dispositivo e configuração do AWS IoT item em seus dispositivos principais.

Importante

Quando a versão do componente do núcleo muda, ou quando você altera determinados parâmetros de configuração, o software AWS IoT Greengrass Core, que inclui o núcleo e todos os outros componentes do seu dispositivo, reinicia a aplicação das alterações.

Quando você implanta um componente, AWS IoT Greengrass instala as versões mais recentes suportadas de todas as dependências desse componente. Por esse motivo, novas versões AWS de patch dos componentes públicos fornecidos podem ser implantadas automaticamente em seus dispositivos principais se você adicionar novos dispositivos a um grupo de coisas ou atualizar a implantação que visa esses dispositivos. Algumas atualizações automáticas, como a atualização do nucleus, podem fazer com que seus dispositivos reiniciem inesperadamente.

Para evitar atualizações não intencionais para um componente que está sendo executado em seu dispositivo, recomendamos que você inclua diretamente sua versão preferida desse componente ao criar uma implantação. Para obter mais informações sobre o comportamento de atualização AWS IoT Greengrass do software Core, consulteAtualize o software AWS IoT Greengrass principal (OTA).

Versões

Esse componente tem as seguintes versões:

  • 2.12.x

  • 2.11.x

  • 2.10.x

  • 2.9.x

  • 2,8.x

  • 2.7.x

  • 2.6.x

  • 2,5.x

  • 2.4.x

  • 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

  • Windows

Para ter mais informações, consulte Plataformas compatíveis.

Requisitos

Os dispositivos devem atender a certos requisitos para instalar e executar o núcleo Greengrass e o AWS IoT Greengrass software Core. Para ter mais informações, consulte Requisitos do dispositivo.

O componente do núcleo do Greengrass tem suporte para ser executado em uma VPC. Para implantar esse componente em uma VPC, é necessário o seguinte.

  • O componente do núcleo do Greengrass deve ter conectividade com AWS IoT data, AWS IoT Credentials e Amazon S3.

Dependências

O núcleo do Greengrass não inclui nenhuma dependência de componentes. No entanto, vários componentes AWS fornecidos incluem o núcleo como uma dependência. Para ter mais informações, consulte AWS-componentes fornecidos.

Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.

Download e instalação

Você pode baixar um instalador que configura o componente nucleus do Greengrass em seu dispositivo. Esse instalador configura seu dispositivo como um dispositivo principal do Greengrass. Há dois tipos de instalações que você pode realizar: uma instalação rápida que cria AWS os recursos necessários para você ou uma instalação manual em que você mesmo cria os AWS recursos. Para ter mais informações, consulte Instalar o software do AWS IoT Greengrass Core.

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

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente. Alguns parâmetros exigem que o software AWS IoT Greengrass Core seja reiniciado para entrar em vigor. Para obter mais informações sobre por que e como configurar esse componente, consulteConfigurar o software AWS IoT Greengrass principal.

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 ter mais informações, consulte Autorize os dispositivos principais a interagir com os serviços AWS.

Quando você executa o software AWS IoT Greengrass Core com a --provision true opção, o software provisiona um alias de função e define seu valor no componente do núcleo.

interpolateComponentConfiguration

(Opcional) Você pode habilitar o núcleo do Greengrass para interpolar variáveis de receitas de componentes em configurações de componentes e mesclar atualizações de configuração. Recomendamos que você defina essa opção para true que o dispositivo principal possa executar componentes do Greengrass que usam variáveis de receita em suas configurações.

Esse recurso está disponível para a versão 2.6.0 e posterior desse componente.

Padrão: false

networkProxy

(Opcional) O proxy de rede a ser usado em todas as conexões. Para ter 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, o software AWS IoT Greengrass principal é reiniciado para que a alteração entre em vigor.

Esse objeto contém as seguintes informações:

noProxyAddresses

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

proxy

O proxy ao qual se conectar. Esse objeto contém as seguintes informações:

url

O URL do servidor proxy no formatoscheme://userinfo@host:port.

  • scheme— O esquema, que deve ser http ouhttps.

    Importante

    Os dispositivos principais do Greengrass devem executar o Greengrass nucleus v2.5.0 ou posterior para usar proxies HTTPS.

    Se você configurar um proxy HTTPS, deverá adicionar o certificado CA do servidor proxy ao certificado de CA raiz da Amazon do dispositivo principal. Para ter mais informações, consulte Permita que o dispositivo principal confie em um proxy HTTPS.

  • userinfo— (Opcional) As informações de nome de usuário e senha. Se você especificar essas informações nourl, o dispositivo principal do Greengrass ignorará os campos e. username password

  • host— O nome do host ou endereço IP do servidor proxy.

  • port— (Opcional) O número da porta. Se você não especificar a porta, o dispositivo principal do Greengrass usará os seguintes valores padrão:

    • http— 80

    • https— 443

username

(Opcional) O nome de usuário que autentica o servidor proxy.

password

(Opcional) A senha que autentica o servidor proxy.

mqtt

(Opcional) A configuração MQTT para o dispositivo principal do Greengrass. Para ter 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, o software AWS IoT Greengrass principal é reiniciado para que a alteração entre em vigor.

Esse objeto contém as seguintes informações:

port

(Opcional) A porta a ser usada para conexões MQTT.

Padrão: 8883

keepAliveTimeoutMs

(Opcional) A quantidade de tempo em milissegundos entre cada PING mensagem que o cliente envia para manter a conexão MQTT ativa. Esse valor deve ser maior quepingTimeoutMs.

Padrão: 60000 (60 segundos)

pingTimeoutMs

(Opcional) A quantidade de tempo em milissegundos que o cliente espera para receber uma PINGACK mensagem do servidor. Se a espera exceder o tempo limite, o dispositivo principal fecha e reabre a conexão MQTT. Esse valor deve ser menor quekeepAliveTimeoutMs.

Padrão: 30000 (30 segundos)

operationTimeoutMs

(Opcional) A quantidade de tempo em milissegundos que o cliente espera que as operações do MQTT (como CONNECT ouPUBLISH) sejam concluídas. Essa opção não se aplica ao MQTT PING nem às mensagens de manutenção ativa.

Padrão: 30000 (30 segundos)

maxInFlightPublishes

(Opcional) O número máximo de mensagens de QoS 1 não confirmadas do MQTT que podem estar em andamento ao mesmo tempo.

Esse recurso está disponível para a versão 2.1.0 e posterior desse componente.

Padrão: 5

Intervalo válido: valor máximo de 100

maxMessageSizeInBytes

(Opcional) O tamanho máximo de uma mensagem MQTT. Se uma mensagem exceder esse tamanho, o núcleo do Greengrass a rejeitará com um erro.

Esse recurso está disponível para a versão 2.1.0 e posterior desse componente.

Padrão: 131072 (128 KB)

Intervalo válido: valor máximo de 2621440 (2,5 MB)

maxPublishRetry

(Opcional) O número máximo de vezes para repetir uma mensagem que não foi publicada. Você pode especificar -1 para tentar novamente vezes ilimitadas.

Esse recurso está disponível para a versão 2.1.0 e posterior desse componente.

Padrão: 100

spooler

(Opcional) A configuração do spooler MQTT para o dispositivo principal Greengrass. Esse objeto contém as seguintes informações:

storageType

O tipo de armazenamento para armazenar mensagens. Se storageType estiver definido comoDisk, o pluginName pode ser configurado. Você pode especificar Memory ou Disk.

Esse recurso está disponível para a versão 2.11.0 e posterior do componente núcleo do Greengrass.

Importante

Se o spooler MQTT storageType estiver definido como Disk e você quiser fazer o downgrade do Greengrass nucleus da versão 2.11.x para uma versão anterior, você deverá alterar a configuração novamente para. Memory A única configuração para storageType isso é suportada nas versões 2.10.x e anteriores do Greengrass nucleus é. Memory Não seguir essas orientações pode resultar na quebra do spooler. Isso faria com que seu dispositivo principal do Greengrass não conseguisse enviar mensagens MQTT para o. Nuvem AWS

Padrão: Memory

pluginName

(Opcional) O nome do componente do plug-in. Esse componente só será usado se storageType estiver definido comoDisk. Essa opção é padronizada aws.greengrass.DiskSpooler e usará o fornecido pelo Greengrass. Spooler de disco

Esse recurso está disponível para a versão 2.11.0 e posterior do componente núcleo do Greengrass.

Padrão: "aws.greengrass.DiskSpooler"

maxSizeInBytes

(Opcional) O tamanho máximo do cache em que o dispositivo principal armazena mensagens MQTT não processadas na memória. Se o cache estiver cheio, novas mensagens serão rejeitadas.

Padrão: 2621440 (2,5 MB)

keepQos0WhenOffline

(Opcional) Você pode agrupar mensagens de QoS 0 do MQTT que o dispositivo principal recebe enquanto está off-line. Se você definir essa opção comotrue, o dispositivo principal armazenará mensagens de QoS 0 que ele não pode enviar enquanto estiver off-line. Se você definir essa opção comofalse, o dispositivo principal descartará essas mensagens. O dispositivo principal sempre armazena mensagens de QoS 1, a menos que o spool esteja cheio.

Padrão: false

version

(Opcional) A versão do MQTT. Você pode especificar mqtt3 ou mqtt5.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: mqtt5

receiveMaximum

(Opcional) O número máximo de pacotes de QoS1 não reconhecidos que o agente pode enviar.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: 100

sessionExpirySeconds

(Opcional) A quantidade de tempo em segundos que você pode solicitar para que uma sessão dure a partir do IoT Core. O padrão é o tempo máximo suportado pelo AWS IoT Core.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: 604800 (7 days)

minimumReconnectDelaySeconds

(Opcional) Uma opção para o comportamento de reconexão. O tempo mínimo em segundos para o MQTT se reconectar.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: 1

maximumReconnectDelaySeconds

(Opcional) Uma opção para o comportamento de reconexão. O tempo máximo em segundos para o MQTT se reconectar.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: 120

minimumConnectedTimeBeforeRetryResetSeconds

(Opcional) Uma opção para o comportamento de reconexão. A quantidade de tempo em segundos em que uma conexão deve estar ativa antes que o atraso da nova tentativa seja redefinido ao mínimo.

Esse recurso está disponível para a versão 2.10.0 e posterior do componente núcleo do Greengrass.

Padrão: 30

jvmOptions

(Opcional) As opções de JVM a serem usadas para executar o software AWS IoT Greengrass Core. Para obter informações sobre as opções recomendadas de JVM para executar o software AWS IoT Greengrass Core, consulte. Controle a alocação de memória com opções de JVM

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.

iotDataEndpoint

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

Quando você executa o software AWS IoT Greengrass Core com a --provision true opção, o software obtém seus endpoints de dados e credenciais AWS IoT e os define no componente nuclear.

iotCredEndpoint

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

Quando você executa o software AWS IoT Greengrass Core com a --provision true opção, o software obtém seus endpoints de dados e credenciais AWS IoT e os define no componente nuclear.

greengrassDataPlaneEndpoint

Esse recurso está disponível na versão 2.7.0 e posterior desse componente.

Para ter mais informações, consulte Use um certificado de dispositivo assinado por uma CA privada.

greengrassDataPlanePort

Esse recurso está disponível na versão 2.0.4 e posterior desse componente.

(Opcional) A porta a ser usada para conexões de plano de dados. Para ter mais informações, consulte Conectar-se à porta 443 ou por meio de um proxy de rede.

Importante

Você deve 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 a ser 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 seguintes informações:

posixUser

O nome ou ID do usuário do sistema e, opcionalmente, do grupo do sistema que o dispositivo principal usa para executar componentes genéricos e Lambda. 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 ter mais informações, consulte Configurar o usuário que executa os componentes.

Quando você executa o instalador do software AWS IoT Greengrass Core com a --component-default-user ggc_user:ggc_group opção, o software define esse parâmetro no componente do núcleo.

windowsUser

Esse recurso está disponível na versão 2.5.0 e posterior desse componente.

O nome do usuário do Windows a ser usado para executar esse componente nos dispositivos principais do Windows. O usuário deve existir em cada dispositivo principal do Windows, e seu nome e senha devem ser armazenados na instância do Gerenciador de Credenciais da LocalSystem conta. Para ter mais informações, consulte Configurar o usuário que executa os componentes.

Quando você executa o instalador do software AWS IoT Greengrass Core com a --component-default-user ggc_user opção, o software define esse parâmetro no componente do núcleo.

systemResourceLimits

Esse recurso está disponível na versão 2.4.0 e posterior desse componente. AWS IoT Greengrass atualmente não oferece suporte a esse recurso nos dispositivos principais do Windows.

Por padrão, os limites de recursos do sistema devem ser aplicados a processos de componentes Lambda genéricos e não conteinerizados. Você pode substituir os limites de recursos do sistema para componentes individuais ao criar uma implantação. Para ter mais informações, consulte Configurar limites de recursos do sistema para componentes.

Esse objeto contém as seguintes informações:

cpus

A quantidade máxima de tempo de CPU que os processos de cada componente podem usar no dispositivo principal. O tempo total da CPU de um dispositivo essencial é equivalente ao número de núcleos da CPU do dispositivo. Por exemplo, em um dispositivo principal com 4 núcleos de CPU, você pode definir esse valor 2 para limitar os processos de cada componente a 50% de uso de cada núcleo da CPU. Em um dispositivo com 1 núcleo de CPU, você pode definir esse valor 0.25 para limitar os processos de cada componente a 25% de uso da CPU. Se você definir esse valor como um número maior que o número de núcleos de CPU, o software AWS IoT Greengrass Core não limitará o uso da CPU dos componentes.

memory

A quantidade máxima de RAM (em kilobytes) que os processos de cada componente podem usar no dispositivo principal.

s3EndpointType

(Opcional) O tipo de endpoint S3. Esse parâmetro só terá efeito para a região Leste dos EUA (Norte da Virgíniaus-east-1) (). A configuração desse parâmetro em qualquer outra região será ignorada. Escolha uma das seguintes opções:

  • REGIONAL— O cliente S3 e o URL pré-assinado usam o endpoint regional.

  • GLOBAL— O cliente S3 e o URL pré-assinado usam o endpoint legado.

Padrão: GLOBAL

logging

(Opcional) A configuração de registro do dispositivo principal. Para obter mais informações sobre como configurar e usar os registros do Greengrass, consulte. Monitore AWS IoT Greengrass os registros

Esse objeto contém as seguintes informações:

level

(Opcional) O nível mínimo de mensagens de log a serem enviadas.

Escolha entre os seguintes níveis de registro, listados aqui em ordem de nível:

  • DEBUG

  • INFO

  • WARN

  • ERROR

Padrão: INFO

format

(Opcional) O formato de dados dos registros. Escolha uma das seguintes opções:

Padrão: TEXT

outputType

(Opcional) O tipo de saída para registros. Escolha uma das seguintes opções:

  • FILE— O software AWS IoT Greengrass Core envia registros para arquivos no diretório que você especifica. outputDirectory

  • CONSOLE— O software AWS IoT Greengrass Core imprime registros emstdout. Escolha essa opção para ver os registros à medida que o dispositivo principal os imprime.

Padrão: FILE

fileSizeKB

(Opcional) O tamanho máximo de cada arquivo de log (em kilobytes). Depois que um arquivo de log excede esse tamanho máximo de arquivo, o software AWS IoT Greengrass Core cria um novo arquivo de log.

Esse parâmetro se aplica somente quando você especifica FILE paraoutputType.

Padrão: 1024

totalLogsSizeKB

(Opcional) O tamanho total máximo dos arquivos de log (em kilobytes) para cada componente, incluindo o núcleo do Greengrass. Os arquivos de log do Greengrass nucleus também incluem registros de componentes de plug-ins. Depois que o tamanho total dos arquivos de log de um componente excede esse tamanho máximo, o software AWS IoT Greengrass Core exclui os arquivos de log mais antigos desse componente.

Esse parâmetro é equivalente ao parâmetro de limite de espaço em disco do componente gerenciador de registros (diskSpaceLimit), que você pode especificar para o núcleo Greengrass (sistema) e cada componente. O software AWS IoT Greengrass Core usa o mínimo dos dois valores como o tamanho máximo total do log para o núcleo do Greengrass e cada componente.

Esse parâmetro se aplica somente quando você especifica FILE paraoutputType.

Padrão: 10240

outputDirectory

(Opcional) O diretório de saída dos arquivos de log.

Esse parâmetro se aplica somente quando você especifica FILE paraoutputType.

Padrão:/greengrass/v2/logs, onde /greengrass/v2 está a pasta AWS IoT Greengrass raiz.

fleetstatus

Esse parâmetro está disponível na versão 2.1.0 e posterior desse componente.

(Opcional) A configuração do status da frota para o dispositivo principal.

Esse objeto contém as seguintes informações:

periodicStatusPublishIntervalSeconds

(Opcional) A quantidade de tempo (em segundos) entre o qual o dispositivo principal publica o status do dispositivo no Nuvem AWS.

Mínimo: 86400 (24 horas)

Padrão: 86400 (24 horas)

telemetry

(Opcional) A configuração de telemetria de integridade do sistema para o dispositivo principal. Para obter mais informações sobre métricas de telemetria e como agir com base nos dados de telemetria, consulte. Colete dados de telemetria de integridade do sistema a partir dos dispositivos principais AWS IoT Greengrass

Esse objeto contém as seguintes informações:

enabled

(Opcional) Você pode ativar ou desativar a telemetria.

Padrão: true

periodicAggregateMetricsIntervalSeconds

(Opcional) O intervalo (em segundos) durante o qual o dispositivo principal agrega métricas.

Se você definir esse valor abaixo do valor mínimo suportado, o núcleo usará o valor padrão em vez disso.

Mínimo: 3600

Padrão: 3600

periodicPublishMetricsIntervalSeconds

(Opcional) A quantidade de tempo (em segundos) entre o qual o dispositivo principal publica métricas de telemetria no. Nuvem AWS

Se você definir esse valor abaixo do valor mínimo suportado, o núcleo usará o valor padrão em vez disso.

Mínimo: 86400

Padrão: 86400

deploymentPollingFrequencySeconds

(Opcional) O período em segundos para pesquisar as notificações de implantação.

Padrão: 15

componentStoreMaxSizeBytes

(Opcional) O tamanho máximo em disco do armazenamento de componentes, que inclui receitas e artefatos de componentes.

Padrão: 10000000000 (10 GB)

platformOverride

(Opcional) Um dicionário de atributos que identifica a plataforma do dispositivo principal. Use isso para definir atributos de plataforma personalizados que as receitas de componentes podem usar para identificar o ciclo de vida e os artefatos corretos do componente. Por exemplo, você pode definir um atributo de capacidade de hardware para implantar somente o conjunto mínimo de artefatos para execução de um componente. Para obter mais informações, consulte o parâmetro da plataforma de manifesto na receita do componente.

Você também pode usar esse parâmetro para substituir os atributos os e da architecture plataforma do dispositivo principal.

httpClient

Esse parâmetro está disponível na versão 2.5.0 e posterior desse componente.

(Opcional) A configuração do cliente HTTP para o dispositivo principal. Essas opções de configuração se aplicam a todas as solicitações HTTP feitas por esse componente. Se um dispositivo principal for executado em uma rede mais lenta, você poderá aumentar essas durações de tempo limite para evitar que as solicitações HTTP atinjam o tempo limite.

Esse objeto contém as seguintes informações:

connectionTimeoutMs

(Opcional) A quantidade de tempo (em milissegundos) de espera pela abertura de uma conexão antes que a solicitação de conexão expire.

Padrão: 2000 (2 segundos)

socketTimeoutMs

(Opcional) A quantidade de tempo (em milissegundos) de espera pela transferência dos dados por uma conexão aberta antes que a conexão expire.

Padrão: 30000 (30 segundos)

exemplo Exemplo: atualização da mesclagem de configurações
{
  "iotRoleAlias": "GreengrassCoreTokenExchangeRoleAlias",
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "http://my-proxy-server:1100",
      "username": "Mary_Major",
      "password": "pass@word1357"
    }
  },
  "mqtt": {
    "port": 443
  },
  "greengrassDataPlanePort": 443,
  "jvmOptions": "-Xmx64m",
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Arquivo de log local

Esse componente usa o seguinte arquivo de log.

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
Para ver os registros desse componente

  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.

Version (Versão)

Alterações

2.12.6
Correções de erros e melhorias

  • Corrige um problema que causa uma falha na inicialização em determinados processadores ARMv8, incluindo o Jetson Nano.

2.12.5
Correções de erros e melhorias

  • Corrige um problema em que a reversão da implantação ocasionalmente trava ao reverter um componente anteriormente quebrado com dependências rígidas.

  • Corrige um problema em que o núcleo não publica atualizações de status após o provisionamento da frota.

  • Adiciona novas tentativas para a GetDeploymentConfiguration API após receber erros 404.

2.12.4
Correções de erros e melhorias

  • Corrige um problema em que o núcleo entra em uma condição de impasse durante a inicialização em alguns dispositivos Linux.

2.12.3
Atenção

Essa versão não está mais disponível. As melhorias nesta versão estão disponíveis em versões posteriores desse componente.

Correções de erros e melhorias

  • Corrige um problema em que o núcleo não relata o status correto do componente após a reinicialização do núcleo e durante a recuperação do componente.

  • Melhorias e correções de erros gerais.

2.12.2
Correções de erros e melhorias

  • Corrige um problema em que os registros antigos não eram limpos adequadamente.

  • Melhorias e correções de erros gerais.

2.12.1
Correções de erros e melhorias

  • Corrige um problema em que o núcleo pode duplicar as assinaturas do MQTT para tópicos de implantação, levando a registros adicionais e publicações do MQTT.

2.12.0
Novos atributos

  • Permite que você execute as etapas do ciclo de vida do bootstrap como parte de uma implantação de reversão.

2.11.3
Correções de erros e melhorias

  • Corrige um problema no núcleo em que ele pode iniciar incorretamente um componente quando suas dependências falham.

Novos atributos

  • Adiciona um tipo de endpoint s3 configurável.

2.11.2
Correções de erros e melhorias

  • Corrige um problema no cliente nucleus MQTT 5 em que ele pode aparecer offline quando um grande número (> 50) de assinaturas está em uso.

  • Adiciona uma nova tentativa para a falha do docker dial TCP.

2.11.1
Correções de erros e melhorias

  • Corrige um problema em que o núcleo não é iniciado se uma tarefa de bootstrap falhar e o arquivo de metadados de implantação estiver corrompido.

  • Corrige um problema em que os componentes Lambda sob demanda não são relatados nas atualizações de status de implantação.

  • Adiciona suporte para IDs de política de autorização duplicados.

2.11.0
Novos atributos

  • Permite que você cancele uma implantação local.

  • Permite que você configure uma política de tratamento de falhas para uma implantação local.

  • Adiciona suporte para um plug-in de spooler de disco.

2.10.3
Correções de erros e melhorias

  • Corrige um problema em que o Greengrass não se inscreve para receber notificações de implantação ao usar o provedor PKCS #11.

2.10.2
Correções de erros e melhorias

  • Permite a análise dos ciclos de vida dos componentes sem distinção entre maiúsculas e minúsculas.

  • Corrige um problema em que a variável PATH do ambiente não foi recriada corretamente.

  • Corrige a codificação de URI de proxy para componentes, incluindo gerenciador de fluxo para nomes de usuário com caracteres especiais.

2.10.1
Correções de erros e melhorias

  • Corrige um problema que poderia causar uma falha na inicialização em determinados processadores ARMv8, incluindo o Jetson Nano.

  • O Greengrass não fecha mais o padrão de um componente, isso reverte o comportamento para o comportamento anterior à 2.10.0

2.10.0
Novos atributos

  • Adiciona interpolateComponentConfiguration suporte para a expressão regular vazia. O Greengrass agora interpola a partir do objeto de configuração raiz.

  • Adiciona suporte para MQTT5.

  • Adiciona um mecanismo para carregar componentes do plug-in rapidamente sem digitalizar.

  • Permite que o Greengrass economize espaço em disco excluindo imagens não utilizadas do Docker.

Correções de erros e melhorias

  • Corrige um problema em que a reversão deixa determinados valores de configuração em vigor a partir de uma implantação.

  • Corrige um problema em que o núcleo do Greengrass valida uma sequência de AWS domínio em terminais de dados e não AWS credenciais personalizados.

  • Atualiza a resolução de dependências de vários grupos para reresolver todas as dependências do grupo por meio de Nuvem AWS negociação, em vez de se restringir à versão ativa. Essa atualização também remove o código de erro de implantaçãoINSTALLED_COMPONENT_NOT_FOUND.

  • Atualiza o núcleo do Greengrass para pular o download de imagens do Docker quando elas já existem localmente.

  • Atualiza o núcleo do Greengrass para reiniciar uma etapa de instalação do componente antes que o tempo limite expire.

  • Pequenas correções e melhorias adicionais.

2.9.6
Correções de erros e melhorias

  • Corrige um problema em que uma implantação do Greengrass falha com o erro LAUNCH_DIRECTORY_CORRUPTED e uma reinicialização subsequente do dispositivo falha ao iniciar o Greengrass. Esse erro pode ocorrer quando você move o dispositivo Greengrass entre vários grupos de coisas com implantações que exigem a reinicialização do Greengrass.

2.9.5
Novos atributos

  • Adiciona suporte à verificação de assinatura do software Greengrass nucleus.

Correções de erros e melhorias

  • Corrige um problema em que uma implantação falha quando a região de metadados da receita local não corresponde à região de lançamento do núcleo Greengrass. O núcleo do Greengrass agora renegocia com a nuvem quando isso acontece.

  • Corrige um problema em que o spooler de mensagens do MQTT é preenchido e nunca remove mensagens.

  • Pequenas correções e melhorias adicionais.

2.9.4
Correções de erros e melhorias

  • Verifica se há uma mensagem nula antes de descartar mensagens de QOS 0.

  • Trunca os valores detalhados do status do trabalho se eles excederem o limite de 1024 caracteres.

  • Atualiza o script de bootstrap para Windows para ler corretamente o caminho raiz do Greengrass se esse caminho incluir espaços.

  • Atualiza a assinatura para AWS IoT Core que ela elimine as mensagens do cliente se a resposta da assinatura não for enviada.

  • Garante que o núcleo carregue sua configuração a partir dos arquivos de backup quando o arquivo de configuração principal estiver corrompido ou ausente.

2.9.3
Correções de erros e melhorias

  • Garante que as IDs do cliente MQTT não sejam duplicadas.

  • Adiciona leitura e gravação de arquivos mais robustas para evitar e se recuperar da corrupção.

  • Tenta novamente o docker image pull em caso de erros específicos relacionados à rede.

  • Adiciona a noProxyAddresses opção de conexão MQTT.

2.9.2
Correções de erros e melhorias

  • Corrige um problema em que a configuração interpolateComponentConfiguration não se aplica a uma implantação contínua.

  • Usa o OSHI para listar todos os processos secundários.

2.9.1
Correções de erros e melhorias

  • Adiciona uma correção em que o Greengrass é reiniciado se uma implantação remover um componente de plug-in.

2.9.0
Novos atributos

  • Adiciona a capacidade de criar subimplantações que repetem implantações com um subconjunto menor de dispositivos. Esse recurso cria uma maneira mais eficiente de testar e resolver implantações malsucedidas.

Correções de erros e melhorias

  • Melhora o suporte para sistemas que não têm useraddgroupadd, usermod e.

  • Pequenas correções e melhorias adicionais.

2.8.1
Correções de erros e melhorias

  • Corrige um problema em que os códigos de erro de implantação não eram gerados corretamente a partir dos erros da API do Greengrass.

  • Corrige um problema em que as atualizações de status da frota enviam informações imprecisas quando um componente atinge um ERRORED estado durante uma implantação.

  • Corrige um problema em que as implantações não podiam ser concluídas quando o Greengrass tinha mais de 50 assinaturas existentes.

2.8.0
Novos atributos
Correções de erros e melhorias

  • Permite que um componente quebrado seja reinstalado quando sua configuração for alterada.

  • Corrige um problema em que a reinicialização do núcleo durante a implantação do bootstrap causa uma falha na implantação.

  • Corrige um problema no Windows em que a instalação falha quando um caminho raiz contém espaços.

  • Corrige um problema em que um componente desligado durante uma implantação usa o script de desligamento da nova versão.

  • Várias melhorias no desligamento.

  • Pequenas correções e melhorias adicionais.

2.7.0
Novos atributos

  • Atualiza o núcleo do Greengrass para enviar atualizações de status para a AWS IoT Greengrass nuvem quando o dispositivo principal aplica uma implantação local.

  • Adiciona suporte para certificados de cliente assinados por uma autoridade de certificação (CA) personalizada, na qual a CA não está registrada AWS IoT. Para usar esse recurso, você pode definir a nova opção greengrassDataPlaneEndpoint de configuração comoiotdata. Para ter mais informações, consulte Use um certificado de dispositivo assinado por uma CA privada.

Correções de erros e melhorias

  • Corrige um problema em que o núcleo do Greengrass reverte uma implantação em determinados cenários quando o núcleo é interrompido ou reiniciado. O núcleo agora retoma a implantação após a reinicialização do núcleo.

  • Atualiza o instalador do Greengrass para respeitar o --start argumento quando você especifica a configuração do software como um serviço do sistema.

  • Atualiza o comportamento de SubscribeToComponentUpdates definir o ID de implantação em eventos em que o núcleo atualizou um componente.

  • Pequenas correções e melhorias adicionais.

2.6.0
Novos atributos

  • Adiciona suporte para curingas MQTT quando você assina tópicos locais de publicação/assinatura. Para obter mais informações, consulte Publique/assine mensagens locais e SubscribeToTopic.

  • Adiciona suporte para variáveis de receita em configurações de componentes, além da variável de component_dependency_name:configuration:json_pointer receita. Você pode usar essas variáveis de receitas ao definir um componente DefaultConfiguration em uma receita ou ao configurar um componente em uma implantação. Para ativar esse recurso, defina a opção de ComponentConfiguration configuração de interpolação como. true Para obter mais informações, consulte Variáveis da receita e Use variáveis de receita em atualizações de mesclagem.

  • Adiciona suporte total ao caractere * curinga nas políticas de autorização de comunicação entre processos (IPC). Agora você pode especificar o * caractere em uma string de recursos para corresponder a qualquer combinação de caracteres. Para ter mais informações, consulte Caracteres curingas nas políticas de autorização.

  • Adiciona suporte para componentes personalizados para chamar operações de IPC que a CLI do Greengrass usa. Você pode usar essas operações de IPC para gerenciar implantações locais, visualizar detalhes do componente e gerar uma senha que pode ser usada para entrar no console de depuração local. Para obter mais informações, consulte IPC: gerenciar implantações e componentes locais.

Correções de erros e melhorias

  • Corrige um problema em que os componentes dependentes não reagiam quando suas dependências rígidas reiniciavam ou mudavam de estado em determinados cenários.

  • Melhora as mensagens de erro que o dispositivo principal reporta ao serviço de AWS IoT Greengrass nuvem quando uma implantação falha.

  • Corrige um problema em que o núcleo do Greengrass aplicava a implantação de uma coisa duas vezes em determinados cenários quando o núcleo era reiniciado.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.5.6
Novos atributos

  • Adiciona suporte para módulos de segurança de hardware que usam chaves ECC. Você pode usar um módulo de segurança de hardware (HSM) para armazenar com segurança a chave privada e o certificado do dispositivo. Para ter mais informações, consulte Integração de segurança de hardware.

Correções de erros e melhorias

  • Corrige um problema em que a implantação nunca é concluída quando você implanta um componente com um script de instalação incorreto em determinados cenários.

  • Melhora o desempenho durante a inicialização.

  • Pequenas correções e melhorias adicionais.

2.5.5
Novos atributos

  • Adiciona a variável de GG_ROOT_CA_PATH ambiente para componentes, para que você possa acessar o certificado de autoridade de certificação (CA) raiz em componentes personalizados.

Correções de erros e melhorias

  • Adiciona suporte para dispositivos Windows que usam um idioma de exibição diferente do inglês.

  • Atualiza como o núcleo do Greengrass analisa os argumentos do instalador booleano, para que você possa especificar um argumento booleano sem um valor booleano para especificar um valor. true Por exemplo, agora você pode especificar, --provision em vez de --provision true instalar, com o provisionamento automático de recursos.

  • Corrige um problema em que o dispositivo principal não reportava seu status ao serviço de AWS IoT Greengrass nuvem após o provisionamento em determinados cenários.

  • Pequenas correções e melhorias adicionais.

2.5.4
Correções de erros e melhorias

  • Melhorias e correções de erros gerais.

2.5.3
Novos atributos

  • Adiciona suporte para integração de segurança de hardware. Você pode usar um módulo de segurança de hardware (HSM) para armazenar com segurança a chave privada e o certificado do dispositivo. Para ter mais informações, consulte Integração de segurança de hardware.

Correções de erros e melhorias

  • Corrige um problema com exceções de tempo de execução enquanto o núcleo estabelece conexões MQTT com o. AWS IoT Core

2.5.2
Correções de erros e melhorias

  • Corrige um problema em que, após as atualizações do núcleo do Greengrass, o serviço Windows não é iniciado novamente depois que você o interrompe ou reinicializa o dispositivo.

2.5.1
Atenção

Essa versão não está mais disponível. As melhorias nesta versão estão disponíveis em versões posteriores desse componente.

Correções de erros e melhorias

  • Adiciona suporte para versões de 32 bits do Java Runtime Environment (JRE) no Windows.

  • Altera o comportamento de remoção de grupos de coisas para dispositivos principais cuja AWS IoT política não concede a greengrass:ListThingGroupsForCoreDevice permissão. Com essa versão, a implantação continua, registra um aviso e não remove componentes quando você remove o dispositivo principal de um grupo de coisas. Para ter mais informações, consulte Implemente AWS IoT Greengrass componentes em dispositivos.

  • Corrige um problema com as variáveis de ambiente do sistema que o núcleo do Greengrass disponibiliza para os processos de componentes do Greengrass. Agora você pode reiniciar um componente para que ele use as variáveis de ambiente do sistema mais recentes.

2.5.0
Novos atributos

  • Adiciona suporte para dispositivos principais que executam o Windows.

  • Mude o comportamento da remoção de grupos de coisas. Com essa versão, você pode remover um dispositivo principal de um grupo de coisas para desinstalar os componentes desse grupo de coisas na próxima implantação.

    Como resultado dessa alteração, a AWS IoT política de um dispositivo principal deve ter a greengrass:ListThingGroupsForCoreDevice permissão. Se você usou o instalador do software AWS IoT Greengrass Core para provisionar recursos, a AWS IoT política padrão permitegreengrass:*, o que inclui essa permissão. Para ter mais informações, consulte Autorização e autenticação do dispositivo para o AWS IoT Greengrass.

  • Adiciona suporte para configurações de proxy HTTPS. Para ter mais informações, consulte Conectar-se à porta 443 ou por meio de um proxy de rede.

  • Adiciona o novo parâmetro windowsUser de configuração. Você pode usar esse parâmetro para especificar o usuário padrão a ser usado para executar componentes em um dispositivo principal do Windows. Para ter mais informações, consulte Configurar o usuário que executa os componentes.

  • Adiciona as novas opções de httpClient configuração que você pode usar para personalizar os tempos limite de solicitação HTTP para melhorar o desempenho em redes lentas. Para obter mais informações, consulte o parâmetro de configuração HttpClient.

Correções de erros e melhorias

  • Corrige a opção de ciclo de vida do bootstrap para reiniciar o dispositivo principal a partir de um componente.

  • Adiciona suporte para hífens nas variáveis da receita.

  • Corrige a autorização de IPC para componentes da função Lambda sob demanda.

  • Melhora as mensagens de registro e altera os registros não críticos de INFO um para DEBUG outro, então os registros são mais úteis.

  • Remove a iot:DescribeCertificate permissão da função padrão de troca de tokens que o núcleo do Greengrass cria quando você instala o software AWS IoT Greengrass Core com provisionamento automático. Essa permissão não é usada pelo núcleo Greengrass.

  • Corrige um problema para que o script de provisionamento automático não exija a iam:GetPolicy permissão se iam:CreatePolicy estiver disponível para a mesma política.

  • Pequenas correções e melhorias adicionais.

2.4.0
Novos atributos
Correções de erros e melhorias

  • Atualiza a configuração de registro na inicialização. Isso corrige um problema em que a configuração de registro não foi aplicada na inicialização.

  • Atualiza o link simbólico do carregador de núcleo para apontar para o armazenamento de componentes na pasta raiz do Greengrass durante a instalação. Essa atualização permite que você exclua o arquivo JAR e outros artefatos do núcleo que você baixa ao instalar o software AWS IoT Greengrass Core.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.3.0
Novos atributos

  • Adiciona a variável da iot:thingName receita. Você pode usar essa variável de receita para obter o nome do dispositivo AWS IoT principal em uma receita. Para ter mais informações, consulte Variáveis da receita.

Correções de erros e melhorias

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.2.0
Novos atributos

  • Adiciona operações de IPC para gerenciamento local de sombras.

Correções de erros e melhorias

  • Reduz o tamanho do arquivo JAR.

  • Reduz o uso da memória.

  • Corrige problemas em que a configuração do log não foi atualizada em certos casos.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.1.0
Novos atributos

  • Suporta o download de imagens do Docker de repositórios privados no Amazon ECR.

  • Adiciona os seguintes parâmetros para personalizar a configuração do MQTT nos dispositivos principais:

    • maxInFlightPublishes— O número máximo de mensagens de QoS 1 não confirmadas do MQTT que podem estar em andamento ao mesmo tempo.

    • maxPublishRetry— O número máximo de vezes para repetir uma mensagem que não foi publicada.

  • Adiciona o parâmetro de fleetstatusservice configuração para configurar o intervalo no qual o dispositivo principal publica o status do dispositivo no Nuvem AWS.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

Correções de erros e melhorias

  • Corrige um problema que fazia com que as implantações de sombra fossem duplicadas quando o núcleo era reiniciado.

  • Corrige um problema que fazia com que o núcleo falhasse ao encontrar uma exceção de carga de serviço.

  • Melhora a resolução de dependências de componentes para falhar em uma implantação que inclui uma dependência circular.

  • Corrige um problema que impedia que um componente de plug-in fosse reimplantado se esse componente tivesse sido removido anteriormente do dispositivo principal.

  • Corrija um problema que fazia com que a variável de HOME ambiente fosse definida no /greengrass/v2/work diretório dos componentes do Lambda ou dos componentes executados como raiz. Agora, a HOME variável está definida corretamente no diretório inicial do usuário que executa o componente.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.0.5
Correções de erros e melhorias

  • Roteia corretamente o tráfego por meio de um proxy de rede configurado ao baixar os componentes AWS fornecidos.

  • Use o endpoint correto do plano de dados Greengrass nas AWS regiões da China.

2.0.4
Novos atributos

  • Habilita o tráfego HTTPS pela porta 443. Você pode usar o novo parâmetro de greengrassDataPlanePort configuração da versão 2.0.4 do componente nucleus para configurar a comunicação HTTPS para viajar pela porta 443 em vez da porta padrão 8443. Para ter mais informações, consulte Configurar HTTPS pela porta 443.

  • Adiciona a variável de receita do caminho de trabalho. Você pode usar essa variável de receita para obter o caminho para as pastas de trabalho dos componentes, que você pode usar para compartilhar arquivos entre componentes e suas dependências. Para obter mais informações, consulte a variável de receita do caminho de trabalho.

Correções de erros e melhorias

  • Impede a criação da política de função de troca de tokens AWS Identity and Access Management (IAM) se uma política de função já existir.

    Como resultado dessa alteração, o instalador agora exige o iam:GetPolicy e sts:GetCallerIdentity quando executado com--provision true. Para ter mais informações, consulte Política mínima de IAM para o instalador provisionar recursos.

  • Lida corretamente com o cancelamento de uma implantação que ainda não foi registrada com sucesso.

  • Atualiza a configuração para remover entradas mais antigas com carimbos de data/hora mais recentes ao reverter uma implantação.

  • Pequenas correções e melhorias adicionais. Para obter mais informações, consulte os lançamentos em GitHub.

2.0.3

Versão inicial.