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