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

# Instalar o software AWS IoT Greengrass Core (console)
<a name="install-greengrass-v2-console"></a>

1. Faça login no [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).

1. Em **Conceitos básicos do Greengrass**, escolha **Configuração de um dispositivo principal**.

1. Em **Etapa 1: Registrar um dispositivo principal do Greengrass**, em **Nome do dispositivo principal**, insira o nome do dispositivo AWS IoT principal do Greengrass. Se o objeto não existir, o instalador o cria.

1. Em **Etapa 2: Adicionar a um grupo de coisas para aplicar uma implantação contínua**, em **Thing group**, escolha o grupo de AWS IoT coisas ao qual você deseja adicionar seu dispositivo principal. 
   + Se você selecionar **Inserir um novo nome de grupo**, em **Nome do grupo Thing**, insira o nome do novo grupo a ser criado. O instalador cria o novo grupo para você.
   + Se você **selecionar Selecionar um grupo existente**, em **Nome do grupo Thing**, escolha o grupo existente que você deseja usar.
   + Se você selecionar **Nenhum grupo**, o instalador não adicionará o dispositivo principal a um grupo de coisas.

1. Em **Etapa 3: Instalar o software Greengrass Core**, conclua as etapas a seguir.

------
#### [ Nucleus classic ]

   1. Escolha **Nucleus classic** como o runtime do software do seu dispositivo principal.

   1. Escolha o sistema operacional do seu dispositivo principal: **Linux** ou **Windows**.

   1. <a name="installer-export-aws-credentials"></a>Forneça as credenciais da AWS ao dispositivo para que o instalador possa provisionar os recursos do IAM e da AWS IoT necessários. Para aumentar a segurança, recomendamos que você obtenha credenciais temporárias para um perfil do IAM que habilite somente as permissões mínimas necessárias para provisionar. Para obter mais informações, consulte [Política mínima de IAM para o instalador provisionar recursos](provision-minimal-iam-policy.md).
