Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). 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á. # Módulo 2: Instalação do software AWS IoT Greengrass principal Este módulo mostra como instalar o software AWS IoT Greengrass Core no dispositivo escolhido. Neste módulo, você primeiramente cria um grupo e um núcleo do Greengrass. Depois, você faz download, configura e inicia o software no dispositivo de núcleo. Para obter mais informações sobre a funcionalidade do software AWS IoT Greengrass Core, consulte [Configurar o AWS IoT Greengrass núcleo](gg-core.md). Antes de começar, certifique-se de ter concluído as etapas de configuração no [Módulo 1](module1.md) para o dispositivo escolhido. **dica** AWS IoT Greengrass também fornece outras opções para instalar o software AWS IoT Greengrass Core. Por exemplo, você pode usar a [configuração do dispositivo Greengrass](quick-start.md) para configurar seu ambiente e instalar a versão mais recente do software AWS IoT Greengrass Core. Ou, em plataformas Debian suportadas, você pode usar o [gerenciador de pacotes APT](install-ggc.md#ggc-package-manager) para instalar ou atualizar o software AWS IoT Greengrass Core. Para obter mais informações, consulte [Instale o software AWS IoT Greengrass Core](install-ggc.md). Este módulo deve demorar menos de 30 minutos para ser concluído. **Topics** + [Provisione qualquer AWS IoT coisa para usar como um núcleo do Greengrass](provision-core.md) + [Crie um AWS IoT Greengrass grupo para o núcleo](create-group.md) + [Instale e execute AWS IoT Greengrass no dispositivo principal](start-greengrass.md) # Provisione qualquer AWS IoT coisa para usar como um núcleo do Greengrass Os *núcleos* do Greengrass são dispositivos que executam o software AWS IoT Greengrass Core para gerenciar processos locais de IoT. Para configurar um núcleo do Greengrass, você cria uma AWS IoT *coisa* que representa um dispositivo ou entidade lógica que se conecta a AWS IoT. Quando você registra um dispositivo como uma AWS IoT coisa, esse dispositivo pode usar um certificado digital e chaves que permitem seu acesso AWS IoT. Você usa uma [AWS IoT política](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policies.html) para permitir que o dispositivo se comunique com os AWS IoT Greengrass serviços AWS IoT e. Nesta seção, você registra seu dispositivo como AWS IoT algo para usá-lo como núcleo do Greengrass. **Para criar qualquer AWS IoT coisa** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot). 1. Em **Gerenciar**, expanda **Todos os dispositivos** e, em seguida selecione **Coisas**. 1. Na página **Coisas**, selecione **Criar coisas**. 1. Na página **Criar coisas**, selecione **Criar uma única coisa**, em seguida, selecione **Avançar**. 1. Na página **Especificar propriedades da coisa**, faça o seguinte: 1. Em **Nome da coisa**, insira um nome que represente seu dispositivo, como **MyGreengrassV1Core**. 1. Selecione **Next** (Próximo). 1. Na página **Configurar certificado do dispositivo**, selecione **Avançar**. 1. Na página **Anexar políticas ao certificado**, execute uma das seguintes ações: + Selecione uma política existente que conceda as permissões exigidas pelos núcleos e, em seguida selecione **Criar coisa**. Um modal é aberto, onde você pode baixar os certificados e as chaves que o dispositivo usa para se conectar ao Nuvem AWS. + Crie e anexe uma nova política que conceda permissões ao dispositivo de núcleo. Faça o seguinte: 1. Selecione **Create policy** (Criar política). A página **Create policy (Criar política)** é aberta em uma nova guia. 1. Na página **Create policy (Criar política)** faça o seguinte: 1. Em **Nome da política**, insira um nome que descreva a política, como **GreengrassV1CorePolicy**. 1. Na guia **Instruções da política**, em **Documento da política**, selecione **JSON**. 1. Insira o seguinte documento de política. Essa política permite que o núcleo se comunique com o AWS IoT Core serviço, interaja com as sombras do dispositivo e se comunique com o AWS IoT Greengrass serviço. Para obter informações sobre como restringir o acesso a essa política com base no seu caso de uso, consulte [AWS IoT Política mínima para o dispositivo AWS IoT Greengrass principal](device-auth.md#gg-config-sec-min-iot-policy). ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Subscribe", "iot:Connect", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "iot:GetThingShadow", "iot:UpdateThingShadow", "iot:DeleteThingShadow" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "greengrass:*" ], "Resource": [ "*" ] } ] } ``` ------ 1. Selecione **Create** (Criar) para criar a política. 1. Volte para a guia do navegador com a página **Anexar políticas ao certificado** aberta. Faça o seguinte: 1. Na lista **Políticas**, selecione a política que você criou, como **GreengrassV1CorePolicy**. Se a política não for exibida, selecione o botão de atualização. 1. Selecione **Criar coisa**. Um modal é aberto, onde você pode baixar os certificados e as chaves que o núcleo usa para se conectar ao AWS IoT. 1. Volte para a guia do navegador com a página **Anexar políticas ao certificado** aberta. Faça o seguinte: 1. Na lista **Políticas**, selecione a política que você criou, como **GreengrassV1CorePolicy**. Se a política não for exibida, selecione o botão de atualização. 1. Selecione **Criar coisa**. Um modal é aberto, onde você pode baixar os certificados e as chaves que o núcleo usa para se conectar ao AWS IoT. 1. No modal **Baixar certificados e chaves**, baixe os certificados do dispositivo. **Importante** Antes de selecionar **Concluído**, faça download dos recursos de segurança. Faça o seguinte: 1. Em **Certificado do dispositivo**, selecione **Download** para baixar o certificado do dispositivo. 1. Em **Arquivo de chave pública**, selecione **Download** para baixar a chave pública do certificado. 1. Em **Arquivo de chave privada**, selecione **Download** para baixar o arquivo de chave privada para o certificado. 1. Revise [Autenticação do servidor](https://docs.aws.amazon.com/iot/latest/developerguide/server-authentication.html) no *Guia do desenvolvedor da AWS IoT * e, em seguida selecione o certificado de CA raiz apropriado. Recomendamos que você use endpoints do Amazon Trust Services (ATS) e certificados raiz da CA do ATS. Em **Certificados CA raiz**, selecione **Download** para obter um certificado de CA raiz. 1. Selecione **Done** (Concluído). Anote a ID do certificado, que é comum nos nomes dos arquivos do certificado e das chaves do dispositivo. Você precisará disso mais tarde. # Crie um AWS IoT Greengrass grupo para o núcleo AWS IoT Greengrass *os grupos* contêm configurações e outras informações sobre seus componentes, como dispositivos cliente, funções Lambda e conectores. Um grupo define a configuração de um núcleo, incluindo como seus componentes podem interagir uns com os outros. Nesta seção, você cria um grupo para o seu núcleo. **dica** Para ver um exemplo que usa a AWS IoT Greengrass API para criar e implantar um grupo, consulte o repositório [gg\$1group\$1setup](https://github.com/awslabs/aws-greengrass-group-setup) em. GitHub **Para criar um grupo para o núcleo** 1. Navegue até o [console do AWS IoT](https://console.aws.amazon.com/iot). 1. Em **Gerenciar**, expanda **Dispositivos Greengrass** e selecione **Grupos (V1)**. **nota** Se você não vê o menu de **dispositivos do Greengrass**, mude para um Região da AWS que suporte. AWS IoT Greengrass V1 Para obter a lista de regiões compatíveis, consulte [Endpoints e cotas do AWS IoT Greengrass V1](https://docs.aws.amazon.com/general/latest/gr/greengrass.html) no *Referência geral da AWS*. Você deve [criar AWS IoT algo para seu núcleo](provision-core.md) em uma região onde AWS IoT Greengrass V1 esteja disponível. 1. Na página **Grupos do Greengrass**, selecione **Criar grupo**. 1. Na página **Criar grupo do Greengrass** faça o seguinte: 1. Em **Nome do grupo do Greengrass**, insira um nome que descreva o grupo, como **MyGreengrassGroup**. 1. Para o **Greengrass Core**, escolha o AWS IoT que você criou anteriormente, como **MyGreengrassV1Core**. O console seleciona automaticamente o certificado de dispositivo da coisa para você. 1. Selecione **Criar grupo**. # Instale e execute AWS IoT Greengrass no dispositivo principal **nota** Este tutorial fornece instruções para você executar o software AWS IoT Greengrass Core em um Raspberry Pi, mas você pode usar qualquer dispositivo compatível. Nesta seção, você configura, instala e executa o software AWS IoT Greengrass Core em seu dispositivo principal. **Para instalar e executar AWS IoT Greengrass** 1. Na seção [Software AWS IoT Greengrass principal](what-is-gg.md#gg-core-download-tab) deste guia, baixe o pacote de instalação do software AWS IoT Greengrass Core. Selecione o pacote que melhor se adapta à arquitetura da CPU, à distribuição e ao sistema operacional do dispositivo de núcleo. + Para o Raspberry Pi, baixe o pacote para a arquitetura ARMv7l e o sistema operacional Linux. + Para uma EC2 instância da Amazon, baixe o pacote para a arquitetura x86\$164 e o sistema operacional Linux. + Para o NVIDIA Jetson TX2, baixe o pacote para a arquitetura Armv8 (AArch64) e o sistema operacional Linux. + Para o Intel Atom, faça download do pacote para a arquitetura x86\$164 e o sistema operacional Linux. 1. Em etapas anteriores, você obteve cinco arquivos por download em seu computador: + `greengrass-OS-architecture-1.11.6.tar.gz`— Esse arquivo compactado contém o software AWS IoT Greengrass principal que é executado no dispositivo principal. + `certificateId-certificate.pem.crt` – o arquivo de certificado do dispositivo. + `certificateId-public.pem.key` – o arquivo de chave pública do certificado do dispositivo. + `certificateId-private.pem.key` – o arquivo de chave privada do certificado do dispositivo. + `AmazonRootCA1.pem` – o arquivo da autoridade de certificação (CA) raiz da Amazon. Nesta etapa, você transfere esses arquivos do computador para o dispositivo principal. Faça o seguinte: 1. Se você não sabe qual é o endereço IP do dispositivo de núcleo do Greengrass, abra um terminal no dispositivo de núcleo e execute o seguinte comando. **nota** Pode ser que este comando não retorne o endereço IP correto para alguns dispositivos. Consulte a documentação do seu dispositivo para recuperar o endereço IP dele. ``` hostname -I ``` 1. Transfira esses arquivos do computador para o dispositivo de núcleo. As etapas de transferência de arquivos variam em função do sistema operacional do computador. Selecione o seu sistema operacional para as etapas que mostram como transferir arquivos para o dispositivo Raspberry Pi. **nota** Para um Raspberry Pi, o nome de usuário padrão é **pi** e a senha padrão é **raspberry**. Para um NVIDIA Jetson TX2, o nome de usuário padrão é **nvidia** e a senha padrão é. **nvidia** ------ #### [ Windows ] Para transferir os arquivos compactados do computador para um dispositivo de núcleo do Raspberry Pi, use uma ferramenta como [WinSCP](https://winscp.net/eng/download.php) ou o comando [PuTTY](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html) **pscp**. Para usar o comando **pscp**, abra uma janela de prompt de comando no computador e execute o seguinte: ``` cd path-to-downloaded-files pscp -pw Pi-password greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi pscp -pw Pi-password certificateId-certificate.pem.crt pi@IP-address:/home/pi pscp -pw Pi-password certificateId-public.pem.key pi@IP-address:/home/pi pscp -pw Pi-password certificateId-private.pem.key pi@IP-address:/home/pi pscp -pw Pi-password AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** O número da versão nesse comando deve corresponder à versão do seu pacote de software AWS IoT Greengrass Core. ------ #### [ macOS ] Para transferir os arquivos compactados do Mac para um dispositivo de núcleo do Raspberry Pi, abra uma janela do terminal no computador e execute os comandos a seguir. O *path-to-downloaded-files* é tipicamente`~/Downloads`. **nota** Podem ser solicitadas duas senhas. Nesse caso, a primeira senha será para o comando `sudo` do Mac e a segunda será a senha do Raspberry Pi. ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** O número da versão nesse comando deve corresponder à versão do seu pacote de software AWS IoT Greengrass Core. ------ #### [ UNIX-like system ] Para transferir os arquivos compactados do computador para um dispositivo de núcleo do Raspberry Pi, abra uma janela do terminal no computador e execute os seguintes comandos: ``` cd path-to-downloaded-files scp greengrass-OS-architecture-1.11.6.tar.gz pi@IP-address:/home/pi scp certificateId-certificate.pem.crt pi@IP-address:/home/pi scp certificateId-public.pem.key pi@IP-address:/home/pi scp certificateId-private.pem.key pi@IP-address:/home/pi scp AmazonRootCA1.pem pi@IP-address:/home/pi ``` **nota** O número da versão nesse comando deve corresponder à versão do seu pacote de software AWS IoT Greengrass Core. ------ #### [ Raspberry Pi web browser ] Se você tiver usado o navegador da web do Raspberry Pi para fazer download dos arquivos compactados, os arquivos deverão estar na pasta `~/Downloads` do Pi, como a `/home/pi/Downloads`. Caso contrário, os arquivos compactados deverão estar na pasta `~` do Pi, como a `/home/pi`. ------ 1. No dispositivo principal do Greengrass, abra um terminal e navegue até a pasta que contém o software AWS IoT Greengrass principal e os certificados. *path-to-transferred-files*Substitua pelo caminho para o qual você transferiu os arquivos no dispositivo principal. Por exemplo, em um Raspberry Pi, execute `cd /home/pi`. ``` cd path-to-transferred-files ``` 1. Descompacte o software AWS IoT Greengrass Core no dispositivo principal. Execute o comando a seguir para descompactar o software de arquivo que você transferiu para o dispositivo de núcleo. Esse comando usa o argumento `-C /` para criar a pasta `/greengrass` na pasta raiz do dispositivo de núcleo. ``` sudo tar -xzvf greengrass-OS-architecture-1.11.6.tar.gz -C / ``` **nota** O número da versão nesse comando deve corresponder à versão do seu pacote de software AWS IoT Greengrass Core. 1. Mova os certificados e as chaves para a pasta do software AWS IoT Greengrass principal. Execute os comandos a seguir para criar uma pasta para certificados e transferir os certificados e as chaves para ela. *path-to-transferred-files*Substitua pelo caminho para o qual você transferiu os arquivos no dispositivo principal e *certificateId* substitua pela ID do certificado nos nomes dos arquivos. Por exemplo, em um Raspberry Pi, substitua por *path-to-transferred-files* **/home/pi** ``` sudo mv path-to-transferred-files/certificateId-certificate.pem.crt /greengrass/certs sudo mv path-to-transferred-files/certificateId-public.pem.key /greengrass/certs sudo mv path-to-transferred-files/certificateId-private.pem.key /greengrass/certs sudo mv path-to-transferred-files/AmazonRootCA1.pem /greengrass/certs ``` 1. O software AWS IoT Greengrass Core usa um arquivo de configuração que especifica parâmetros para o software. Esse arquivo de configuração especifica os caminhos dos arquivos de certificado e os Nuvem AWS endpoints a serem usados. Nesta etapa, você cria o arquivo de configuração do software AWS IoT Greengrass Core para seu núcleo. Faça o seguinte: 1. Obtenha o Amazon Resource Name (ARN) para sua essência. AWS IoT Faça o seguinte: 1. No [AWS IoT console](https://console.aws.amazon.com/iot), em **Gerenciar**, em **Dispositivos Greengrass**, selecione **Grupos (V1)**. 1. Na página de **Grupos do Greengrass**, selecione o grupo criado por você anteriormente. 1. Em **Visão geral**, selecione **Núcleo do Greengrass**. 1. Na página de detalhes do núcleo, copie o **ARN do AWS IoT item** e salve-o para usar no arquivo de configuração AWS IoT Greengrass principal. 1. Obtenha o endpoint de dados do AWS IoT dispositivo para você Conta da AWS na região atual. Os dispositivos usam esse endpoint para se conectar AWS às AWS IoT coisas. Faça o seguinte: 1. Em [AWS IoT console](https://console.aws.amazon.com/iot), selecione **Configurações**. 1. Em **Endpoint de dados do dispositivo**, copie o **Endpoint** e salve-o para usar no arquivo de configuração do AWS IoT Greengrass Core. 1. Crie o arquivo de configuração do software AWS IoT Greengrass principal. Por exemplo, você pode executar o seguinte comando para usar o GNU nano para criar o arquivo. ``` sudo nano /greengrass/config/config.json ``` Substitua o conteúdo do arquivo com o seguinte documento JSON. ``` { "coreThing" : { "caPath": "AmazonRootCA1.pem", "certPath": "certificateId-certificate.pem.crt", "keyPath": "certificateId-private.pem.key", "thingArn": "arn:aws:iot:region:account-id:thing/MyGreengrassV1Core", "iotHost": "device-data-prefix-ats.iot.region.amazonaws.com", "ggHost": "greengrass-ats.iot.region.amazonaws.com", "keepAlive": 600 }, "runtime": { "cgroup": { "useSystemd": "yes" } }, "managedRespawn": false, "crypto": { "caPath": "file:///greengrass/certs/AmazonRootCA1.pem", "principals": { "SecretsManager": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key" }, "IoTCertificate": { "privateKeyPath": "file:///greengrass/certs/certificateId-private.pem.key", "certificatePath": "file:///greengrass/certs/certificateId-certificate.pem.crt" } } } } ``` Faça o seguinte: + Se você baixou um certificado de CA raiz da Amazon diferente do Amazon Root CA 1, substitua cada instância de *AmazonRootCA1.pem* pelo nome do arquivo da CA raiz da Amazon. + Substitua cada instância do *certificateId* pelo ID do certificado no nome do certificado e dos arquivos-chave. + *arn:aws:iot:*region*:*account-id*:thing/MyGreengrassV1Core*Substitua pelo ARN do item do seu núcleo que você salvou anteriormente. + *MyGreengrassV1core*Substitua pelo nome da coisa mais importante do seu núcleo. + *device-data-prefix-ats.iot.region.amazonaws.com*Substitua pelo endpoint de dados do AWS IoT dispositivo que você salvou anteriormente. + *region*Substitua pelo seu Região da AWS. Para obter mais informações sobre as opções de configuração que você pode especificar nessa configuração, consulte [AWS IoT Greengrass arquivo de configuração principal](gg-core.md#config-json). 1. Verifique se o dispositivo de núcleo está conectado à Internet. Depois, inicie o AWS IoT Greengrass no dispositivo de núcleo. ``` cd /greengrass/ggc/core/ sudo ./greengrassd start ``` Você deverá uma mensagem `Greengrass successfully started`. Anote o PID da função. **nota** Para configurar seu dispositivo principal para iniciar AWS IoT Greengrass na inicialização do sistema, consulte[Configurar o sistema init para iniciar o daemon do Greengrass](gg-core.md#start-on-boot). Você pode executar o comando a seguir para confirmar se o software AWS IoT Greengrass Core (daemon Greengrass) está funcionando. *PID-number*Substitua pelo seu PID: ``` ps aux | grep PID-number ``` Você deve ver uma entrada do PID com um caminho para o daemon do Greengrass que está em execução (por exemplo, `/greengrass/ggc/packages/1.11.6/bin/daemon`). Se você tiver problemas ao iniciar AWS IoT Greengrass, consulte[Solução de problemas AWS IoT Greengrass](gg-troubleshooting.md).