Configurar um novo dispositivo principal do V2 para testar aplicações do V1 - AWS IoT Greengrass
Etapa 1: instalar o Greengrass V2 em um novo dispositivoEtapa 2: criar e implantar componentes do V2 para migrar aplicações do V1Etapa 3: testar as aplicações do V2

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

Configurar um novo dispositivo principal do V2 para testar aplicações do V1

Configure um novo dispositivo principal do AWS IoT Greengrass V2 para implantar e testar os componentes e as funções do AWS Lambda fornecidos pela AWS em suas aplicações do AWS IoT Greengrass V1. Você também pode usar esse dispositivo principal do V2 para desenvolver e testar outros componentes personalizados do Greengrass que executam processos nativos em dispositivos principais. Depois de testar suas aplicações em um dispositivo principal do V2, será possível atualizar os dispositivos principais do V1 existentes para o V2 e implantar os componentes do V2 que fornecem a funcionalidade do V1.

Etapa 1: instalar o AWS IoT Greengrass V2 em um novo dispositivo

Instale o software de núcleo do AWS IoT Greengrass v2.x em um novo dispositivo. É possível seguir o Tutorial de conceitos básicos para configurar um dispositivo e saber como desenvolver e implantar componentes. Esse tutorial usa o provisionamento automático para configurar rapidamente um dispositivo. Quando você instalar o software de núcleo do AWS IoT Greengrass v2.x, especifique o argumento --deploy-dev-tools para implantar a CLI do Greengrass, assim poderá desenvolver, testar e depurar componentes diretamente no dispositivo. Para obter mais informações sobre outras opções de instalação, incluindo como instalar o software de núcleo do AWS IoT Greengrass por meio de um proxy ou usando um módulo de segurança de hardware (HSM), consulte Instalar o software do AWS IoT Greengrass Core.

(Opcional) Habilitar o registro em log no Amazon CloudWatch Logs

Para permitir que um dispositivo principal do V2 faça upload de logs no Amazon CloudWatch Logs, você pode implantar o componente Gerenciador de logs fornecido pela AWS. É possível usar o CloudWatch Logs para visualizar os logs do componente e, dessa forma, depurar e solucionar problemas sem acessar o sistema de arquivos do dispositivo principal. Para obter mais informações, consulte Monitore AWS IoT Greengrass logs.

Etapa 2: criar e implantar componentes do AWS IoT Greengrass V2 para migrar aplicações do AWS IoT Greengrass V1

É possível executar a maioria das aplicações do AWS IoT Greengrass V1 no AWS IoT Greengrass V2. É possível importar as funções do Lambda como componentes que são executados no AWS IoT Greengrass V2 e usar os componentes fornecidos pela AWS, que oferecem a mesma funcionalidade dos conectores do AWS IoT Greengrass.

Você também pode desenvolver componentes personalizados para gerar um recurso ou runtime para execução nos dispositivos principais do Greengrass. Para obter informações sobre como desenvolver e testar componentes localmente, consulte Criar componentes do AWS IoT Greengrass.

Importar funções do Lambda no V1

É possível importar funções do Lambda como componentes do AWS IoT Greengrass V2. Escolha entre as seguintes abordagens:

  • Importar as funções do Lambda V1 diretamente como componentes do Greengrass.

  • Atualizar as funções do Lambda para usar as bibliotecas do Greengrass no AWS IoT Device SDK v2 e, em seguida, importá-las como componentes do Greengrass.

  • Criar componentes personalizados que usam um código que não é do Lambda e o AWS IoT Device SDK v2 para implementar a mesma funcionalidade das funções do Lambda.

