Implantar uma atualização de software em um grupo (prévia)

O Azure Device Registry utiliza tarefas para aplicar atualizações de software a grupos de dispositivos conectados ao Hub IoT. Um trabalho de atualização de software mira um grupo de dispositivos e aplica uma atualização de software aos membros compatíveis desse grupo. Em contraste, um trabalho de atualização de integração tem como alvo dispositivos que são integrados a um namespace. Implantar uma atualização de software como um trabalho permite que você implemente a mesma atualização para vários dispositivos ao mesmo tempo, para manter seus dispositivos conectados ao Hub IoT atualizados sem atualizar cada dispositivo individualmente.

Este artigo mostra como definir ou validar um grupo-alvo, usar o portal do Azure ou o Bicep para criar um trabalho padrão de atualização de software, executar ou agendar o trabalho e monitorar os resultados. Use este artigo após importar a atualização de software que você deseja aplicar. Para entender como trabalhos, grupos e atualizações de software funcionam juntos, veja Atualizações de Software no Azure Device Registry.

Importante

As atualizações de software do Azure Device Registry estão em versão prévia no momento. A prévia atual é direcionada para dispositivos conectados ao Hub IoT. Esta prévia é fornecida sem um acordo de nível de serviço, e a funcionalidade e sua experiência no portal podem mudar antes de se tornarem geralmente disponíveis. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Note

Durante a prévia, você pode usar atualizações de software apenas com hubs IoT que não possuem uma instância existente de Atualização de Dispositivo para Hub IoT. Para usar atualizações de software, vincule ao namespace um Hub IoT que não tenha uma instância do Device Update para Hub IoT ou exclua a instância existente antes de vincular o Hub IoT. Para mais informações, consulte atualizações de software e Atualização de Dispositivos para o Hub IoT.

Prerequisites

  • Dispositivos conectados ao Hub IoT cujas propriedades identificam os dispositivos que você deseja atualizar. Use essas propriedades para definir o grupo de destino.
  • Uma atualização de software foi importada para o namespace. Para saber mais, veja Importar uma atualização de software (prévia).
  • Atualizações de software ativadas no namespace que contém seus dispositivos. Para saber mais, veja Comece com o Azure Device Registry.
  • Permissões do plano de controle do Azure Resource Manager, como a função Contribuidor, para criar, ler, atualizar e excluir jobs.
  • Para executar trabalhos, a identidade gerenciada do namespace deve ter acesso à instância de atualizações de software vinculada ao namespace. Se você habilitar atualizações de software no portal do Azure, essas atribuições de função são criadas para você.

Defina ou valide o grupo-alvo

Um trabalho de atualização de software tem como alvo um grupo em vez de todos os dispositivos no namespace. Crie um grupo com um filtro que selecione apenas os dispositivos conectados ao Hub IoT que devem receber a atualização, ou reutilize um grupo existente cuja associação corresponda a esse escopo. Por exemplo, use propriedades do dispositivo como fabricante, modelo ou revisão de software para atingir uma coorte específica de dispositivos. Use o portal Azure ou o Bicep para criar o grupo.

Para criar um grupo no portal do Azure:

  1. Na navegação do namespace, abra Operações>Grupos (visualização) e inicie a criação do grupo na barra de comandos.

  2. Na página Básicos, insira um Nome descritivo e, opcionalmente, uma Descrição que identifica o grupo de dispositivos de destino.

  3. Na página de Definição, em Definir condições de filtro, insira uma consulta que selecione os dispositivos conectados ao Hub IoT que você deseja atualizar.

    Captura de tela da página de Definição com o editor de consultas de dispositivos.

    Os filtros de grupo são imutáveis após a criação. Para usar critérios de associação diferentes, crie outro grupo com uma consulta diferente.

  4. Na página de Revisão, verifique Noções básicas, Definição e Filtro de consulta e então selecione Criar.

    Captura de tela da página de Avaliação mostrando o nome do grupo, descrição e filtro de consultas.

