Implantar uma atualização usando a Atualização de Dispositivo do Azure para Hub IoT

Neste artigo, você vai aprender a implantar uma atualização em dispositivos IoT usando a Atualização de Dispositivo do Azure para Hub IoT no portal do Azure ou com a CLI do Azure.

Pré-requisitos

• Uma instância Standard (S1) ou superior do Hub IoT do Azure com a Atualização de Dispositivo para Hub IoT habilitada.
• Um dispositivo ou simulador de IoT provisionado para a Atualização de Dispositivo dentro do Hub IoT. O dispositivo provisionado pode ser um membro de um grupo de dispositivos criado pelo usuário ou do grupo padrão.
• Uma atualização importada no dispositivo provisionado.

Implantar a atualização

Esta seção descreve como implantar a atualização usando o portal do Azure ou a CLI do Azure.

Portal do Azure

1. No portal do Azure, navegue para o hub IoT.

2. Selecione Atualizações em Gerenciamento de dispositivo no menu de navegação esquerdo.

   

3. Na página Atualizações, selecione a guia Grupos e Implantações e exiba o gráfico de conformidade das atualizações e a lista de grupos de dispositivos. Talvez seja necessário atualizar a exibição para ver as atualizações importadas recentemente disponíveis para o grupo de dispositivos.

4. Em Status na lista de grupos, selecione Implantar ao lado de Uma ou mais novas atualizações estão disponíveis para esse grupo.

   

5. Exiba a lista de grupos e gráficos de conformidade das atualizações. Você deve ver uma nova atualização disponível para seu grupo padrão ou baseado em marca. Talvez você precise atualizar novamente. Para obter mais informações, confira a Conformidade de Atualização de Dispositivo.

6. Selecione Implantar ao lado do status Uma ou mais atualizações disponíveis.

7. Na lista à direita, selecione a atualização desejada para implantação.

   

8. Agende sua implantação para iniciar imediatamente ou no futuro.

   Dica

   Por padrão, a data e a hora de Início são 24 horas a partir do horário atual. Selecione uma data e hora diferentes se desejar que a implantação comece mais cedo ou mais tarde.

   

9. Crie uma política de reversão automática, se necessário. Em seguida, selecione Criar.

10. Na guia Atualizações atuais, você pode ver o status da implantação.

    

11. Na exibição Informações básicas do grupo, o gráfico de conformidade mostra que a atualização está em andamento.

    Depois que o dispositivo for atualizado com êxito, o gráfico de conformidade e os detalhes da implantação serão atualizados para refletir esse status.

CLI do Azure

Você pode usar o ambiente Bash no Azure Cloud Shell para executar os comandos a seguir. Selecione Iniciar o Cloud Shell para abrir o Cloud Shell ou selecione o ícone do Cloud Shell na barra de ferramentas superior do portal do Azure.

Ou, se preferir, execute os comandos da CLI do Azure localmente:

1. Instalar a CLI do Azure. Execute az version para ver a versão instalada da CLI do Azure e as bibliotecas dependentes e execute az upgrade para instalar a versão mais recente.
2. Entre no Azure executando az login.
3. Instale a extensão azure-iot quando solicitado no primeiro uso. Para verificar se está usando a versão mais recente da extensão, execute az extension update --name azure-iot.

Dica

Os comandos da CLI do Azure neste artigo usam o caractere de barra invertida \ para continuação da linha de forma que seja mais fácil ler os argumentos do comando. Essa sintaxe funciona em ambientes Bash. Se estiver executando esses comandos no PowerShell, substitua cada barra invertida por um acento grave ` ou as remova inteiramente.

Verificar a disponibilidade da atualização

1. Use o comando az iot du device group list para identificar o grupo de dispositivos.

   az iot du device group list \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
   

2. Em seguida, use az iot du device group show para mostrar a melhor atualização disponível para o grupo. O comando usa os seguintes argumentos:

   • --account: o nome da conta de atualização de dispositivo.
   • --instance: o nome da instância de Atualização do Dispositivo.
   • --group-id: a ID do grupo de dispositivos de destino dessa implantação, que é o valor da marca ADUGroup ou $default para dispositivos sem marca.
   • --resource-group: o nome do grupo de recursos da conta da Atualização de Dispositivo.
   • --best-updates: retorna uma lista das melhores atualizações disponíveis para o grupo de dispositivos, incluindo uma contagem de quantos dispositivos precisam de cada atualização.
   • --update-compliance: retorna informações de conformidade das atualização do grupo de dispositivos, como o número de dispositivos que estão na atualização mais recente, quantos precisam de novas atualizações e quantos estão recebendo uma nova atualização no momento.

   Para verificar a melhor atualização disponível para o grupo, execute o seguinte comando:

   az iot du device group show \
       --account <Device Update account name> \
       --instance <Device Update instance name>\
       --group-id <device group ID>\
       --best-updates
   

Criar a implantação

Use az iot du device deployment create para criar uma implantação para o grupo de dispositivos. O comando usa os seguintes argumentos:

• --account: o nome da conta de atualização de dispositivo.
• --instance: o nome da instância de Atualização do Dispositivo.
• --group-id: a ID do grupo de dispositivos de destino dessa implantação, que é o valor da marca ADUGroup ou $default para dispositivos sem marca.
• --deployment-id: a ID para identificar essa implantação.
• --update-name, --update-provider e --update-version: os parâmetros que definem o objeto updateId, um identificador exclusivo para a atualização nesta implantação.

Execute o comando da seguinte forma:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Usar argumentos opcionais

Os argumentos opcionais permitem que você faça configurações adicionais na implantação. Para ver a lista completa de argumentos opcionais, veja Parâmetros opcionais.

Para criar uma política de reversão automática, adicione os seguintes parâmetros:

• --failed-count: o número de dispositivos com falha na implantação que dispara uma reversão.
• --failed-percentage: a porcentagem de dispositivos com falha na implantação que dispara uma reversão.
• --rollback-update-name, --rollback-update-provider e --rollback-update-version: os parâmetros para a atualização a ser usada se uma reversão for iniciada.

Execute o comando da seguinte forma:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Para definir a hora de início da implantação, use o parâmetro --start-time para fornecer a data e a hora de destino da implantação, da seguinte maneira:

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Monitorar o status da implantação

Portal do Azure

1. Na guia Grupos e Implantações da página Atualizações, selecione o grupo no qual você fez a implantação.

2. Na página Detalhes do grupo, acesse a guia Implantação atual ou Histórico de implantação para confirmar se uma implantação está em andamento.

   

3. Selecione Detalhes ao lado de uma implantação para ver os detalhes da implantação, os detalhes da atualização e os detalhes da classe do dispositivo de destino. Opcionalmente, você pode adicionar um nome amigável para a classe de dispositivo.

4. Selecione Atualizar para exibir os detalhes mais recentes do status.

   

Acesse a guia Informações básicas do grupo da página Detalhes do grupo para pesquisar o status de um dispositivo específico ou filtre para ver os dispositivos com falha de implantação.

CLI do Azure

Use az iot du device deployment list para ver toda a implantação de um grupo de dispositivos.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Use az iot du device deployment show para exibir os detalhes de uma implantação específica.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Adicione o sinalizador --status para retornar informações sobre quantos dispositivos na implantação estão em andamento, concluídos ou com falha.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Tentar executar uma implantação de atualizações novamente

Em caso de falha na implantação, tente refazer a implantação dos dispositivos com falha.

Portal do Azure

1. Acesse a guia Implantação atual na tela Detalhes do grupo.

2. Selecione Tentar executar dispositivos com falha novamente e aceite a notificação de confirmação.

CLI do Azure

Use az iot du device deployment retry para repetir uma implantação para um subgrupo de dispositivos de destino.

Esse comando usa o argumento --class-id, que é gerado a partir da ID do modelo e das propriedades de compatibilidade informadas pelo agente de atualização do dispositivo.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Conteúdo relacionado

• Implantações da Atualização de Dispositivo
• Guia de solução de problemas da Atualização de Dispositivo