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á.
Configure um novo dispositivo V2 core para testar aplicativos V1
Configure um novo dispositivo AWS IoT Greengrass V2 principal para implantar e testar os componentes e AWS Lambda funções AWS fornecidos para seus AWS IoT Greengrass V1 aplicativos. Você também pode usar esse dispositivo principal V2 para desenvolver e testar componentes adicionais personalizados do Greengrass que executam processos nativos em dispositivos principais. Depois de testar seus aplicativos em um dispositivo V2 core, você pode atualizar seus dispositivos V1 core existentes para V2 e implantar os componentes V2 que fornecem sua funcionalidade V1.
Etapa 1: instalar AWS IoT Greengrass V2 em um novo dispositivo
Instale o software AWS IoT Greengrass Core v2.x em um novo dispositivo. Você pode seguir o tutorial de introdução para configurar um dispositivo e aprender a desenvolver e implantar componentes. Este tutorial usa o provisionamento automático para configurar rapidamente um dispositivo. Ao instalar o software AWS IoT Greengrass Core v2.x, especifique o --deploy-dev-tools argumento para implantar a CLI do Greengrass, para que você possa 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 AWS IoT Greengrass Core por trás de um proxy ou usando um módulo de segurança de hardware (HSM), consulteInstalar o software do AWS IoT Greengrass Core.
(Opcional) Ativar o registro no Amazon CloudWatch Logs
Para permitir que um dispositivo V2 core faça upload de registros para o Amazon CloudWatch Logs, você pode implantar o componente gerenciador AWS de registros fornecido. Você pode usar o CloudWatch Logs para visualizar os registros de componentes, para poder depurar e solucionar problemas sem acessar o sistema de arquivos do dispositivo principal. Para ter mais informações, consulte Monitore AWS IoT Greengrass os registros.
Etapa 2: criar e implantar AWS IoT Greengrass V2 componentes para migrar aplicativos AWS IoT Greengrass V1
Você pode executar a maioria dos AWS IoT Greengrass V1 aplicativos em AWS IoT Greengrass V2. Você pode importar funções do Lambda como componentes que são executados em AWS IoT Greengrass V2, e você pode usar componentes AWS fornecidos que oferecem a mesma funcionalidade dos conectores. AWS IoT Greengrass
Você também pode desenvolver componentes personalizados para criar qualquer recurso ou tempo de execução nos dispositivos principais do Greengrass. Para obter informações sobre como desenvolver e testar componentes localmente, consulteCrie AWS IoT Greengrass componentes.
Tópicos
Importar funções V1 Lambda
Você pode importar funções do Lambda como AWS IoT Greengrass V2 componentes. Escolha entre as seguintes abordagens:
-
O Import V1 Lambda funciona diretamente como componentes do Greengrass.
-
Atualize suas funções do Lambda para usar as bibliotecas do Greengrass na AWS IoT Device SDK v2 e, em seguida, importe as funções do Lambda como componentes do Greengrass.
-
Crie componentes personalizados que usam código não Lambda e a AWS IoT Device SDK v2 para implementar a mesma funcionalidade das suas funções do Lambda.
Se sua função Lambda usa recursos, como gerenciador de stream ou segredos locais, você deve definir dependências nos componentes AWS fornecidos que empacotam esses recursos. Quando você implanta o componente da função Lambda, a implantação também inclui o componente para cada recurso que você define como uma dependência. Na implantação, você pode configurar parâmetros, como quais segredos implantar no dispositivo principal. Nem todos os recursos da V1 exigem uma dependência de componente para sua função Lambda na V2. A lista a seguir descreve como usar os recursos da V1 em seu componente de função Lambda da V2.
-
Acesse outros AWS serviços
Se sua função Lambda usa AWS credenciais para fazer solicitações a outros AWS serviços, a função de troca de tokens do dispositivo principal deve permitir que o dispositivo principal execute AWS as operações que a função Lambda usa. Para ter mais informações, consulte Autorize os dispositivos principais a interagir com os serviços AWS.
-
Gerenciador de streams
Se sua função Lambda usa o gerenciador de stream, especifique
aws.greengrass.StreamManagercomo uma dependência de componente ao importar a função. Ao implantar o componente do gerenciador de fluxo, especifique os parâmetros do gerenciador de fluxo a serem definidos para os dispositivos principais de destino. A função de troca de tokens do dispositivo principal deve permitir que o dispositivo principal acesse os Nuvem AWS destinos que você usa com o gerenciador de streaming. Para ter mais informações, consulte Gerenciador de fluxo. -
Segredos locais
Se sua função Lambda usa segredos locais, especifique
aws.greengrass.SecretManagercomo uma dependência de componente ao importar a função. Ao implantar o componente gerenciador de segredos, especifique os recursos secretos a serem implantados nos dispositivos principais de destino. A função de troca de tokens do dispositivo principal deve permitir que o dispositivo principal recupere os recursos secretos a serem implantados. Para ter mais informações, consulte Gerente secreto.Ao implantar seu componente de função Lambda, configure-o para ter uma política de autorização de IPC que conceda permissão para usar a operação de GetSecretValue IPC na V2. AWS IoT Device SDK
-
Sombras locais
Se sua função Lambda interagir com sombras locais, você deverá atualizar o código da função Lambda para usar a V2. AWS IoT Device SDK Você também deve especificar
aws.greengrass.ShadowManagercomo uma dependência de componente ao importar a função. Para ter mais informações, consulte Interaja com as sombras do dispositivo.Ao implantar seu componente de função Lambda, configure-o para ter uma política de autorização de IPC que conceda permissão para usar as operações de IPC paralelas na V2. AWS IoT Device SDK
-
Assinaturas
-
Se sua função Lambda assinar mensagens de uma fonte na nuvem, especifique essas assinaturas como fontes de eventos ao importar a função.
-
Se sua função Lambda assinar mensagens de outra função Lambda, ou se sua função Lambda publicar mensagens em ou AWS IoT Core outras funções do Lambda, configure e implante o componente legado do roteador de assinatura ao implantar sua função Lambda. Ao implantar o componente legado do roteador de assinatura, especifique as assinaturas que a função Lambda usa.
nota
O componente antigo do roteador de assinatura é necessário somente se sua função Lambda usar a
publish()função no SDK AWS IoT Greengrass principal. Se você atualizar o código da função Lambda para usar a interface de comunicação entre processos (IPC) na AWS IoT Device SDK V2, não precisará implantar o componente legado do roteador de assinatura. Para obter mais informações, consulte os seguintes serviços de comunicação entre processos: -
Se sua função Lambda assinar mensagens de dispositivos conectados locais, especifique essas assinaturas como fontes de eventos ao importar a função. Você também deve configurar e implantar o componente de ponte MQTT para retransmitir mensagens dos dispositivos conectados para os tópicos locais de publicação/assinatura que você especifica como fontes de eventos.
-
Se sua função Lambda publicar mensagens em dispositivos conectados locais, você deverá atualizar o código da função Lambda para usar a 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 sua função Lambda em contêiner acessa volumes ou dispositivos locais, especifique esses volumes e dispositivos ao importar a função Lambda. Esse recurso não exige uma dependência de componente.
Para ter mais informações, consulte Executar AWS Lambda funções.
Use conectores V1
Você pode implantar componentes AWS fornecidos que oferecem a mesma funcionalidade de alguns AWS IoT Greengrass conectores. Ao criar a implantação, você pode configurar os parâmetros dos conectores.
Os AWS IoT Greengrass V2 componentes a seguir fornecem a funcionalidade do conector Greengrass V1:
Execute contêineres Docker
AWS IoT Greengrass V2 não fornece um componente para substituir diretamente o conector de implantação do aplicativo V1 Docker. No entanto, você pode usar o componente do gerenciador de aplicativos Docker para baixar 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 Gerenciador de aplicativos Docker e Execute um contêiner Docker.
Execute inferência de aprendizado de máquina
AWS IoT Greengrass V2 fornece um componente do Amazon SageMaker Edge Manager que instala o agente do Amazon SageMaker Edge Manager e permite que você use modelos SageMaker compilados pelo NEO como componentes do modelo nos dispositivos principais do Greengrass. AWS IoT Greengrass V2 também fornece componentes que instalam o Deep Learning Runtime
Conecte dispositivos Greengrass V1
Os dispositivos conectados em AWS IoT Greengrass V1 são chamados de dispositivos cliente em AWS IoT Greengrass V2. AWS IoT Greengrass V2 o suporte para dispositivos cliente é compatível com versões anteriores AWS IoT Greengrass V1, portanto, você pode conectar dispositivos cliente V1 a dispositivos principais V2 sem alterar o código do aplicativo. Para permitir que os dispositivos cliente se conectem a um dispositivo central V2, implante componentes do Greengrass que habilitem o suporte ao dispositivo cliente e associe os dispositivos cliente ao dispositivo principal. Para retransmitir mensagens entre dispositivos cliente, o serviço de AWS IoT Core nuvem e os componentes do Greengrass (incluindo funções Lambda), implante e configure o componente de ponte MQTT. Você pode implantar o componente detector de IP para detectar automaticamente as informações de conectividade ou gerenciar manualmente os endpoints. Para ter mais informações, consulte Interaja com dispositivos IoT locais.
Ativar o serviço paralelo local
Em AWS IoT Greengrass V2, o serviço paralelo local é implementado pelo componente gerenciador AWS de sombra fornecido. AWS IoT Greengrass V2 também inclui suporte para sombras nomeadas. Para permitir que seus componentes interajam com sombras locais e sincronizem estados de sombra AWS IoT Core, configure e implante o componente do gerenciador de sombras e use as operações IPC de sombra no código do componente. Para ter mais informações, consulte Interaja com as sombras do dispositivo.
Integre com AWS IoT SiteWise
Se você usa seu dispositivo V1 core como AWS IoT SiteWise gateway, siga as instruções para configurar seu novo dispositivo V2 core como gateway. AWS IoT SiteWise AWS IoT SiteWise fornece um script de instalação que implanta os AWS IoT SiteWise componentes para você.
Etapa 3: teste seus AWS IoT Greengrass V2 aplicativos
Depois de criar e implantar componentes V2 em seu novo dispositivo V2 core, verifique se seus aplicativos atendem às suas expectativas. Você pode verificar os registros do dispositivo para ver as mensagens de saída padrão (stdout) e erro padrão (stderr) de seus componentes. Para ter mais informações, consulte Monitore AWS IoT Greengrass os registros.
Se você implantou a CLI do Greengrass no dispositivo principal, poderá usá-la para depurar componentes e suas configurações. Para ter mais informações, consulte Comandos da CLI do Greengrass.
Depois de verificar se seus aplicativos funcionam em um dispositivo V2 core, você pode implantar os componentes do Greengrass do seu aplicativo em outros dispositivos principais. Se você desenvolveu componentes personalizados que executam processos nativos ou contêineres Docker, você deve primeiro publicar esses componentes no AWS IoT Greengrass serviço para implantá-los em outros dispositivos principais.
