Restablecimiento de implementaciones - AWS IoT Greengrass
Restablecimiento de implementaciones desde la consola de AWS IoTRestablecimiento de implementaciones con la API de AWS IoT GreengrassVéase también

AWS IoT Greengrass Version 1 entró en la fase de vida útil prolongada el 30 de junio de 2023. Para obtener más información, consulte la política de mantenimiento de AWS IoT Greengrass V1 Después de esta fecha, AWS IoT Greengrass V1 no se publicarán actualizaciones que proporcionen funciones, mejoras, correcciones de errores o parches de seguridad. Los dispositivos que se ejecuten AWS IoT Greengrass V1 no se verán afectados y seguirán funcionando y conectándose a la nube. Le recomendamos encarecidamente que migre a AWS IoT Greengrass Version 2, ya que añade importantes funciones nuevas y es compatible con plataformas adicionales.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Restablecimiento de implementaciones

Esta característica está disponible para AWS IoT Greengrass Core versión 1.1 y posteriores.

Es posible que desee restablecer las implementaciones de un grupo para:

  • Elimine el grupo, por ejemplo, cuando desee mover el núcleo del grupo a otro grupo o cuando se haya rediseñado el núcleo del grupo. Antes de eliminar un grupo, debe restablecer las implementaciones del grupo para usar el núcleo con otro grupo de Greengrass.

  • Mover el núcleo del grupo a otro grupo

  • Revertir el grupo al estado que tenía antes de la implementación.

  • Eliminar la configuración de la implementación del dispositivo del núcleo

  • Eliminar datos confidenciales del dispositivo del núcleo o de la nube

  • Implementar una nueva configuración del grupo en un núcleo sin tener que reemplazar el núcleo por otro del grupo actual

nota

La funcionalidad de restablecimiento de implementaciones no está disponible en AWS IoT Greengrass Core Software v1.0.0. No puede eliminar los grupos implementados con la versión 1.0.0.

La operación de restablecimiento primero limpia toda la información que hay en la nube sobre la implementación de un determinado grupo. A continuación, ordena al dispositivo del núcleo del grupo que borre toda la información relacionada con la implementación (funciones de Lambda, registros de usuario, base de datos de instantáneas y certificado del servidor, aunque no el archivo config.json definido por el usuario ni los certificados del núcleo de Greengrass). No se puede iniciar el restablecimiento de la implementación de un grupo si actualmente dicho grupo tiene una implementación con el estado In Progress o Building.

Restablecimiento de implementaciones desde la consola de AWS IoT

Puede restablecer una implementación de grupo desde la página de configuración del grupo de la consola de AWS IoT.

  1. En el panel de navegación de la consola AWS IoT, en Administrar, expanda los dispositivos Greengrass y, a continuación, elija Grupos (V1).

  2. Seleccione el grupo de destino.

  3. En la pestaña Implementaciones, elija Reiniciar implementación.

  4. En el cuadro de diálogo Restablecer implementaciones para este grupo de Greengrass, escriba confirm para aceptar y seleccione Restablecer implementación.

Restablecimiento de implementaciones con la API de AWS IoT Greengrass

Puede utilizar la acción ResetDeployments de la AWS CLI, la API de AWS IoT Greengrass o el SDK de AWS para restablecer las implementaciones. En los ejemplos de este tema, se utiliza la CLI.

aws greengrass reset-deployments --group-id GroupId [--force]
Argumentos del comando de la CLI reset-deployments:
--group-id

El ID del grupo. Utilice el comando list-groups para obtener este valor.

--force

Opcional. Utilice este parámetro si el dispositivo del núcleo del grupo se ha perdido, robado o destruido. Esta opción hace que el proceso de restablecimiento de la implementación notifique que se ha realizado correctamente una vez que se ha borrado toda la información de implementación de la nube, sin tener que esperar a que responda el dispositivo del núcleo. Sin embargo, si el dispositivo del núcleo está activo o se activa, también realiza operaciones de limpieza.

El resultado del comando reset-deployments de la CLI es similar al siguiente:

{
    "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"
}

Puede comprobar el estado del restablecimiento de la implementación con el comando de la CLI get-deployment-status:

aws greengrass get-deployment-status --deployment-id DeploymentId --group-id GroupId
Argumentos del comando de la CLI get-deployment-status:
--deployment-id

El ID de implementación.

--group-id

El ID del grupo.

El resultado del comando get-deployment-status de la CLI es similar al siguiente:

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

El estado de DeploymentStatus se establece en Building cuando se está preparando el restablecimiento de la implementación. Cuando el restablecimiento de la implementación está listo, pero el AWS IoT Greengrass principal aún no lo ha aplicado, el estado de DeploymentStatus es InProgress.

Si la operación de restablecimiento da un error, se devuelve la información del error en la solicitud.

Véase también