Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
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 AWS IoT Greengrass grupos para um AWS IoT Greengrass core
Use AWS IoT Greengrass grupos para organizar entidades em seu ambiente de borda. 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](gg-core.md), que é um AWS IoT dispositivo que executa o software AWS IoT Greengrass Core. O núcleo atua como um gateway de borda e fornece AWS IoT Core recursos no ambiente de borda. Dependendo da sua necessidade de negócios, também é possível adicionar as seguintes entidades a um grupo:
+ **Dispositivos cliente**. Representados como coisas no registro do AWS IoT . Esses dispositivos devem executar o [FreeRTOS](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-lib-gg-connectivity.html) ou usar o [SDK AWS IoT de dispositivo](what-is-gg.md#iot-device-sdk) ou a [API de descoberta do AWS IoT Greengrass](gg-discover-api.md) para obter informações de conexão para o núcleo. Somente dispositivos cliente membros do grupo podem se conectar ao núcleo.
+ **Funções Lambda**. User-defined aplicativos sem servidor que executam código no núcleo. As funções Lambda são criadas AWS Lambda e referenciadas a partir de um grupo do Greengrass. Para obter mais informações, consulte [Execute funções Lambda no AWS IoT Greengrass core](lambda-functions.md).
+ **Conectores**. Aplicativos com tecnologia sem servidor predefinidos que executam código no núcleo. Os conectores podem fornecer integração integrada com infraestrutura local AWS, protocolos de dispositivos e outros serviços em nuvem. Para obter mais informações, consulte [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md).
+ **Assinaturas**. Define os editores, os assinantes e os tópicos MQTT (ou assuntos) autorizados para comunicação MQTT.
+ **Recursos**. Referências a [dispositivos e volumes](access-local-resources.md) locais, [modelos de machine learning](ml-inference.md) e [segredos](secrets.md), usados para controle de acesso por conectores e funções do Lambda do Greengrass.
+ **Logs**. Configurações de registro para componentes AWS IoT Greengrass do sistema e funções Lambda. Para obter mais informações, consulte [Monitoramento com AWS IoT Greengrass logs](greengrass-logs-overview.md).
Você gerencia seu grupo Greengrass no Nuvem AWS e depois 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`.
**nota**
Durante uma implantação, o processo de daemon do Greengrass no dispositivo de núcleo é interrompido e, depois, reiniciado.
## Implantando grupos do AWS IoT console
Você pode implantar um grupo e gerenciar suas implantações na página de configuração do grupo no AWS IoT console.
**nota**
Para abrir essa página no console, selecione **Dispositivos Greengrass**, depois, **Grupos (V1)** e, em **Grupos do Greengrass**, selecione seu grupo.
**Para implantar a versão atual do grupo**
+ Na página de configuração do grupo, selecione **Implantar**.
**Para visualizar o histórico de implantações do grupo**
O histórico de implantações de um grupo inclui a data e a hora, a versão do grupo e o status de cada tentativa de implantação.
1. Na página de configuração do grupo, selecione a guia **Implantações**.
1. Para ver mais informações sobre uma implantação, incluindo mensagens de erro, escolha **Implantações** no AWS IoT console, em Dispositivos **Greengrass**.
**Como reimplantar uma implantação de grupo**
Você poderá querer reimplantar uma implantação se a implantação atual falhar ou reverter para uma versão de grupo diferente.
1. No AWS IoT console, escolha **dispositivos Greengrass** e, em seguida, escolha **Grupos (V1**).
1. Selecione a guia **Implantações**.
1. Selecione a implantação que você deseja reimplantar e, em seguida selecione **Reimplantar**.
**Para redefinir implantações do grupo**
Você pode querer redefinir implantações do grupo para mover ou excluir um grupo ou para remover as informações de implantação. Para obter mais informações, consulte [Redefinir implantações](reset-deployments-scenario.md).
1. No AWS IoT console, escolha **dispositivos Greengrass** e, em seguida, escolha **Grupos (V1**).
1. Selecione a guia **Implantações**.
1. Selecione a implantação que você deseja redefinir e, em seguida selecione **Redefinir implantações**.
## Implantando grupos com o AWS IoT Greengrass solicitações de
A AWS IoT Greengrass API fornece as seguintes ações para implantar AWS IoT Greengrass grupos e gerenciar implantações em grupo. Você pode chamar essas ações a AWS CLI partir da AWS IoT Greengrass API ou do AWS SDK.
| Ação | Description |
| --- | --- |
| [CreateDeployment](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) | Cria uma implantação `NewDeployment` ou `Redeployment`.
Você poderá querer reimplantar uma implantação se a implantação atual falhar. Ou você pode querer reimplantar para reverter para uma versão de grupo diferente. |
| [GetDeploymentStatus](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html) | Retorna o status de uma implantação: `Building`, `InProgress`, `Success` ou `Failure`.
Você pode configurar EventBridge eventos da Amazon para receber notificações de implantação. Para obter mais informações, consulte [Obter notificações de implantação](deployment-notifications.md). |
| [ListDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | Retorna o histórico de implantações do grupo. |
| [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) | Redefine as implantações do grupo.
Você pode querer redefinir implantações do grupo para mover ou excluir um grupo ou para remover as informações de implantação. Para obter mais informações, consulte [Redefinir implantações](reset-deployments-scenario.md). |
**nota**
Para obter informações sobre operações de implantação em massa, consulte [Criar implantações em massa para grupos](bulk-deploy-cli.md).
### Obter o ID do grupo
O ID do grupo é normalmente usado em ações da API. Você pode usar a [ListGroups](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html)ação para encontrar o ID do grupo-alvo na sua lista de grupos. Por exemplo, no AWS CLI, use o `list-groups` comando.
```
aws greengrass list-groups
```
Você também pode incluir a opção `query` para filtrar resultados. Por exemplo:
+ Para obter o último grupo criado:
```
aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
```
+ Para obter um grupo pelo nome:
```
aws greengrass list-groups --query "Groups[?Name=='{{MyGroup}}']"
```
Os nomes de grupo não precisam ser exclusivos, portanto, vários grupos podem ser retornados.
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](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html).
**nota**
Você também pode encontrar esses valores no AWS IoT console. O ID do grupo é exibido na página **Settings (Configurações)** do grupo. Os IDs de versão do grupo são exibidos na guia **Implantações** do grupo.
```
{
"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 um Região da AWS, AWS CLI os comandos usarão a região padrão do seu perfil. Para devolver grupos em uma região diferente, inclua a {{region}} opção. Por exemplo:
```
aws greengrass list-groups --region us-east-1
```
## Visão geral do AWS IoT Greengrass modelo de objeto de grupo
Ao programar com a AWS IoT Greengrass API, é útil entender o modelo de objetos de grupo do Greengrass.
### Groups (Grupos)
Na AWS IoT Greengrass API, o `Group` objeto de nível superior consiste em metadados e uma lista de `GroupVersion` objetos. `GroupVersion`os objetos são associados a um `Group` by 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:
+ Ao `CoreDefinitionVersion` que contém o núcleo necessário.
+ Ao `FunctionDefinitionVersion` que contém as três funções.
+ Ao `DeviceDefinitionVersion` que contém o dispositivo cliente.
+ Ao `SubscriptionDefinitionVersion` que contém as duas assinaturas.
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:
+ Uma *definição* que faz referência a uma lista de *DefinitionVersion*objetos de um determinado tipo. Por exemplo, um `DeviceDefinition` faz referência a uma lista de objetos `DeviceDefinitionVersion`.
+ Um *DefinitionVersion*que contém um conjunto de entidades de um determinado tipo. Por exemplo, um `DeviceDefinitionVersion` contém uma lista de objetos `Device`.
+ Entidades individuais que definem suas propriedades e seu comportamento. Por exemplo, a `Device` define o ARN do dispositivo cliente correspondente no AWS IoT registro, o ARN de seu certificado de dispositivo e se sua sombra local é sincronizada automaticamente com a nuvem.
É possível adicionar os seguintes tipos de entidades a um grupo:
+ [Conector](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connector.html)
+ [Serviços](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-core.html)
+ [Dispositivo](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-device.html)
+ [Função](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-function.html)
+ [Logger](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html)
+ [Recurso](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-resource.html)
+ [Assinatura](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-subscription.html)
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 AWS IoT Greengrass API, 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 *DefinitionVersion*objetos que contenham entidades novas ou atualizadas.
Você pode associar novos *DefinitionVersions*objetos 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 *DefinitionVersion*objetos 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, uma [função de serviço do Greengrass](service-role.md) deve estar associada à sua Conta da AWS no Região da AWS local em que você está implantando o. `GroupVersion`
**nota**
As ações `Update` na API são usadas para alterar o nome de um `Group` ou de um objeto *Definition* do componente.
**Atualizando entidades que fazem referência a AWS recursos**
As funções e os [recursos secretos do Greengrass Lambda definem Greengrass-specific propriedades e também fazem referência aos recursos](secrets.md) correspondentes. AWS Para atualizar essas entidades, você pode fazer alterações no AWS recurso correspondente em vez de seus objetos do Greengrass. Por exemplo, as funções Lambda fazem referência a uma função AWS Lambda e também definem o ciclo de vida e outras propriedades específicas do grupo Greengrass.
+ Para atualizar o código da função do Lambda ou as dependências empacotadas, faça as alterações no AWS Lambda. Durante a próxima implantação do grupo, essas alterações serão recuperadas AWS Lambda e copiadas para seu ambiente local.
+ Para atualizar [Greengrass-specific as propriedades](lambda-group-config.md), você cria uma `FunctionDefinitionVersion` que contém as `Function` propriedades atualizadas.
**nota**
As funções do Lambda do Greengrass podem fazer referência a uma função do Lambda pelo ARN do alias ou da versão. Se você fizer referência ao ARN do alias (recomendado), não será necessário atualizar o `FunctionDefinitionVersion` (ou o `SubscriptionDefinitionVersion`) ao publicar uma nova versão da função no AWS Lambda. Para obter mais informações, consulte [Referência de funções do Lambda por alias ou versão](lambda-functions.md#lambda-versions-aliases).
## Consulte também
+ [Obter notificações de implantação](deployment-notifications.md)
+ [Redefinir implantações](reset-deployments-scenario.md)
+ [Criar implantações em massa para grupos](bulk-deploy-cli.md)
+ [Solução de problemas de implantação](gg-troubleshooting.md#gg-troubleshooting-deploymentissues)
+ [AWS IoT Greengrass Version 1 API Reference](https://docs.aws.amazon.com/greengrass/v1/apireference/)
+ [AWS IoT Greengrass comandos](https://docs.aws.amazon.com/cli/latest/reference/greengrass/index.html) na *Referência de AWS CLI Comandos*