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á.
Você pode desenvolver componentes personalizados, incluindo componentes da função do Lambda, que usam o serviço paralelo local para ler e modificar documentos paralelos locais e documentos paralelos do dispositivo cliente.
Os componentes personalizados interagem com o serviço paralelo local usando as bibliotecas AWS IoT Greengrass Core IPC noAWS IoT Device SDK. O componente do gerenciador de sombras ativa o serviço paralelo local em seu dispositivo principal.
Para implantar o componente shadow manager em um dispositivo principal do Greengrass, crie uma implantação que inclua o aws.greengrass.ShadowManager
componente.
nota
Por padrão, a implantação do componente do gerenciador de sombras permite somente operações de sombra locais. Para permitir que o AWS IoT Greengrass sincronize as informações do estado da sombra das sombras do dispositivo principal ou de quaisquer sombras dos dispositivos cliente com os documentos de sombra da nuvem correspondentes no AWS IoT Core, você deve criar uma atualização de configuração para o componente do gerenciador de sombras que inclua o parâmetro synchronize
. Para ter mais informações, consulte Sincronizar sombras do dispositivo locais com o AWS IoT Core.
Recupere e modifique estados de sombra
As operações paralelas do IPC recuperam e atualizam informações de estado em documentos paralelos locais. O componente do gerenciador de sombras gerencia o armazenamento desses documentos paralelos em seu dispositivo principal.
Para modificar estados de sombra locais
-
Adicione políticas de autorização à fórmula do seu componente personalizado para permitir que o componente receba mensagens sobre tópicos paralelos locais.
Por exemplo, políticas de autorização, consulte Exemplos de políticas de autorização local de IPC paralelo.
-
Use as operações de IPC de sombra para recuperar e modificar as informações do estado de sombra. Para obter mais informações sobre o uso de operações de IPC de sombra no código do componente, consulteInteragir com sombras locais.
nota
Para permitir que um dispositivo principal interaja com as sombras do dispositivo cliente, você também deve configurar e implantar o componente de ponte MQTT. Para obter mais informações, consulte Habilitar o Gerenciador de sombras para comunicação com dispositivos cliente.
Reaja às mudanças do estado da sombra
Os componentes do Greengrass usam a interface local de publicação/assinatura para se comunicarem em um dispositivo principal. Para permitir que um componente personalizado reaja às mudanças do estado de sombra, você pode se inscrever nos tópicos locais de publicação/assinatura. Isso permite que o componente receba mensagens sobre os tópicos paralelos locais e, em seguida, aja de acordo com essas mensagens.
Os tópicos paralelos locais usam o mesmo formato dos tópicos MQTT de sombra do AWS IoT dispositivo. Para obter mais informações sobre tópicos de sombra, consulte Device Shadow MQTT topics no Guia do desenvolvedor do AWS IoT.
Para reagir às mudanças locais do estado da sombra
-
Adicione políticas de controle de acesso à fórmula do seu componente personalizado para permitir que o componente receba mensagens sobre tópicos paralelos locais.
Por exemplo, políticas de autorização, consulte Exemplos de políticas de autorização local de IPC paralelo.
-
Para iniciar uma ação personalizada em um componente, use as operações
SubscribeToTopic
IPC para assinar os tópicos paralelos nos quais você deseja receber mensagens. Para obter mais informações sobre o uso de operações IPC locais de publicação/assinatura no código do componente, consulte. Publicar/assinar mensagens locais -
Para invocar uma função do Lambda, use a configuração da fonte de eventos para fornecer o nome do tópico paralelo e especificar que é um tópico local de publicação/assinatura. Para obter informações sobre a criação de componentes de funções do Lambda, consulte Executar funções AWS Lambda..
nota
Para permitir que um dispositivo principal interaja com as sombras do dispositivo cliente, você também deve configurar e implantar o componente de ponte MQTT. Para obter mais informações, consulte Habilitar o Gerenciador de sombras para comunicação com dispositivos cliente.