Instalar o software do AWS IoT Greengrass Core

Para desinstalar o software AWS IoT Greengrass Core e preservar as informações de configuração

• Execute o comando a seguir para remover os pacotes de software AWS IoT Greengrass Core preservar as informações de configuração na pasta /greengrass.

  sudo apt remove aws-iot-greengrass-core aws-iot-greengrass-keyring

Para desinstalar o software AWS IoT Greengrass Core e remover as informações de configuração

1. Execute o comando a seguir para remover os pacotes do software AWS IoT Greengrass Core e remover as informações de configuração do /greengrass folder.

   sudo apt purge aws-iot-greengrass-core aws-iot-greengrass-keyring

2. Remova o repositório do software AWS IoT Greengrass Core da sua lista de fontes. Para ter mais informações, consulte Remova as fontes do repositório do software AWS IoT Greengrass Core.

Para remover o repositório APT da lista de fontes

• Execute os seguintes comandos para remover o repositório do software AWS IoT Greengrass Core da lista de fontes.

  sudo rm /etc/apt/sources.list.d/greengrass.list
  sudo apt update

1. Instale o snap do core18 executando o seguinte comando no terminal do dispositivo:

   sudo snap install core18

   O snap do core18 é um snap básico que fornece um ambiente de runtime com bibliotecas comumente usadas. Esse snap foi compilado a partir do Ubuntu 18.04 LTS.

2. Atualize o snapd executando o seguinte comando.

   sudo snap install --channel=edge snapd; sudo snap refresh --channel=edge snapd

3. Execute o comando snap list para verificar se você tem o snap do AWS IoT Greengrass instalado.

   O exemplo de resposta a seguir mostra que o snapd está instalado, mas o aws-iot-greengrass não está.

   Name              Version               Rev    Tracking         Publisher   Notes
   amazon-ssm-agent  3.0.161.0             2996   latest/stable/…  aws✓        classic
   core              16-2.48               10444  latest/stable    canonical✓  core
   core18            20200929              1932   latest/stable    canonical✓  base
   lxd               4.0.4                 18150  4.0/stable/…     canonical✓  -
   snapd             2.48+git548.g929ccfb  10526  latest/edge      canonical✓  snapd

