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.

Atualizações OTA do software do AWS IoT Greengrass Core

O pacote de software de núcleo do AWS IoT Greengrass inclui um atendente de atualização que pode executar atualizações OTA (over-the-air) do software do AWS IoT Greengrass. Você pode usar atualizações OTA para instalar a versão mais recente do software de núcleo do AWS IoT Greengrass ou do software do atendente de atualizações OTA em um ou mais núcleos. Com as atualizações OTA, seus dispositivos principais não precisam estar fisicamente presentes.

É recomendável usar atualizações OTA quando possível. Elas fornecem um mecanismo que você pode usar para rastrear o status da atualização e o histórico de atualizações. Se ocorrer uma atualização com falha, o atendente de atualizações OTA reverterá para a versão anterior do software.

As atualizações OTA são mais eficientes para:

Esse atributo se integra aos Trabalhos do AWS IoT.

Requisitos

Os seguintes requisitos se aplicam às atualizações OTA do software do AWS IoT Greengrass.

Permissões do IAM para atualizações OTA

Quando o AWS IoT Greengrass libera uma nova versão do software do núcleo do AWS IoT Greengrass, o AWS IoT Greengrass atualiza os artefatos de software armazenados no Amazon S3 que são usados para a atualização OTA.

Sua Conta da AWS deve incluir uma função de assinante de URL do Amazon S3 que possa ser usada para acessar esses artefatos. A função deve ter uma política de permissões que permita a ação s3:GetObject nos buckets nas Região da AWSs de destino. A função também deve ter uma política de confiança que permita que o iot.amazonaws.com assuma a função como uma entidade confiável.

Além disso, o usuário que inicia uma atualização OTA deve ter permissões para usar greengrass:CreateSoftwareUpdateJob e iot:CreateJob e para usar iam:PassRole para passar as permissões da função de assinante. Veja a seguir um exemplo de política do 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"
        }
    ]
}

Considerações

Antes de iniciar uma atualização OTA do software de núcleo do Greengrass, esteja ciente do impacto sobre os dispositivos no seu grupo do Greengrass, tanto no dispositivo de núcleo quanto nos dispositivos cliente conectados localmente a esse núcleo:

As seguintes informações de estado são preservadas durante a atualização OTA:

Agente de atualizações OTA do Greengrass

O atendente de atualizações OTA do Greengrass é o componente de software do dispositivo que processa as tarefas de atualização criadas e implantadas na nuvem. O atendente de atualizações OTA é distribuído no mesmo pacote de software que o software de núcleo do AWS IoT Greengrass. O atendente está localizado em /greengrass-root/ota/ota_agent/ggc-ota. Ele grava logs em /var/log/greengrass/ota/ggc_ota.txt.

É possível iniciar o atendente de atualizações OTA executando o binário manualmente ou integrando-o como parte de um script init, como um arquivo de serviço systemd. Se você executar o binário manualmente, ele deverá ser executado como root. Quando ele começa, o atendente de atualizações OTA para AWS IoT Greengrass escuta trabalhos de atualização de software do AWS IoT Core e os executa sequencialmente. O atendente de atualizações OTA do Greengrass ignora todos os outros tipos de trabalho AWS IoT.

O trecho a seguir mostra um exemplo de um arquivo de serviço systemd para iniciar, parar e reiniciar o atendente de atualizações OTA:

[Unit]
Description=Greengrass OTA Daemon

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

[Install]
WantedBy=multi-user.target

Um núcleo que é o destino de uma atualização não deve executar duas instâncias do atendente de atualizações OTA. Isso faz com que os dois atendente s processem as mesmas tarefas, o que cria conflitos.

Integração com sistemas Init

Durante uma atualização OTA, o atendente de atualizações OTA reinicia os binários no dispositivo de núcleo. Se os binários estiverem em execução, isso poderá causar conflitos quando um sistema init estiver monitorando o estado do software de núcleo do AWS IoT Greengrass ou do atendente durante a atualização. Para ajudar a integrar o mecanismo de atualização OTA às suas estratégias de monitoramento, grave scripts de shell que são executados antes e depois de uma atualização. Por exemplo, você pode usar o script ggc_pre_update.sh para fazer backup de dados ou interromper processos antes que o dispositivo seja desligado.

Para instruir o atendente de atualizações OTA a executar esses scripts, é necessário incluir o sinalizador "managedRespawn" : true no arquivo config.json. Essa configuração é mostrada no seguinte trecho:

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

Respawn gerenciado com atualizações OTA

Os requisitos a seguir se aplicam às atualizações do OTA com o managedRespawn definido como true:

O atendente de atualizações OTA executa os scripts a partir do /greengrass-root/usr/scripts. A árvore de diretórios deve ser semelhante a:

<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

Se managedRespawn estiver definido como true, o atendente de atualizações OTA verificará o diretório /greengrass-root/usr/scripts para localizar esses scripts antes e depois da atualização de software. Se os scripts não existirem, a atualização falhará. AWS IoT Greengrass não validará o conteúdo desses scripts. Como prática recomendada, verifique se seus scripts funcionam corretamente e emita códigos de saída apropriados para os erros.

Criar uma atualização OTA

Siga estas etapas para executar uma atualização OTA do software do AWS IoT Greengrass em um ou mais núcleos:

API CreateSoftwareUpdateJob

Você pode usar a API CreateSoftwareUpdateJob para atualizar o software AWS IoT Greengrass Core ou o software do atendente de atualizações OTA em seus dispositivos de núcleo. Essa API cria um trabalho de snapshot do AWS IoT que notifica os dispositivos quando uma atualização está disponível. Depois de chamar CreateSoftwareUpdateJob, você pode usar outros comandos de trabalho do AWS IoT para controlar a atualização de software. Para obter mais informações, consulte Trabalhos no Guia do desenvolvedor do AWS IoT.

O exemplo a seguir mostra como usar a AWS CLI para criar um trabalho que atualiza o software de núcleo do AWS IoT Greengrass em um dispositivo de 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

O comando create-software-update-job retorna uma resposta JSON que contém o ID do trabalho, o ARN do trabalho e a versão do software que foi instalada pela atualização:

{
    "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 obter as etapas que mostram como usar create-software-update-job para atualizar um dispositivo de núcleo, consulte Criar uma atualização OTA.

O comando create-software-update-job tem os seguintes parâmetros: