AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

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

Implantar grupos do AWS IoT Greengrass em um núcleo do AWS IoT Greengrass

Use grupos do AWS IoT Greengrass para organizar entidades no ambiente periférico. Você também pode usar os grupos para controlar como as entidades no grupo interagem entre si e com a Nuvem AWS. Por exemplo, somente as funções do Lambda no grupo são implantadas para execução local e somente os dispositivos no grupo podem se comunicar usando o servidor MQTT local.

Um grupo deve incluir um núcleo, que é um dispositivo do AWS IoT que executa o software de núcleo do AWS IoT Greengrass. O núcleo atua como um gateway de borda e fornece recursos do AWS IoT Core no ambiente de borda. Dependendo da sua necessidade de negócios, também é possível adicionar as seguintes entidades a um grupo:

Você gerencia o grupo do Greengrass na Nuvem AWS e o implanta em um núcleo. A implantação copia a configuração do grupo para o arquivo group.json no dispositivo de núcleo. Esse arquivo está localizado em greengrass-root/ggc/deployments/group.

Implantando grupos usando o console do AWS IoT

É possível implantar um grupo e gerenciar suas implantações na página de configuração do grupo no console do AWS IoT.

Implantar grupos com a API do AWS IoT Greengrass

A API do AWS IoT Greengrass fornece as seguintes ações para implantar grupos do AWS IoT Greengrass e gerenciar implantações do grupo. É possível chamar essas ações pela AWS CLI, pela API do AWS IoT Greengrass ou pelo AWS SDK.

Obter o ID do grupo

O ID do grupo é normalmente usado em ações da API. Você pode usar a ListGroupsação para encontrar o ID do grupo-alvo na sua lista de grupos. Por exemplo, na AWS CLI, use o comando list-groups.

aws greengrass list-groups

Você também pode incluir a opção query para filtrar resultados. Por exemplo: .

Esta é uma resposta de exemplo do list-groups. As informações de cada grupo incluem o ID do grupo (na propriedade do Id) e o ID da versão mais recente do grupo (na propriedade da LatestVersion). Para obter outras IDs de versão de um grupo, use a ID do grupo com ListGroupVersions.

{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

Se você não especificar uma região da Região da AWS, os comandos da AWS CLI usarão a região padrão do seu perfil. Para retornar grupos em uma região diferente, inclua a opção region . Por exemplo: .

aws greengrass list-groups --region us-east-1

Visão geral do modelo de objeto de grupo do AWS IoT Greengrass

Ao programar com a API do AWS IoT Greengrass, é útil compreender o modelo de objeto de grupo do Greengrass.

Grupos

Na API do AWS IoT Greengrass, o objeto Group de nível superior consiste em metadados e uma lista de objetos GroupVersion. Os objetos GroupVersion são associados a um Group por ID.

Versões do grupo

Os objetos GroupVersion definem a associação ao grupo. Cada GroupVersion faz referência a um CoreDefinitionVersion e a outras versões de componente por ARN. Essas referências determinam quais entidades devem ser incluídas no grupo.

Por exemplo, para incluir três funções do Lambda, um dispositivo e duas assinaturas no grupo, o GroupVersion faz referência:

O GroupVersion implantado em um dispositivo de núcleo determina as entidades que estão disponíveis no ambiente local e como elas podem interagir.

Componentes do grupo

Os componentes que você adiciona a grupos têm uma hierarquia de três níveis:

O exemplo DeviceDefinition a seguir faz referência a três objetos DeviceDefinitionVersion, cada um contendo vários objetos Device. Somente um DeviceDefinitionVersion de cada vez é usado em um grupo.

Atualizar grupos

Na API do AWS IoT Greengrass, você usa versões para atualizar a configuração de um grupo. As versões são imutáveis, portanto, para adicionar, remover ou alterar componentes do grupo, você deve criar DefinitionVersionobjetos que contenham entidades novas ou atualizadas.

Você pode associar novos DefinitionVersionsobjetos a objetos de definição novos ou existentes. Por exemplo, é possível usar a ação CreateFunctionDefinition para criar um FunctionDefinition que inclui o FunctionDefinitionVersion como uma versão inicial ou usar a ação CreateFunctionDefinitionVersion e fazer referência a um FunctionDefinition existente.

Depois de criar os componentes do grupo, você cria um GroupVersion que contém todos os DefinitionVersionobjetos que você deseja incluir no grupo. Depois, implante o GroupVersion.

Para implantar um GroupVersion, ele deve fazer referência a um CoreDefinitionVersion que contenha exatamente um Core. Todas as entidades referenciadas devem ser membros do grupo. Além disso, um perfil de serviço do Greengrass deve ser associado à sua Conta da AWS na Região da AWS onde você está implantando o GroupVersion.

Atualizando entidades que fazem referência a recursos da AWS

As funções do Lambda do Greengrass e os recursos secretos definem propriedades específicas do Greengrass e também fazem referência a recursos correspondentes da AWS. Para atualizar essas entidades, você pode fazer alterações no recurso da AWS correspondente em vez de nos objetos do Greengrass. Por exemplo, as funções do Lambda fazem referência a uma função no AWS Lambda e também definem o ciclo de vida e outras propriedades que são específicas do grupo do Greengrass.

Consulte também