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.

Actualizaciones de OTA para el software AWS IoT Greengrass Core

El paquete del software AWS IoT Greengrass Core incluye un agente de actualización que puede realizar actualizaciones transparentes (OTA) del software AWS IoT Greengrass. Puede utilizar las actualizaciones OTA para instalar la última versión del software AWS IoT Greengrass Core o del software de agente de actualización OTA en uno o más núcleos. Con las actualizaciones OTA, no es necesario que los dispositivos del núcleo estén físicamente presentes.

Le recomendamos que utilice las actualizaciones OTA cuando sea posible. Proporcionan un mecanismo que puede utilizar para realizar un seguimiento del estado de la actualización y del historial de actualizaciones. Si se produce un error en la actualización, el agente de actualización de OTA vuelve a la versión de software anterior.

Las actualizaciones OTA hacen que sea más eficiente:

Esta característica se integra con trabajos de AWS IoT.

Requisitos

Los siguientes requisitos se aplican a las actualizaciones OTA del software AWS IoT Greengrass.

Permisos de IAM para actualizaciones OTA

Cuando AWS IoT Greengrass lanza una nueva versión del software AWS IoT Greengrass Core, AWS IoT Greengrass actualiza los artefactos de software almacenados en Amazon S3 que se utilizan para la actualización OTA.

Su cuenta de Cuenta de AWS debe incluir un rol de firmante de URL de Amazon S3 que pueda utilizarse para acceder a estos artefactos. El rol debe tener una política de permisos que permita la acción s3:GetObject en los buckets de las Región de AWS de destino. El rol también debe tener una política de confianza que permita a iot.amazonaws.com asumir el rol como una entidad de confianza.

Además, el usuario que inicia una actualización OTA debe tener permisos para usar greengrass:CreateSoftwareUpdateJob y iot:CreateJob, y para usar iam:PassRole para transferir los permisos del rol de firmante. A continuación se muestra un ejemplo de política de IAM.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

Consideraciones

Antes de lanzar una actualización OTA del software Greengrass Core, tenga en cuenta el impacto en los dispositivos de su grupo de Greengrass, tanto en el dispositivo del núcleo como en los dispositivos cliente conectados localmente a ese dispositivo del núcleo:

La siguiente información de estado se guarda durante una actualización OTA:

Agente de actualización de OTA para Greengrass

El agente de actualización de OTA de Greengrass es el componente de software en el dispositivo, que se encarga de actualizar los trabajos creados e implementados en la nube. El agente de actualización de OTA se distribuye en el mismo paquete de software que el software AWS IoT Greengrass Core. El agente se encuentra en /greengrass-root/ota/ota_agent/ggc-ota. Escribe registros en /var/log/greengrass/ota/ggc_ota.txt.

Puede iniciar el agente de actualización de OTA mediante la ejecución manual del binario o integrándolo como parte de un script init, por ejemplo, un archivo del servicio systemd. Si ejecuta el binario manualmente, debe ejecutarse como raíz. Cuando se inicia, el agente de actualización de OTA escucha los trabajos de actualización del software AWS IoT Greengrass desde AWS IoT Core y los ejecuta secuencialmente. El agente de actualización de OTA ignora todos los demás tipos de trabajo de AWS IoT.

El siguiente extracto muestra un ejemplo de un archivo de servicio systemd para iniciar, detener y reiniciar el agente de actualización de OTA:

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

Un núcleo que sea el destino de una actualización no debe ejecutar dos instancias del agente de actualización de OTA. Si lo hace, los dos agentes procesarán los mismos trabajos, lo que causará conflictos.

Integración con sistemas init

Durante una actualización OTA, el agente de actualización de OTA reinicia los binarios en el núcleo. Si los binarios se están ejecutando, esto puede provocar conflictos cuando un sistema init está supervisando el estado del software AWS IoT Greengrass Core o del agente durante la actualización. Para ayudarle a integrar el mecanismo de actualización OTA con sus estrategias de monitorización init, puede escribir scripts de shell que se ejecuten antes y después de una actualización. Por ejemplo, puede utilizar el script ggc_pre_update.sh para realizar copias de seguridad de los datos o detener procesos antes de que el dispositivo se apague.

Para indicar al agente de actualización de OTA que ejecute estos scripts, debe incluir la marca "managedRespawn" : true en el archivo config.json. Este ajuste se muestra en el siguiente fragmento:

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

Regeneración administrada con actualizaciones OTA

Los siguientes requisitos se aplican a las actualizaciones de OTA con managedRespawn establecidas en true:

El agente de actualización OTA ejecuta los scripts desde /greengrass-root/usr/scripts. El árbol de directorios debe ser similar al siguiente:

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

Si managedRespawn se establece en true, el agente de actualización de OTA comprueba el directorio /greengrass-root/usr/scripts de los scripts antes y después de la actualización del software. Si los scripts no existen, se produce un error en la actualización. AWS IoT Greengrass no valida el contenido de estos scripts. Como práctica recomendada, compruebe que los scripts funcionan correctamente y emita los códigos de salida adecuados para detectar errores.

Crear una actualización OTA

Siga estos pasos para realizar una actualización OTA del software AWS IoT Greengrass en uno o más núcleos:

API CreateSoftwareUpdateJob

Puede utilizar la API de CreateSoftwareUpdateJob para actualizar el software de AWS IoT Greengrass Core o el agente de actualización de OTA en los dispositivos del núcleo. Esta API crea un trabajo de instantánea de AWS IoT que notifica a los dispositivos cuando hay una actualización disponible. Después de llamar a CreateSoftwareUpdateJob, puede utilizar otros comandos de trabajo de AWS IoT para realizar un seguimiento de la actualización de software. Para obtener más información, consulte Empleos en la Guía para desarrolladores de AWS IoT.

En el siguiente ejemplo se muestra cómo usar la AWS CLI para crear un trabajo que actualiza el software AWS IoT Greengrass Core en un dispositivo del núcleo:

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

El comando create-software-update-job devuelve una respuesta JSON que contiene el ID de trabajo, el ARN del trabajo y la versión de software instalada por la actualización:

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

Para ver los pasos que muestran cómo utilizar create-software-update-job para actualizar un dispositivo del núcleo, consulte Crear una actualización OTA.

El comando create-software-update-job tiene los parámetros siguientes: