Redefinir implantações - AWS IoT Greengrass
Redefinir implantações do console do AWS IoTRedefinir implantações com a API do AWS IoT GreengrassConsulte também

O 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, o AWS IoT Greengrass V1 não lançará atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam com o 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 adicionará novos recursos significativos e suporte para plataformas adicionais.

Redefinir implantações

Esse atributo está disponível para o AWS IoT Greengrass Core v1.1 e posterior.

Você pode querer redefinir as implantações de um grupo para:

  • Exclua o grupo, por exemplo, quando você quiser mover o núcleo do grupo para outro grupo ou se o núcleo do grupo tiver sido recriado. Antes de excluir um grupo, você deve redefinir as implantações do grupo para usar o núcleo com outro grupo do Greengrass.

  • Mover o núcleo do grupo para um grupo diferente.

  • Reverter o grupo para seu estado antes de qualquer implantação.

  • Remover a configuração de implantação do dispositivo de núcleo.

  • Excluir dados confidenciais do dispositivo de núcleo ou da nuvem.

  • Implantar um novo grupo de configuração em um núcleo sem a necessidade de substituir o núcleo por outro no grupo atual.

nota

A funcionalidade de redefinição de implantações não está disponível no software de núcleo do AWS IoT Greengrass v1.0.0. Não é possível excluir um grupo que foi implantado usando a v1.0.0.

A operação de redefinição de implantações primeiro limpa todas as informações de implantação armazenadas na nuvem para determinado grupo. Depois, ele também instrui o dispositivo de núcleo do grupo a limpar todas as informações relacionadas à implantação (funções do função do Lambda, logs de usuário, banco de dados shadow e certificado do servidor, mas não o config.json definido pelo usuário nem os certificados de núcleo do Greengrass). Não é possível iniciar uma redefinição de implantações para um grupo se o grupo tiver, no momento, uma implantação com o status In Progress ou Building.

Redefinir implantações do console do AWS IoT

É possível redefinir implantações do grupo na página de configuração do console AWS IoT.

  1. No painel de navegação do console de AWS IoT, em Gerenciar, expanda Dispositivos Greengrass e, em seguida selecione Grupos (V1).

  2. Selecione o grupo de destino.

  3. Na guia Implantações, selecione Redefinir implantações.

  4. Na caixa de diálogo Redefinir implantações para este grupo do Greengrass, digite confirm para concordar e selecione Redefinir implantação.

Redefinir implantações com a API do AWS IoT Greengrass

É possível usar a ação ResetDeployments na AWS CLI, na API do AWS IoT Greengrass ou no AWS SDK para redefinir as implantações. Os exemplos deste tópico usam a CLI.

aws greengrass reset-deployments --group-id GroupId [--force]
Argumentos do comando reset-deployments da CLI:
--group-id

O ID do grupo. Use o comando list-groups para obter esse valor.

--force

Opcional. Use esse parâmetro se o dispositivo de núcleo do grupo foi perdido, roubado ou destruído. Essa opção faz com que o processo de implantação de redefinição relate êxito depois que todas as informações de implantação na nuvem tiverem sido limpas, sem esperar que um dispositivo de núcleo responda. No entanto, se o dispositivo de núcleo estiver ou se tornar ativo, ele também executará operações de limpeza.

A saída do comando reset-deployments da CLI tem a seguinte aparência:

{
    "DeploymentId": "4db95ef8-9309-4774-95a4-eea580b6ceef",
    "DeploymentArn": "arn:aws:greengrass:us-west-2:106511594199:/greengrass/groups/b744ed45-a7df-4227-860a-8d4492caa412/deployments/4db95ef8-9309-4774-95a4-eea580b6ceef"
}

Você pode verificar o status da implantação de redefinição com comando get-deployment-status da CLI:

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
Argumentos do comando get-deployment-status da CLI:
--deployment-id

O ID da implantação.

--group-id

O ID do grupo.

A saída do comando get-deployment-status da CLI tem a seguinte aparência:

{
    "DeploymentStatus": "Success",
    "UpdatedAt": "2017-04-04T00:00:00.000Z"
}

O DeploymentStatus é definido como Building quando a implantação de redefinição está sendo preparada. Quando a implantação de redefinição estiver pronta, mas o núcleo AWS IoT Greengrass não tiver capturado a implantação de redefinição, o DeploymentStatus será InProgress.

Se a operação de redefinição falhar, as informações de erro serão retornados na resposta.

Consulte também