Se a função do Lambda usa recursos, como Gerenciador de fluxos ou segredos locais, é necessário definir dependências nos componentes fornecidos pela AWS que empacotam esses recursos. Quando você implanta o componente de função do Lambda, a implantação também o inclui em cada recurso que você define como dependência. Na implantação, você pode configurar parâmetros, como os segredos que serão implantados no dispositivo principal. Nem todos os recursos do V1 exigem uma dependência de componente para a função do Lambda no V2. A lista a seguir descreve como usar os recursos do V1 no componente de função do Lambda no V2.

  • Acessar outros serviços da AWS

    Se a função do Lambda usa as credenciais da AWS para fazer solicitações para outros serviços da AWS, o perfil de troca de tokens do dispositivo principal deve permitir que o dispositivo principal execute as operações da AWS que a função do Lambda usa. Para obter mais informações, consulte Autorize os dispositivos principais a interagir com os serviços da AWS.

  • Gerenciador de fluxos

    Se a função do Lambda usa o Gerenciador de fluxos, especifique aws.greengrass.StreamManager como uma dependência do componente quando você importar a função. Quando você implantar o componente Gerenciador de fluxos, especifique os parâmetros dele que serão definidos nos dispositivos principais de destino. O perfil de troca de tokens do dispositivo principal deve permitir que o dispositivo principal acesse os destinos da Nuvem AWS que você usa com o Gerenciador de fluxos. Para obter mais informações, consulte Gerenciador de fluxos.

  • Segredos locais

    Se a função do Lambda usa segredos locais, especifique aws.greengrass.SecretManager como uma dependência do componente quando você importar a função. Quando você implantar o componente Gerenciador de segredos, especifique os recursos de segredo que serão implantados nos dispositivos principais de destino. O perfil de troca de tokens do dispositivo principal deve permitir que o dispositivo principal recupere os recursos de segredo que serão implantados. Para obter mais informações, consulte Gerenciador de segredos.

    Quando você implantar o componente de função do Lambda, configure-o com uma política de autorização de IPC que conceda permissão para usar a operação de IPC GetSecretValue no AWS IoT Device SDK V2.

  • Sombras locais

    Se a função do Lambda interage com sombras locais, é necessário atualizar o código da função do Lambda para usar o AWS IoT Device SDK V2. Você também deve especificar aws.greengrass.ShadowManager como uma dependência do componente ao importar a função. Para obter mais informações, consulte Interaja com as sombras do dispositivo.

    Quando você implantar o componente de função do Lambda, configure-o com uma política de autorização de IPC que conceda permissão para usar as operações de IPC de sombra no AWS IoT Device SDK V2.

  • Assinaturas

    • Se a função do Lambda assina mensagens de uma fonte na nuvem, especifique essas assinaturas como fontes de evento quando você importar a função.

    • Se a função do Lambda assina mensagens de outra função do Lambda, ou se ela publica mensagens no AWS IoT Core ou em outras funções do Lambda, configure e implante o componente legado de roteador de assinatura quando você implantar a função do Lambda. Quando você implantar o componente legado de roteador de assinatura, especifique as assinaturas que a função do Lambda usa.

      nota

      O componente legado de roteador de assinatura será necessário somente se a função do Lambda usar a função publish() no SDK de núcleo do AWS IoT Greengrass. Se você atualizar o código da função do Lambda para usar a interface de comunicação entre processos (IPC) no AWS IoT Device SDK V2, não precisará implantar o componente legado de roteador de assinatura. Para obter mais informações, consulte os seguintes serviços de comunicação entre processos:

    • Se a função do Lambda assina mensagens de dispositivos conectados locais, especifique essas assinaturas como fontes de evento quando você importar a função. Você também deve configurar e implantar o componente de ponte MQTT para retransmitir mensagens dos dispositivos conectados aos tópicos locais de publicação/assinatura que você especifica como fontes de evento.

    • Se a função do Lambda publica mensagens em dispositivos conectados locais, é necessário atualizar o código da função do Lambda para usar o AWS IoT Device SDK V2 para publicar mensagens locais de publicação/assinatura. Você também deve configurar e implantar o componente de ponte MQTT para retransmitir mensagens do agente de mensagens de publicação/assinatura local para os dispositivos conectados.

  • Volumes e dispositivos locais

    Se a função do Lambda em contêiner acessa volumes ou dispositivos locais, especifique-os quando você importar a função do Lambda. Esse recurso não exige uma dependência do componente.

Para obter mais informações, consulte Executar funções AWS Lambda..

Usar conectores do V1

É possível implantar componentes fornecidos pela AWS que oferecem a mesma funcionalidade de alguns conectores do AWS IoT Greengrass. Quando você criar a implantação, poderá configurar os parâmetros dos conectores.