A pertença ao grupo é calculada e armazenada em cache quando você cria ou recarrega o grupo. Antes de usar um grupo para um trabalho de atualização de software:

  • Atualize a associação do grupo se as propriedades do dispositivo tiverem sido alteradas. No portal do Azure, Refresh está disponível na barra de comandos de detalhamento do grupo.
  • Espere até que o status do grupo seja Pronto.
  • Na visualização de detalhes do grupo, verifique o filtro de consulta resolvida e a contagem de membros. A lista de membros mostra até 10 dispositivos, então trate isso como uma verificação pontual, e não como uma lista completa, e confirme se a contagem de membros corresponde aos dispositivos que você pretende atualizar.

Criar um trabalho de atualização de software

Um trabalho de atualização de software tem como alvo um grupo de dispositivos e aplica uma atualização de software importada aos membros compatíveis desse grupo. Use o portal do Azure ou o Bicep para criar o job.

  1. No portal do Azure, acesse o Registro de Dispositivo do Azure e selecione o namespace que contém os dispositivos que você deseja atualizar.

  2. No namespace, selecione Operações>Trabalhos. A tela Jobs lista os jobs definidos com seu status, tipo de job e grupo-alvo. A partir dessa tela, você também pode visualizar os grupos e atualizações de software no namespace.

    Captura de tela da página de Jobs mostrando jobs definidos com seu tipo, status e grupo-alvo.

  3. Selecione Criar para criar um novo job.

  4. Na página Informações básicas, forneça um nome e uma descrição para o trabalho.

  5. Para o tipo de trabalho, selecione atualização de software.

    Na versão preliminar, os tipos de trabalho disponíveis são Atualização de software e Atualização de integração. Um trabalho de atualização de software tem como alvo um grupo de dispositivos, e um trabalho de atualização de integração tem como alvo dispositivos que são integrados a um namespace. Este artigo aborda a tarefa de atualização de software.

  6. Selecione o grupo que você deseja direcionar. Use o seletor de grupo para pesquisar e selecionar um grupo. O seletor mostra o número aproximado de dispositivos em cada grupo.

    Para informações sobre como a associação ao grupo é atualizada, veja Conceitos de Grupos (prévia).

  7. Guarde a seleção do grupo. O portal mostra uma amostra dos dispositivos do grupo e a contagem de dispositivos.

  8. Defina a ação a ser executada selecionando uma das atualizações de software importadas para o namespace. Cada atualização de software inclui uma verificação de compatibilidade que determina se ela se aplica a um dispositivo. O portal executa uma verificação de compatibilidade para o grupo selecionado para determinar se a atualização de software é compatível.

    Captura de tela da página de Jobs mostrando a definição de ação de um job de atualização de software.

  9. Selecione Avançar para ver um resumo do trabalho. O resumo mostra o número de membros do grupo e uma estimativa do número de membros compatíveis que o trabalho provavelmente atualizará com sucesso.

    Captura de tela da página Jobs mostrando a revisão do job para uma atualização de software.

  10. Selecione Criar. O status da tarefa mostra Criando e, em seguida, muda para Pronto após alguns instantes.

Execute ou agende o job

Depois que um trabalho estiver pronto, você pode executá-lo imediatamente ou agendá-lo para rodar depois.

  1. Na tela Jobs, selecione o job que você quer executar.

  2. Selecione uma das opções a seguir:

    • Executar agora: A tarefa é executada imediatamente.
    • Agende para depois: Escolha um horário nos próximos sete dias. O trabalho roda no horário que você seleciona.

Após executar ou agendar a tarefa, o portal passa para a guia Execuções.

Monitore a execução do job

A aba Execuções mostra os trabalhos, incluindo execuções em execução, concluídas e agendadas.

  1. Selecione a guia Execuções para visualizar as execuções e seus respectivos status.

  2. Selecione uma execução concluída para visualizar suas estatísticas. Os detalhes da execução mostram o número de dispositivos atualizados e os detalhes desses dispositivos.

  3. Verifique um dispositivo específico. Para confirmar se um dispositivo específico foi atualizado, use a caixa de busca nos detalhes da execução para encontrar o dispositivo.