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 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. **nota** A partir da versão 2.14.0 do Greengrass, uma versão otimizada para uso de memória do runtime do dispositivo do nucleus está disponível para dispositivos de borda restritos. Consulte [Greengrass nucleus lite](https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-lite-component.html) para obter mais informações sobre sua configuração e uso. **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 núcleo, podem fazer com que seus dispositivos sejam reiniciados inesperadamente. Para evitar atualizações não intencionais para um componente que está sendo executado no dispositivo, recomendamos que você inclua diretamente sua versão preferida desse componente ao [criar uma implantação](create-deployments.md). Para obter mais informações sobre o comportamento de atualização AWS IoT Greengrass do software Core, consulte[Atualizar o software de núcleo do AWS IoT Greengrass (OTA)](update-greengrass-core-v2.md). **Topics** + [Versões](#greengrass-nucleus-component-versions) + [Requisitos do dispositivo](#greengrass-v2-requirements) + [Plataformas compatíveis](#greengrass-v2-supported-platforms) + [Sistema operacional](#greengrass-nucleus-component-os-support) + [Requisitos](#greengrass-nucleus-component-requirements) + [Dependências](#greengrass-nucleus-component-dependencies) + [Download e instalação](#greengrass-nucleus-component-install) + [Configuração](#greengrass-nucleus-component-configuration) + [Arquivo de log local](#greengrass-nucleus-component-log-file) + [Changelog](#greengrass-nucleus-component-changelog) ## Versões Esse componente tem as seguintes versões: + 2,16.x + 2,15x + 2,14.x + 2.13.x + 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 ## Requisitos do dispositivo **nota** Você pode usar AWS IoT Device Tester for AWS IoT Greengrass para verificar se seu dispositivo pode executar o software AWS IoT Greengrass Core e se comunicar com Nuvem AWS o. Para obter mais informações, consulte [Como usar o AWS IoT Device Tester para o AWS IoT Greengrass V2](device-tester-for-greengrass-ug.md). ------ #### [ Linux ] + O uso de um [Região da AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)que suporte AWS IoT Greengrass V2. Para obter a lista de regiões compatíveis, consulte [Endpoints e cotas do AWS IoT Greengrass V2](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) no *Referência geral da AWS*. + Espaço mínimo de 256 MB em disco disponível para o software AWS IoT Greengrass Core. Esse requisito não inclui os componentes implantados no dispositivo principal. + Mínimo de 96 MB de RAM alocados para o software AWS IoT Greengrass Core. Esse requisito não inclui os componentes executados no dispositivo principal. Para obter mais informações, consulte [Controlar a alocação de memória com opções de JVM](configure-greengrass-core-v2.md#jvm-tuning). + Ambiente de Execução Java (JRE) versão 8 ou superior. O Java deve estar disponível na variável de ambiente [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) no dispositivo. Para usar o Java para desenvolver componentes personalizados, é necessário instalar um Java Development Kit (JDK). Recomendamos que você use as versões de suporte de longo prazo do [Amazon Corretto](https://aws.amazon.com/corretto/) ou do [OpenJDK](https://openjdk.java.net/). A versão 8 ou superior é obrigatória. + [Biblioteca do GNU C](https://www.gnu.org/software/libc/) (glibc) versão 2.25 ou superior. + Você deve executar o software AWS IoT Greengrass Core como usuário root. Por exemplo, use o `sudo`. + O usuário root que executa o software AWS IoT Greengrass Core, por exemplo`root`, deve ter permissão para executar `sudo` com qualquer usuário e qualquer grupo. O arquivo `/etc/sudoers` deve dar permissão a esse usuário para executar o `sudo` como outros grupos. A permissão para o usuário em `/etc/sudoers` deve ser semelhante à do exemplo a seguir. ``` root ALL=(ALL:ALL) ALL ``` + O dispositivo principal deve conseguir fazer solicitações de saída para um conjunto de endpoints e portas. Para obter mais informações, consulte [Permitir o tráfego de dispositivos por meio de um proxy ou firewall](allow-device-traffic.md). + É necessário montar o diretório `/tmp` com as permissões `exec`. + Todos os seguintes comandos de shell: + `ps -ax -o pid,ppid` + `sudo` + `sh` + `kill` + `cp` + `chmod` + `rm` + `ln` + `echo` + `exit` + `id` + `uname` + `grep` + Seu dispositivo também pode exigir os seguintes comandos de shell opcionais: + (Opcional) `systemctl`. Esse comando é usado para configurar o software de núcleo do AWS IoT Greengrass como um serviço do sistema. + (Opcional) `useradd`, `groupadd` e `usermod`. Esses comandos são usados para configurar o usuário `ggc_user` e o grupo `ggc_group` do sistema. + (Opcional) `mkfifo`. Esse comando é usado para executar funções do Lambda como componentes. + Para configurar os limites de recursos do sistema para processos de componentes, o dispositivo deve executar o kernel do Linux versão 2.6.24 ou mais recente. + Para executar as funções do Lambda, o dispositivo deve atender a requisitos adicionais. Para obter mais informações, consulte [Requisitos da função do Lambda](setting-up.md#greengrass-v2-lambda-requirements). ------ #### [ Windows ] + O uso de um [Região da AWS](https://en.wikipedia.org/wiki/Amazon_Web_Services#Availability_and_topology)que suporte AWS IoT Greengrass V2. Para obter a lista de regiões compatíveis, consulte [Endpoints e cotas do AWS IoT Greengrass V2](https://docs.aws.amazon.com/general/latest/gr/greengrassv2.html) no *Referência geral da AWS*. + Espaço mínimo de 256 MB em disco disponível para o software AWS IoT Greengrass Core. Esse requisito não inclui os componentes implantados no dispositivo principal. + Mínimo de 160 MB de RAM alocados para o software AWS IoT Greengrass Core. Esse requisito não inclui os componentes executados no dispositivo principal. Para obter mais informações, consulte [Controlar a alocação de memória com opções de JVM](configure-greengrass-core-v2.md#jvm-tuning). + Ambiente de Execução Java (JRE) versão 8 ou superior. O Java deve estar disponível na variável de sistema [PATH](https://en.wikipedia.org/wiki/PATH_(variable)) no dispositivo. Para usar o Java para desenvolver componentes personalizados, é necessário instalar um Java Development Kit (JDK). Recomendamos que você use as versões de suporte de longo prazo do [Amazon Corretto](https://aws.amazon.com/corretto/) ou do [OpenJDK](https://openjdk.java.net/). A versão 8 ou superior é obrigatória. **nota** Para usar a versão 2.5.0 do [Greengrass nucleus](#greengrass-nucleus-component), é necessário usar uma versão de 64 bits do Ambiente de Execução Java (JRE). A versão 2.5.1 do Greengrass nucleus oferece suporte a 32 bits e 64 bits. JREs + O usuário que instala o software AWS IoT Greengrass Core deve ser um administrador. + Você deve instalar o software AWS IoT Greengrass Core como um serviço do sistema. Especifique `--setup-system-service true` quando você instalar o software. + Cada usuário que executa processos de componentes deve existir na LocalSystem conta, e o nome e a senha do usuário devem estar na instância do Credential Manager da LocalSystem conta. Você pode configurar esse usuário seguindo as instruções para [instalar o software AWS IoT Greengrass Core](install-greengrass-core-v2.md). + O dispositivo principal deve conseguir fazer solicitações de saída para um conjunto de endpoints e portas. Para obter mais informações, consulte [Permitir o tráfego de dispositivos por meio de um proxy ou firewall](allow-device-traffic.md). ------ ## Plataformas compatíveis AWS IoT Greengrass suporta oficialmente dispositivos que executam as seguintes plataformas. Dispositivos com plataformas não incluídas nessa lista podem funcionar, mas AWS IoT Greengrass testes somente nessas plataformas especificadas. ------ #### [ Linux ] Arquiteturas: + Armv7l + Armv (8) AArch64 + x86\$164 ------ #### [ Windows ] Arquiteturas: + x86\$164 Versões: + Windows 10 + Windows 11 + Windows Server 2019 + Windows Server 2022 **nota** No momento, alguns AWS IoT Greengrass recursos não são compatíveis com dispositivos Windows. Para obter mais informações, consulte [Compatibilidade de recursos do Greengrass](operating-system-feature-support-matrix.md) e [Considerações sobre recursos](#greengrass-v2-windows-feature-considerations). ------ ### Considerações sobre recursos No momento, alguns AWS IoT Greengrass recursos não são compatíveis com dispositivos Windows. Avalie as diferenças dos recursos para confirmar se um dispositivo Windows atende aos seus requisitos. Para obter mais informações, consulte [Compatibilidade de recursos do Greengrass](operating-system-feature-support-matrix.md). [Para criar um sistema operacional personalizado baseado em Linux, você pode usar a BitBake receita AWS IoT Greengrass do projeto. `meta-aws`](https://github.com/aws/meta-aws/tree/master/recipes-iot) O `meta-aws` projeto fornece receitas que você pode usar para criar recursos de software de AWS ponta em sistemas [Linux embarcados](https://elinux.org/) que são construídos com [OpenEmbedded](https://www.openembedded.org/wiki/Main_Page)as estruturas de construção do Projeto Yocto. O [Yocto Project](https://www.yoctoproject.org/) é um projeto de colaboração de código aberto que ajuda você a construir sistemas personalizados baseados em Linux para aplicações incorporadas, seja qual for a arquitetura do hardware. A BitBake receita para AWS IoT Greengrass instalar, configurar e executar automaticamente o software AWS IoT Greengrass Core em seu dispositivo. As plataformas Linux também podem ser executadas AWS IoT Greengrass em um contêiner Docker. Para obter mais informações, consulte [Execute AWS IoT Greengrass o software Core em um contêiner Docker](run-greengrass-docker.md). ## Sistema operacional Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais: + Linux + Windows Para obter mais informações, consulte [Plataformas compatíveis](#greengrass-v2-supported-platforms). ## Requisitos Os dispositivos devem atender a certos requisitos para instalar e executar o núcleo Greengrass e o AWS IoT Greengrass software Core. Para obter mais informações, consulte [Requisitos do dispositivo](#greengrass-v2-requirements). 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 componente do núcleo do Greengrass deve ter conectividade com AWS IoT data, AWS IoT Credentials e Amazon S3. ## Dependências O Greengrass nucleus não inclui nenhuma dependência de componente. No entanto, vários componentes fornecidos pela AWS incluem o núcleo como uma dependência. Para obter mais informações, consulte [Componentes fornecidos pela AWS](public-components.md). Para obter mais informações sobre as dependências dos componentes, consulte [referência de fórmula do componente](component-recipe-reference.md#recipe-reference-component-dependencies). ## Download e instalação É possível baixar um instalador que configura o componente do Greengrass nucleus no dispositivo. Esse instalador configura o 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 obter mais informações, consulte [Instalar o software do AWS IoT Greengrass Core](install-greengrass-core-v2.md). Também é possível seguir um tutorial para instalar o Greengrass nucleus e explorar o desenvolvimento de componentes do Greengrass. Para obter mais informações, consulte [Tutorial: Conceitos básicos do AWS IoT Greengrass V2](getting-started.md). ## Configuração Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente. Alguns parâmetros exigem que o software AWS IoT Greengrass Core seja reiniciado para entrar em vigor. Para mais informações sobre essa configuração, consulte [Configurar o software AWS IoT Greengrass principal](configure-greengrass-core-v2.md). `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 [Autorize os dispositivos principais a interagir com os serviços AWS](device-service-role.md). 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) É possível habilitar o Greengrass nucleus para interpolar [variáveis de fórmulas de componentes](component-recipe-reference.md#recipe-variables) em configurações de componentes e [mesclar atualizações de configuração](update-component-configurations.md#merge-configuration-update-recipe-variables). Recomendamos que você defina essa opção para `true` para que o dispositivo principal possa executar componentes do Greengrass que usam variáveis de fórmula nas configurações. Esse recurso está disponível para a versão v2.6.0 e posterior do componente. Padrão: `false` `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](configure-greengrass-core-v2.md#configure-alpn-network-proxy). 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: `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 `scheme://userinfo@host:port`. + `scheme`: o esquema, que deve ser `http` ou `https`. **Importante** Os dispositivos do Greengrass nucleus devem executar o [Greengrass nucleus](#greengrass-nucleus-component) v2.5.0 ou posterior para usar proxies HTTPS. Se você configurar um proxy HTTPS, deverá adicionar o certificado de CA do servidor proxy ao certificado de CA raiz da Amazon do dispositivo principal. Para obter mais informações, consulte [Ative o dispositivo principal para confiar em um proxy HTTPS](configure-greengrass-core-v2.md#https-proxy-certificate-trust). + `userinfo`: (opcional) as informações de nome de usuário e senha. Se você especificar essas informações no `url`, o dispositivo principal do Greengrass ignorará os campos `username` e `password`. + `host`: o nome do host ou endereço IP do servidor de proxy. + `port`: (opcional) o número da porta. Se você não especifica a porta, o dispositivo principal do Greengrass usa os seguintes valores padrão: + `http`: 80 + `https`: 443 `username` (Opcional) O nome de usuário que autentica o servidor de proxy. `password` (Opcional) A senha que autentica o servidor de proxy. `mqtt` (Opcional) A configuração MQTT para o dispositivo principal do Greengrass. Para obter mais informações, consulte [Conectar-se à porta 443 ou por meio de um proxy de rede](configure-greengrass-core-v2.md#configure-alpn-network-proxy). 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: `port` (Opcional) A porta que deve ser usada para conexões MQTT. Padrão: `8883` `keepAliveTimeoutMs` (Opcional) A quantidade de tempo em milissegundos entre cada mensagem `PING` que o cliente envia para manter a conexão MQTT ativa. Este valor deve ser maior que `pingTimeoutMs`. Padrão: `60000` (60 segundos) `pingTimeoutMs` (Opcional) A quantidade de tempo em milissegundos que o cliente espera para receber uma mensagem `PINGACK` do servidor. Se a espera exceder o tempo limite, o dispositivo principal fecha e reabre a conexão MQTT. Esse valor deve ser menor que `keepAliveTimeoutMs`. Padrão: `30000` (30 segundos) `operationTimeoutMs` (Opcional) A quantidade de tempo em milissegundos que o cliente espera para que as operações do MQTT (como `CONNECT` ou `PUBLISH`) sejam concluídas. Essa opção não se aplica ao `PING` do MQTT nem a mensagens de manutenção. Padrão: `30000` (30 segundos) `maxInFlightPublishes` (Opcional) O número máximo de mensagens MQTT1 não confirmadas que podem estar em andamento ao mesmo tempo. Este atributo está disponível para a versão v2.1.0 e posterior deste 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 excede esse tamanho, o Greengrass nucleus a rejeita com um erro. Este atributo está disponível para a versão v2.1.0 e posterior deste componente. Padrão: `131072` (128 KB) Intervalo válido: valor máximo `2621440` (2.5 MB) `maxPublishRetry` (Opcional) O número máximo de tentativas de enviar uma mensagem que não foi publicada. É possível especificar `-1` para tentar ilimitadas vezes. Este atributo está disponível para a versão v2.1.0 e posterior deste componente. Padrão: `100` `spooler` (Opcional) A configuração do spooler MQTT para o dispositivo do Greengrass nucleus. Esse objeto contém as informações a seguir: `storageType` O tipo de armazenamento usado para armazenar mensagens. Se o `storageType` estiver definido como `Disk`, o `pluginName` pode ser configurado. É possível especificar `Memory` ou `Disk`. Este atributo está disponível para a versão v2.11.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). Se o `storageType` do spooler MQTT estiver definido como `Disk` e você quiser fazer o downgrade do Greengrass nucleus da versão 2.11.x para uma versão anterior, será preciso alterar a configuração novamente para `Memory`. A única configuração do `storageType` compatível com as versões 2.10.x e anteriores do Greengrass nucleus é a `Memory`. Não seguir essas orientações pode resultar em erros do spooler. Isso faria com que o dispositivo principal do Greengrass não conseguisse enviar mensagens MQTT para a Nuvem AWS. Padrão: `Memory` `pluginName` (Opcional) O nome do componente do plug-in. Esse componente só será usado se o `storageType` estiver definido como `Disk`. Essa opção é padronizada para `aws.greengrass.DiskSpooler` e usará o[Spooler de disco](disk-spooler-component.md) fornecido pelo Greengrass. Este atributo está disponível para a versão v2.11.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). Padrão: `"aws.greengrass.DiskSpooler"` `maxSizeInBytes` (Opcional) O tamanho máximo do cache em que o dispositivo do núcleo armazena mensagens MQTT não processadas na memória. Se o cache está cheio, novas mensagens são rejeitadas. Padrão: `2621440` (2.5 MB) `keepQos0WhenOffline` (Opcional) É possível transferir mensagens QoS 0 do MQTT que o dispositivo principal recebe enquanto está offline. Se você definir essa opção como `true`, o dispositivo principal armazenará mensagens QoS 0 que ele não pode enviar enquanto estiver offline. Se você definir essa opção como `false`, o dispositivo principal descartará essas mensagens. O dispositivo principal sempre armazena mensagens QoS 1, a menos que a transferência esteja cheia. Padrão: `false` `version` (Opcional) A versão do MQTT. É possível especificar `mqtt3` ou `mqtt5`. Esse recurso está disponível para a versão 2.10.0 e posterior do [componente de Greengrass nucleus](#greengrass-nucleus-component). Padrão: `mqtt5` `receiveMaximum` (Opcional) O número máximo de pacotes QoS1 não reconhecidos que o operador pode enviar. Esse atributo está disponível para a versão 2.10.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). Padrão: `100` `sessionExpirySeconds` (Opcional) A quantidade de tempo em segundos que pode ser solicitada 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 de Greengrass nucleus](#greengrass-nucleus-component). 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 reconectar. Esse atributo está disponível para a versão 2.10.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). Padrão: `1` `maximumReconnectDelaySeconds` (Opcional) Uma opção para o comportamento de reconexão. O tempo máximo em segundos para o MQTT reconectar. Esse atributo está disponível para a versão 2.10.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). Padrão: `120` `minimumConnectedTimeBeforeRetryResetSeconds` (Opcional) Uma opção para o comportamento de reconexão. O tempo, em segundos, durante o qual a conexão deve estar ativa antes que o atraso na tentativa seja redefinido ao mínimo. Esse atributo está disponível para a versão 2.10.0 e posterior do [componente de núcleo do Greengrass](#greengrass-nucleus-component). 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. [Controlar a alocação de memória com opções de JVM](configure-greengrass-core-v2.md#jvm-tuning) 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` Este atributo está disponível para a versão v2.7.0 e posterior deste componente. Para obter mais informações, consulte [Usar um certificado de dispositivo assinado por uma CA privada](configure-greengrass-core-v2.md#configure-nucleus-private-ca). `greengrassDataPlanePort` Esse atributo está disponível na versão 2.0.4 e posteriores. (Opcional) A porta usada para conexões de plano de dados. Para obter mais informações, consulte [Conectar-se à porta 443 ou por meio de um proxy de rede](configure-greengrass-core-v2.md#configure-alpn-network-proxy). 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. 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 núcleo usa para executar componentes genéricos e do 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 obter mais informações, consulte [Configurar o usuário que executa os componentes](configure-greengrass-core-v2.md#configure-component-user). 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` Este atributo está disponível para a versão v2.5.0 e posterior deste 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 obter mais informações, consulte [Configurar o usuário que executa os componentes](configure-greengrass-core-v2.md#configure-component-user). 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 atributo está disponível na versão 2.4.0 e posteriores deste componente. O AWS IoT Greengrass atualmente não é compatível com esse recurso nos dispositivos principais do Windows. Por padrão, os limites de recursos do sistema devem ser aplicados a processos de componentes do Lambda genéricos e não conteinerizados. É possível substituir os limites de recursos do sistema para componentes individuais ao criar uma implantação. Para obter mais informações, consulte [Configurar limites de recursos do sistema para componentes](configure-greengrass-core-v2.md#configure-component-system-resource-limits). Esse objeto contém as informações a seguir: `cpus` A quantidade máxima de tempo da CPU que os processos de um 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 quatro núcleos da CPU, você pode definir esse valor como `2` a fim de limitar os processos do componente para 50% de uso em cada núcleo da CPU. Em um dispositivo com um núcleo da CPU, você pode definir esse valor como `0.25` a fim de limitar os processos do componente para 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, expressa em kilobytes, que os processos de um componente podem usar no dispositivo principal. `s3EndpointType` (Opcional) O tipo de endpoint do S3. Esse parâmetro só terá efeito para a região Leste dos EUA, N. da Virgínia (`us-east-1`). A configuração desse parâmetro em qualquer outra região será ignorada. Escolha uma das seguintes opções: + `REGIONAL`: o cliente do S3 e o URL pré-assinado usam o endpoint regional. + `GLOBAL`: o cliente do S3 e o URL pré-assinado usam o endpoint legado. + `DUALSTACK`: o URL pré-assinado do S3 usa o endpoint de pilha dupla. Padrão: `GLOBAL` `fipsMode` (Opcional) Faz com que o Greengrass use endpoints do FIPS. Para mais informações sobre como habilitar endpoints do FIPS, consulte [endpoints do FIPS](FIPS.html). Escolha uma das seguintes opções: + `true` Quando definido como verdadeiro, os endpoints usarão o endpoint do FIPS. + `false` Quando definido como falso, os endpoints usarão o endpoint do FIPS. Padrão: `false` `logging` (Opcional) A configuração do registro em log do dispositivo principal. Para mais informações sobre como configurar e usar registros em log do Greengrass, consulte [Monitore AWS IoT Greengrass logs](monitor-logs.md). Esse objeto contém as informações a seguir: `level` (Opcional) O nível mínimo de mensagens de log a serem enviadas. Escolha entre os seguintes níveis de log, ordenados por nível: + `DEBUG` + `INFO` + `WARN` + `ERROR` Padrão: `INFO` `format` (Opcional) O formato de dados dos logs. Escolha uma das seguintes opções: + `TEXT`: escolha essa opção se quiser visualizar os logs em formato de texto. + `JSON`: escolha essa opção se quiser visualizar os logs com o [comando de logs da CLI do Greengrass](gg-cli-logs.md) ou interagir com os logs de forma programática. Padrão: `TEXT` `outputType` (Opcional) O tipo de saída para logs. 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 em`stdout`. Escolha essa opção para ver os logs à 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 só se aplica quando você especifica `FILE` para `outputType`. Padrão: `1024` `totalLogsSizeKB` (Opcional) O tamanho total máximo dos arquivos de log (em kilobytes) para cada componente, incluindo o Greengrass nucleus. Os arquivos de log do Greengrass nucleus também incluem logs de [componentes de plug-ins](develop-greengrass-components.md#component-types). 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](log-manager-component.md#log-manager-component-configuration) (`diskSpaceLimit`) do [componente gerenciador de log](log-manager-component.md), que você pode especificar para o Greengrass nucleus (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 só se aplica quando você especifica `FILE` para `outputType`. Padrão: `10240` `outputDirectory` (Opcional) O diretório de saída para os arquivos de log. Esse parâmetro só se aplica quando você especifica `FILE` para `outputType`. Padrão:`/greengrass/v2/logs`, em que `/greengrass/v2` é a pasta raiz do AWS IoT Greengrass . `fleetstatus` Este parâmetro está disponível para a versão v2.1.0 e posterior deste componente. (Opcional) A configuração do status da frota do dispositivo principal. Esse objeto contém as informações a seguir: `periodicStatusPublishIntervalSeconds` (Opcional) A quantidade de tempo (em segundos) entre o qual o dispositivo principal publica o status do dispositivo para a 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 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](telemetry.md). Esse objeto contém as informações a seguir: `enabled` (Opcional) É possível habilitar ou desabilitar 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 mínimo compatível, o núcleo usará o valor padrão em vez disso. Mínimo: `3600` Padrão: `3600` `periodicPublishMetricsIntervalSeconds` (Opcional) o tempo (em segundos) durante o qual o dispositivo principal publica métricas de telemetria para a Nuvem AWS. Se você definir esse valor abaixo do mínimo compatível, 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 fórmulas 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 fórmulas de componentes podem usar para identificar o ciclo de vida e os artefatos corretos do componente. Por exemplo, é possível definir um atributo de capacidade de hardware para implantar somente o conjunto mínimo de artefatos para execução de um componente. Para mais informações, consulte o [parâmetro da plataforma de manifesto](component-recipe-reference.md#component-platform-definition) na fórmula do componente. Você também pode usar esse parâmetro para substituir os atributos da plataforma `os` e `architecture` do dispositivo principal. `httpClient` Este parâmetro está disponível para a versão v2.5.0 e posterior deste 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 pelo componente. Se um dispositivo principal for executado em uma rede mais lenta, será possível aumentar essas durações de tempo limite para evitar que as solicitações HTTP atinjam o limite. Esse objeto contém as informações a seguir: `connectionTimeoutMs` (Opcional) o tempo (em milissegundos) necessário para aguardar a abertura de uma conexão antes que o tempo da solicitação de conexão expire. Padrão: `2000` (2 segundos) `socketTimeoutMs` (Opcional) A quantidade de tempo (em milissegundos) de espera para que os dados sejam transferidos por uma conexão aberta antes que o tempo limite da conexão seja atingido. Padrão: `30000` (30 segundos) `deploymentConfigurationTimeSource` Esse parâmetro está disponível na versão 2.15.0 e posterior desse componente. (Opcional) O carimbo de data/hora a ser usado ao processar uma implantação. O padrão é o `deploymentCreationTime`. Este objeto contém os valores a seguir: `deploymentCreationTime` O valor padrão de `deploymentConfigurationTimeSource`. O dispositivo usa o carimbo de data/hora de criação da implantação para resolver conflitos de chave de configuração durante o processamento. Quando esse comportamento é selecionado, a configuração do dispositivo local mantida pelo nucleus pode ter um registro de data e hora maior do que o da implantação de entrada e rejeita as alterações de configuração recebidas que agora são consideradas desatualizadas. `deploymentProcessingTime` O dispositivo usa seu carimbo de data/hora local para resolver conflitos de chave de configuração durante o processamento da implantação. Quando processado, o dispositivo atualiza as configurações com base no carimbo de data/hora de processamento em vez do carimbo de data/hora de criação da implantação. Esse comportamento pressupõe que o relógio do dispositivo esteja calibrado corretamente. Defina essa configuração do nucleus na imagem ou instalação inicial do dispositivo, em vez de por meio de uma implantação, quando quiser que novos dispositivos usem esse comportamento na primeira conexão. Use a opção [https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html](https://docs.aws.amazon.com/greengrass/v2/developerguide/configure-installer.html) do instalador do nucleus classic para essa configuração. Essa configuração inicial é essencial porque os dispositivos processam várias implantações em ordem arbitrária. Sem a configuração inicial adequada, um dispositivo pode processar implantações usando o comportamento padrão `deploymentCreationTime` antes de receber a implantação que define a configuração do nucleus como `deploymentProcessingTime`. **Example Exemplo: atualização da mesclagem de configuração** ``` { "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 arquivo de log abaixo. ------ #### [ Linux ] ``` /greengrass/v2/logs/greengrass.log ``` ------ #### [ Windows ] ``` C:\greengrass\v2\logs\greengrass.log ``` ------ **Para exibir os logs 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:\$1greengrass\$1v2* 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. | **Versão** | **Alterações** | | --- | --- | | 2.16.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.16.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.15.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.15.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.3 | Correções de bugs e melhorias [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.2 | Correções de bugs e melhorias [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.1 | Correções de bugs e melhorias [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.14.0 | Esta versão não está mais disponível. As melhorias nesta versão estão disponíveis em versões posteriores desse componente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.13.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.3 | Esta 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 bugs e melhorias [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.12.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.11.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.10.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.9.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.8.1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.8.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.7.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.6.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.6 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.3 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.1 | Esta versão não está mais disponível. As melhorias nesta versão estão disponíveis em versões posteriores desse componente. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.5.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.4.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.3.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.2.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.1.0 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.5 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.4 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/greengrass-nucleus-component.html) | | 2.0.3 | Versão inicial. |