Principais conceitos sobre trabalhos

Um trabalho é uma operação remota que é enviada e executada em um ou mais dispositivos conectados à AWS IoT. Por exemplo, você pode definir um trabalho que instrui um conjunto de dispositivos a baixar e instalar um aplicativo ou executar atualizações de firmware, reinicializar, alternar certificados ou executar operações de solução de problemas remotamente.

Para criar um trabalho, você deve primeiro criar um documento de trabalho, que consiste na descrição das operações remotas a serem realizadas pelos dispositivos.

Os documentos de trabalho são documentos JSON codificados em UTF-8 e devem conter as informações das quais seus dispositivos precisam para executar um trabalho. Um documento de trabalho contém um ou mais URLs onde o dispositivo pode fazer download de uma atualização ou de outros dados. O documento de trabalho pode ser armazenado em um bucket do Amazon S3 ou ser incluído em linha com o comando que cria o trabalho.

Ao criar um trabalho, você especifica uma lista de destinos, que são os dispositivos que devem executar as operações. Os destinos podem ser objetos, grupos de objetos ou ambos. O serviço AWS IoT Jobs envia uma mensagem para cada alvo para informá-lo de que um trabalho está disponível.

Depois de criar um trabalho fornecendo o documento de trabalho e especificando sua lista de destinos, o documento de trabalho é então implantado nos dispositivos de destino remotos para os quais você deseja realizar a atualização. Para trabalhos de snapshot, o trabalho será concluído após a implantação nos dispositivos de destino. Para trabalhos contínuos, um trabalho é implantado em um grupo de dispositivos à medida que eles são adicionados aos grupos.

Uma execução de trabalho é uma instância de um trabalho em um dispositivo de destino. O destino começa a execução de um trabalho ao fazer download do documento de trabalho. Em seguida, ele executa as operações especificadas no documento e relata seu progresso para AWS IoT o. Um número de execução é um identificador exclusivo da execução de um trabalho em um destino específico. O serviço AWS IoT Jobs fornece comandos para rastrear o progresso da execução de um trabalho em um destino e o progresso de um trabalho em todos os alvos.

Por padrão, um trabalho é enviado para todos os destinos que você especifica ao criar o trabalho. Depois que esses destinos concluem o trabalho (ou relatam que não puderam concluí-lo), o trabalho está concluído.

Um trabalho contínuo é enviado a todos os destinos que você especifica ao criar o trabalho. Ele continua a executar e é enviado a todos os novos dispositivos (objetos) que são adicionados ao grupo de destino. Por exemplo, um trabalho contínuo pode ser usado para integrar ou atualizar dispositivos conforme são adicionados a um grupo. Você pode criar um trabalho contínuo definindo um parâmetro opcional ao criá-lo.

Você pode especificar a rapidez com que os destinos são notificados sobre a execução de um trabalho pendente. Isso permite que você crie uma distribuição em etapas para gerenciar melhor as atualizações, reinicializações e outras operações. Você pode criar uma configuração de distribuição usando uma taxa de distribuição estática ou uma exponencial. Para especificar o número máximo de destinos de trabalho a serem informados por minuto, use uma taxa de distribuição estática.

Para obter exemplos de como definir taxas de distribuição e obter mais informações sobre como configurar distribuições de trabalhos, consulte Configurações de implantação, agendamento e anulação de trabalhos.

O agendamento de trabalhos permite que você agende o cronograma de distribuição de um documento de trabalho em todos os dispositivos do grupo de destino para trabalhos contínuos e de snapshot. Além disso, você pode criar uma janela de manutenção opcional contendo datas e horários específicos em que um trabalho distribuirá o documento de trabalho em todos os dispositivos do grupo de destino. Uma janela de manutenção é uma instância recorrente com uma frequência de datas e horários diários, semanais, mensais ou personalizados selecionados durante a criação do trabalho inicial ou do modelo de trabalho. Somente trabalhos contínuos podem ser programados para realizar uma distribuição durante uma janela de manutenção.

O agendamento de trabalhos é específico para seu trabalho. Execuções de trabalhos individuais não podem ser agendadas. Para ter mais informações, consulte Configurações de implantação, agendamento e anulação de trabalhos.

Você pode criar um conjunto de condições para cancelar distribuições quando critérios que você especificou forem atendidos. Para ter mais informações, consulte Configurações de implantação, agendamento e anulação de trabalhos.

O tempo limite do trabalho notifica você sempre que uma implantação de trabalho ficar paralisada no estado IN_PROGRESS por um período inesperadamente longo. Há dois tipos de temporizadores: em andamento e de etapa. Quando o trabalho estiver IN_PROGRESS, você poderá monitorar e acompanhar o progresso da implantação do trabalho.

As configurações de distribuição e anulação são específicas para seu trabalho, enquanto a configuração de tempo limite é específica para a implantação de um trabalho. Para ter mais informações, consulte Configurações de novas tentativas e de tempo limite de execuções de trabalhos.

As repetições de trabalho possibilitam repetir a execução do trabalho quando um trabalho falha, atinge o tempo limite ou ambos. É possível ter até dez novas tentativas para executar a trabalho. Você pode monitorar e acompanhar o progresso de sua nova tentativa e se a execução do trabalho foi bem-sucedida.

As configurações de distribuição e anulação são específicas para seu trabalho, enquanto a configuração de tempo limite e repetição é específica para a execução de um trabalho. Para ter mais informações, consulte Configurações de novas tentativas e de tempo limite de execuções de trabalhos.