Os seguintes componentes do AWS IoT Greengrass V2 oferecem a funcionalidade do conector do Greengrass V1:

Executar contêineres do Docker

O AWS IoT Greengrass V2 não fornece um componente para substituir diretamente o conector de implantação de aplicações do Docker no V1. No entanto, você pode usar o componente Gerenciador de Aplicações do Docker para fazer download de imagens do Docker e, em seguida, criar componentes personalizados que executam contêineres do Docker a partir das imagens baixadas. Para obter mais informações, consulte Executar um contêiner do Docker e Gerenciador de aplicações do Docker.

Executar a inferência de machine learning

O AWS IoT Greengrass V2 fornece um componente do Amazon SageMaker AI Edge Manager, que instala o agente do Amazon SageMaker AI Edge Manager e permite que você use modelos compilados pelo SageMaker AI Neo como componentes de modelo nos dispositivos principais do Greengrass. O AWS IoT Greengrass V2 também fornece componentes que instalam o Deep Learning Runtime e o TensorFlow Lite em seu dispositivo. É possível usar o modelo DLR e TensorFlow Lite correspondentes e os componentes de inferência para realizar a classificação de imagens de amostra e a inferência de detecção de objetos. Para usar outras estruturas de machine learning, como MXNet e TensorFlow, você pode desenvolver seus próprios componentes personalizados que usem essas estruturas.

Conectar dispositivos do Greengrass V1

Os dispositivos conectados no AWS IoT Greengrass V1 são chamados de dispositivos cliente no AWS IoT Greengrass V2. O suporte do AWS IoT Greengrass V2 para dispositivos cliente é compatível com versões anteriores no AWS IoT Greengrass V1, portanto, você pode conectar dispositivos cliente do V1 a dispositivos principais do V2 sem alterar o código da aplicação. Para permitir que os dispositivos cliente se conectem a um dispositivo principal do V2, implante componentes do Greengrass que ofereçam suporte ao dispositivo cliente e associe os dispositivos cliente ao dispositivo principal. Para retransmitir mensagens entre os dispositivos cliente, o serviço de nuvem do AWS IoT Core e os componentes do Greengrass (incluindo funções do Lambda), implante e configure o componente de ponte MQTT. É possível implantar o componente de detector de IP para detectar automaticamente as informações de conectividade ou gerenciar os endpoints manualmente. Para obter mais informações, consulte Interagir com dispositivos de IoT locais.

Habilitar o serviço de sombra local

No AWS IoT Greengrass V2, o serviço de sombra local é implementado pelo componente Gerenciador de sombras fornecido pela AWS. O AWS IoT Greengrass V2 também inclui suporte a sombras nomeadas. Para permitir que seus componentes interajam com as sombras locais e sincronizem os estados das sombra com o AWS IoT Core, configure e implante o componente Gerenciador de sombras e use as operações de IPC de sombra no código do componente. Para obter mais informações, consulte Interaja com as sombras do dispositivo.

Integrar ao AWS IoT SiteWise

Se você usa o dispositivo principal do V1 como gateway do AWS IoT SiteWise, siga as instruções para configurar o novo dispositivo principal do V2 como gateway do AWS IoT SiteWise. O AWS IoT SiteWise fornece um script de instalação que implanta os componentes do AWS IoT SiteWise para você.

Etapa 3: testar as aplicações do AWS IoT Greengrass V2

Depois de criar e implantar os componentes do V2 em seu novo dispositivo principal do V2, verifique se as aplicações atendem às suas expectativas. É possível consultar os logs do dispositivo para ver as mensagens de saída padrão (stdout) e de erro padrão (stderr) dos componentes. Para obter mais informações, consulte Monitore AWS IoT Greengrass logs.

Se você implantou a CLI do Greengrass no dispositivo principal, pode usá-la para depurar os componentes e as respectivas configurações. Para obter mais informações, consulte Comandos da CLI do Greengrass.

Depois de verificar se as aplicações funcionam em um dispositivo principal do V2, será possível implantar os componentes do Greengrass da sua aplicação em outros dispositivos principais. Se você desenvolveu componentes personalizados que executam processos nativos ou contêineres do Docker, deve primeiro publicar esses componentes no serviço AWS IoT Greengrass para implantá-los em outros dispositivos principais.