**nota**  
O instalador não salva nem armazena suas credenciais.

      No seu dispositivo, faça o seguinte para recuperar as credenciais e disponibilizá-las para o instalador do software AWS IoT Greengrass Core:
      + (Recomendado) Use credenciais temporárias do Centro de Identidade do AWS IAM

        1. Forneça o ID da chave de acesso, a chave de acesso secreta e o token de sessão do IAM Identity Center. Para obter mais informações, consulte **Atualização manual de credenciais** em [Como conseguir e atualizar credenciais temporárias](https://docs.aws.amazon.com/singlesignon/latest/userguide/howtogetcredentials.html#how-to-get-temp-credentials) no *Guia do usuário do Centro de Identidade do IAM*.

        1. Use os comandos a seguir para fornecer credenciais ao software AWS IoT Greengrass Core.

------
#### [ Linux or Unix ]

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

------
#### [ Windows Command Prompt (CMD) ]

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

------
#### [ PowerShell ]

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="
           ```

------
      + Use credenciais de segurança temporárias de um perfil do IAM:

        1. Forneça o ID da chave de acesso, a chave de acesso secreta e o token de sessão do perfil do IAM que você assume. Para obter mais informações sobre como recuperar essas credenciais, consulte [Solicitação de credenciais de segurança temporárias](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_request.html) no *Guia do usuário do IAM*.

        1. Use os comandos a seguir para fornecer credenciais ao software AWS IoT Greengrass Core.

------
#### [ Linux or Unix ]

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

------
#### [ Windows Command Prompt (CMD) ]

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=
           ```

------
#### [ PowerShell ]

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="
           ```

------
      + Use credenciais de segurança de longo prazo de um usuário do IAM:

        1. Forneça o ID da chave de acesso e a chave de acesso secreta para seu usuário do IAM. É possível criar um usuário do IAM para provisionamento que será excluído posteriormente. Para ver a política do IAM a ser fornecida ao usuário, consulte [Política mínima de IAM para o instalador provisionar recursos](provision-minimal-iam-policy.md). Para obter mais informações sobre como recuperar credenciais de longo prazo, consulte [Como gerenciar chaves de acesso para usuários do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html) no *Guia do usuário do IAM*.

        1. Use os comandos a seguir para fornecer credenciais ao software AWS IoT Greengrass Core.

------
#### [ Linux or Unix ]

           ```
           export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           ```

------
#### [ Windows Command Prompt (CMD) ]

           ```
           set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
           set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
           ```

------
#### [ PowerShell ]

           ```
           $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
           $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
           ```

------

        1. (Opcional) Se você criou um usuário do IAM para provisionar seu dispositivo Greengrass, exclua o usuário.

        1. (Opcional) Se você usou o ID da chave de acesso e a chave de acesso secreta de um usuário do IAM existente, atualize as chaves do usuário para que elas não sejam mais válidas. Para obter mais informações, consulte [Atualização de chaves de acesso](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_RotateAccessKey) no *Guia de usuário do AWS Identity and Access Management*.

   1. Em **Executar o instalador**, conclua as etapas a seguir.

      1. Em **Baixar o instalador**, escolha **Copiar** e execute o comando copiado no seu dispositivo principal. Esse comando baixa a versão mais recente do software AWS IoT Greengrass Core e a descompacta no seu dispositivo.

      1. Em **Executar o instalador**, escolha **Copiar** e execute o comando copiado no seu dispositivo principal. Esse comando usa os nomes de AWS IoT coisas e grupos de coisas que você especificou anteriormente para executar o instalador do software AWS IoT Greengrass Core e configurar AWS recursos para seu dispositivo principal.

         Esse comando também faz o seguinte:
         + <a name="install-argument-system-service"></a>Configure o software AWS IoT Greengrass Core como um serviço do sistema que é executado na inicialização. Em dispositivos Linux, isso requer o sistema init [Systemd](https://en.wikipedia.org/wiki/Systemd).
**Importante**  <a name="windows-system-service-requirement-important-note"></a>
Nos dispositivos principais do Windows, é preciso configurar o software AWS IoT Greengrass Core como um serviço do sistema.
         + <a name="install-argument-dev-tools"></a>Implante o [componente AWS IoT Greengrass CLI](gg-cli.md), que é uma ferramenta de linha de comando que permite desenvolver componentes personalizados do Greengrass no dispositivo principal.
         + <a name="install-argument-component-default-user"></a>Especifique o uso do usuário do sistema `ggc_user` para executar componentes de software no dispositivo principal. Em dispositivos Linux, esse comando também especifica o uso do grupo do sistema `ggc_group` e o instalador cria o usuário e o grupo do sistema para você.

         Ao executar esse comando, é necessário ver as seguintes mensagens para indicar que o instalador foi bem-sucedido.

         ```
         Successfully configured Nucleus with provisioned resource details!
         Configured Nucleus to deploy aws.greengrass.Cli component
         Successfully set up Nucleus as a system service
         ```
**nota**  <a name="installer-linux-no-systemd-message"></a>
Se você tiver um dispositivo Linux e ele não tiver [systemd](https://en.wikipedia.org/wiki/Systemd), o instalador não configurará o software como um serviço do sistema e você não verá a mensagem de sucesso da configuração do núcleo como um serviço do sistema.

------
#### [ Nucleus lite ]

   1. Escolha **Nucleus lite** como o runtime do software do seu dispositivo principal.

   1. Selecione o método de configuração do seu dispositivo para provisionar seu dispositivo em um dispositivo principal do Greengrass.

   **Opção 1: configurar um dispositivo com download de pacote (aproximadamente 1 MB)**

   1. Crie uma coisa de AWS IoT e o perfil do Greengrass.

   1. Baixe o arquivo zip que contém os recursos de AWS IoT os quais seu dispositivo precisa conectar à AWS IoT:
      + Um certificado e uma chave privada gerados usando a autoridade de certificação de AWS IoT.
      + Um arquivo de esquema para iniciar a instalação do Greengrass em seu dispositivo.

   1. Baixe o pacote que instalará o runtime mais recente do Greengrass nucleus lite em seu Raspberry Pi.

   1. Provisione seu dispositivo para se tornar um dispositivo AWS IoT Greengrass Core e conecte-o à AWS IoT:

      1. a. Transfira o pacote Greengrass e o kit de conexão para o seu dispositivo usando um pen drive USB, SCP/FTP ou cartões SD.

      1. b. Descompacte o arquivo greengrass-package.zip no diretório /GreengrassInstaller no dispositivo.

      1. c. Descompacte o arquivo zip do kit de conexão no /diretório no dispositivo. 

      1. d. Execute o comando fornecido no dispositivo para instalar o AWS IoT Greengrass

   1. Em seguida, escolha **Exibir dispositivos principais**.

   **Opção 2: configurar um dispositivo com um download de imagem de amostra de disco inteiro pré-configurada (aproximadamente 100 MB)**

   1. Crie uma coisa de AWS IoT e o perfil do Greengrass.

   1. Baixe o arquivo zip que contém os recursos de AWS IoT os quais seu dispositivo precisa conectar à AWS IoT:
      + Um certificado e uma chave privada gerados usando a autoridade de certificação de AWS IoT.
      + Um arquivo de esquema para iniciar a instalação do Greengrass em seu dispositivo.

   1. Faça o download da imagem de amostra de disco inteiro pré-configurada que contém o Greengrass e o sistema operacional.

      1. Para transferir o kit de conexão e atualizar a imagem para o dispositivo, siga o arquivo readme baixado com a imagem.

      1. Para iniciar a instalação do Greengrass, ligue e inicialize o dispositivo a partir da imagem descarregada

   1. Em seguida, escolha **Exibir dispositivos principais**.

   **Opção 3: configurar um dispositivo com sua própria compilação personalizada**

   1. Crie uma coisa de AWS IoT e o perfil do Greengrass.

   1. Baixe o arquivo zip que contém os recursos de AWS IoT os quais seu dispositivo precisa conectar à AWS IoT:
      + Um certificado e uma chave privada gerados usando a autoridade de certificação de AWS IoT.
      + Um arquivo de esquema para iniciar a instalação do Greengrass em seu dispositivo.

   1. Para personalizar e criar sua própria imagem usando o Yocto a partir do código-fonte e, em seguida, usar o kit de conexão para instalar o nucleus lite, siga as instruções no GitHub.

      1. Em seguida, escolha **Exibir dispositivos principais**.

------