4. Selecione uma das opções a seguir para instalar o snap 1.11.x do AWS IoT Greengrass.

   • Execute o comando a seguir para instalar o snap do AWS IoT Greengrass.

     sudo snap install aws-iot-greengrass

     Exemplo de resposta:

     aws-iot-greengrass 1.11.5 from Amazon Web Services (aws) installed

   • Para migrar de uma versão anterior para a v1.11.x ou atualizar para a versão de patch mais recente disponível, execute o seguinte comando:

     sudo snap refresh --channel=1.11.x aws-iot-greengrass

   Como outros snaps, o snap do AWS IoT Greengrass usa canais para gerenciar versões secundárias. Os snaps são atualizados automaticamente para a versão mais recente disponível do canal atual. Por exemplo, se você especificar --channel=1.11.x, seu snap do AWS IoT Greengrass será atualizado para a v1.11.5.

   Você pode executar o comando snap info aws-iot-greengrass para obter a lista de canais disponíveis para AWS IoT Greengrass.

   Exemplo de resposta:

   name:      aws-iot-greengrass
   summary:   AWS supported software that extends cloud capabilities to local devices.
   publisher: Amazon Web Services (aws✓)
   store-url: https://snapcraft.io/aws-iot-greengrass
   contact:   https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass
   license:   Proprietary
   description: |
     AWS IoT Greengrass seamlessly extends AWS onto edge devices so they can act locally on the data
     they generate, while still using the cloud for management, analytics, and durable storage.
     AWS IoT Greenrgrass snap v1.11.0 enables you to run a limited version of AWS IoT Greengrass with
     all necessary dependencies in a containerized environment.
     The AWS IoT Greengrass snap doesn't support connectors and machine learning (ML) inference.
     By downloading this software you agree to the Greengrass Core Software License Agreement
     (https://s3-us-west-2.amazonaws.com/greengrass-release-license/greengrass-license-v1.pdf).
     For more information, see Run AWS IoT Greengrass in a snap
     (https://docs.aws.amazon.com/greengrass/latest/developerguide/install-ggc.html#gg-snap-support) in
     the AWS IoT Greengrass Developer.
     If you need help, try the AWS IoT Greengrass tag on AWS re:Post
     (https://repost.aws/tags/TA4ckIed1sR4enZBey29rKTg/aws-io-t-greengrass) or connect with an AWS IQ expert
     (https://iq.aws.amazon.com/services/aws/greengrass).
   snap-id: SRDuhPJGj4XPxFNNZQKOTvURAp0wxKnd
   channels:
     latest/stable:    1.11.3 2021-06-15 (59) 111MB -
     latest/candidate: 1.11.3 2021-06-14 (59) 111MB -
     latest/beta:      1.11.3 2021-06-14 (59) 111MB -
     latest/edge:      1.11.3 2021-06-14 (59) 111MB -
     1.11.x/stable:    1.11.3 2021-06-15 (59) 111MB -
     1.11.x/candidate: 1.11.3 2021-06-15 (59) 111MB -
     1.11.x/beta:      1.11.3 2021-06-15 (59) 111MB -
     1.11.x/edge:      1.11.3 2021-06-15 (59) 111MB -

5. Para acessar recursos específicos os quais suas funções do Lambda precisam, você pode se conectar a outras interfaces.

   Execute o seguinte comando para obter a lista das interfaces suportadas pelo snap do AWS IoT Greengrass:

   snap connections aws-iot-greengrass

   Exemplo de resposta:

   Interface                Plug                                                Slot                 Notes
   camera                   aws-iot-greengrass:camera                           -                    -
   dvb                      aws-iot-greengrass:dvb                              -                    -
   gpio                     aws-iot-greengrass:gpio                             -                    -
   gpio-memory-control      aws-iot-greengrass:gpio-memory-control              -                    -
   greengrass-support       aws-iot-greengrass:greengrass-support-no-container  :greengrass-support  -
   hardware-observe         aws-iot-greengrass:hardware-observe                 :hardware-observe    manual
   hardware-random-control  aws-iot-greengrass:hardware-random-control          -                    -
   home                     aws-iot-greengrass:home-for-greengrassd             -                    -
   home                     aws-iot-greengrass:home-for-hooks                   :home                manual
   hugepages-control        aws-iot-greengrass:hugepages-control                :hugepages-control   manual
   i2c                      aws-iot-greengrass:i2c                              -                    -
   iio                      aws-iot-greengrass:iio                              -                    -
   joystick                 aws-iot-greengrass:joystick                         -                    -
   log-observe              aws-iot-greengrass:log-observe                      :log-observe         manual
   mount-observe            aws-iot-greengrass:mount-observe                    :mount-observe       manual
   network                  aws-iot-greengrass:network                          :network             -
   network-bind             aws-iot-greengrass:network-bind                     :network-bind        -
   network-control          aws-iot-greengrass:network-control                  :network-control     -
   opengl                   aws-iot-greengrass:opengl                           :opengl              -
   optical-drive            aws-iot-greengrass:optical-drive                    :optical-drive       -
   process-control          aws-iot-greengrass:process-control                  :process-control     -
   raw-usb                  aws-iot-greengrass:raw-usb                          -                    -
   removable-media          aws-iot-greengrass:removable-media                  -                    -
   serial-port              aws-iot-greengrass:serial-port                      -                    -
   spi                      aws-iot-greengrass:spi                              -                    -
   system-observe           aws-iot-greengrass:system-observe                   :system-observe      -

   Se houver um hífen (-) na coluna Slot, a interface correspondente não está conectada.

6. Siga Instalando o software AWS IoT Greengrass Core para criar uma coisa do AWS IoT, um grupo Greengrass, recursos de segurança que permitam comunicações seguras com o AWS IoT e o arquivo de configuração do software AWS IoT Greengrass Core. O arquivo de configuração, config.json, contém configurações específicas para seu núcleo do Greengrass, como a localização dos arquivos de certificado e o endpoint de dados do dispositivo AWS IoT.

   nota

   Se você baixou o arquivo em um dispositivo diferente, siga esta etapa para transferir os arquivos para o dispositivo de núcleo AWS IoT Greengrass.

7. Para o snap do AWS IoT Greengrass, certifique-se de atualizar o arquivo config.json, conforme mostrado a seguir:

   • Substitua cada instância de certificateID pelo ID do certificado no nome do certificado e dos arquivos de chave.

   • 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 CA raiz da Amazon.

   {
     ...
     "crypto" : {
       "principals" : {
         "SecretsManager" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.keyy"
         },
         "IoTCertificate" : {
           "privateKeyPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-private.pem.key",
           "certificatePath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/certificateId-certificate.pem.crt"
         }
       },
       "caPath" : "file:///snap/aws-iot-greengrass/current/greengrass/certs/AmazonRootCA1.pem"
     },
     "writeDirectory": "/var/snap/aws-iot-greengrass/current/ggc-write-directory",
     "pidFileDirectory": "/var/snap/aws-iot-greengrass/current/pidFileDirectory"
   }

8. Execute o comando a seguir para atualizar o os campos de certificado do AWS IoT Greengrass e de configuração:

   sudo snap set aws-iot-greengrass gg-certs=/home/ubuntu/my-certs

1. Execute o comando a seguir para interromper o daemon do AWS IoT Greengrass:

   sudo snap start aws-iot-greengrass

   Exemplo de resposta:

   Started.

   nota

   Se você receber um erro, poderá usar o comando do snap run para obter uma mensagem de erro detalhada. Para obter mais solução de problemas, consulte erro: não é possível executar as seguintes tarefas: - Execute o comando de serviço “start” para os serviços ["greengrassd"] do snap "aws-iot-greengrass" ([start snap. aws-iot-greengrass.greengrassd.service] falhou com o status de saída 1: Job for snap. aws-iot-greengrass.greengrassd.service falhou porque o processo de controle foi encerrado com o código de erro. Consulte “systemctl status snap”. aws-iot-greengrass.greengrassd.service” e “journalctl -xe” para obter detalhes.).

2. Execute o comando a seguir para confirmar se o daemon está em execução:

   snap services aws-iot-greengrass.greengrassd

   Exemplo de resposta:

   Service                         Startup   Current  Notes
   aws-iot-greengrass.greengrassd  disabled  active   -

3. Siga o Módulo 3 (parte 1): a função do Lambda no AWS IoT Greengrass para criar e implantar uma função do Lambda Hello World . No entanto, antes de implantar a função do Lambda, conclua a próxima etapa.

4. Certifique-se de que sua função do Lambda seja executada como usuário do snap_daemon e no modo sem contêiner. Para atualizar as configurações do grupo do Greengrass, siga estas instruções no console do AWS IoT Greengrass:

   1. Faça login no console do AWS IoT Greengrass.

   2. No painel de navegação do console de AWS IoT, em Gerenciar, expanda Dispositivos Greengrass e, em seguida selecione Grupos (V1).

   3. Em Grupos do Greengrass, selecione o grupo-alvo.

   4. Na página de configuração do grupo, no painel de navegação, selecione a guia Funções do Lambda.

   5. Em Ambiente de runtime da função do Lambda padrão, selecione Editar e faça o seguinte:

      1. Em Usuário e grupo padrão do sistema, selecione Outro ID de usuário/ID de grupo e, em seguida, insira 584788 em ID do usuário do sistema (número) e ID do grupo do sistema (número).

      2. Em Ambiente de runtime da função do Lambda padrão, selecione Editar e faça o seguinte:

      3. Selecione Salvar.

Para arquivar a instalação atual e instalar uma nova versão

1. Faça download do pacote de instalação do software do AWS IoT Greengrass Core para o qual você deseja atualizar.

2. Copie o pacote para o dispositivo de núcleo de destino. Para obter instruções que mostram como transferir arquivos, consulte esta etapa.

   nota

   Posteriormente, copie seus certificados atuais, chaves e o arquivo de configuração para a nova instalação.

   Execute os comandos de acordo com as etapas a seguir no terminal de dispositivo de núcleo.

3. Verifique se o daemon do Greengrass está parado no dispositivo de núcleo.

   1. Para verificar se o daemon está em execução:

      ps aux | grep -E 'greengrass.*daemon'

      Se a saída contém uma entrada root para /greengrass/ggc/packages/ggc-version/bin/daemon, o daemon está em execução.

      nota

      Este procedimento é gravado com a suposição de que o software do núcleo do AWS IoT Greengrass está instalado no diretório /greengrass.

   2. Para interromper o daemon do :

      cd /greengrass/ggc/core/
      sudo ./greengrassd stop

4. Mova o diretório raiz do Greengrass atual para um diretório diferente.

   sudo mv /greengrass /greengrass_backup

5. Descompacte o novo software no dispositivo de núcleo. Substitua os espaços reservados os-architecture e version no comando.

   sudo tar –zxvf greengrass-os-architecture-version.tar.gz –C /

6. Copie os certificados arquivados, as chaves e o arquivo de configuração para a nova instalação.

   sudo cp /greengrass_backup/certs/* /greengrass/certs
   sudo cp /greengrass_backup/config/* /greengrass/config

7. Inicie o daemon:

   cd /greengrass/ggc/core/
   sudo ./greengrassd start

Para restaurar a instalação arquivada

1. Pare o daemon.

2. Exclua o novo diretório /greengrass.

3. Mova o diretório /greengrass_backup de volta para /greengrass.

4. Inicie o daemon.