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

Saiba como implantar uma atualização em um dispositivo IoT usando a Atualização de Dispositivo para o Hub IoT do Azure.

Pré-requisitos

• Acesso a um Hub IoT com a Atualização de Dispositivo para o Hub IoT habilitada. Recomendamos que você use uma camada S1 (Padrão) ou superior para seu Hub IoT.
• Uma atualização importada para o dispositivo provisionado.
• Um dispositivo IoT (ou simulador) provisionado para Atualização de Dispositivo no Hub IoT.
• O dispositivo faz parte de pelo menos um grupo padrão ou grupo de atualização criado pelo usuário.

Portal do Azure

Browsers suportados:

• Microsoft Edge
• Google Chrome

CLI do Azure

Um ambiente da CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell.

  

• Ou, se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure

  1. Entre na CLI do Azure usando o comando az login .
  2. Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.
  3. Quando solicitado, instale as extensões da CLI do Azure na primeira utilização. Os comandos neste artigo usam a extensão azure-iot . Execute az extension update --name azure-iot para se certificar de que está a utilizar a versão mais recente da extensão.

Gorjeta

Os comandos da CLI do Azure neste artigo usam o caractere de barra invertida \ para continuação de linha para que os argumentos de comando sejam mais fáceis de ler. Esta sintaxe funciona em ambientes Bash. Se você estiver executando esses comandos no PowerShell, substitua cada barra invertida por um backtick ''', ou remova-os completamente.

Implantar a atualização

Portal do Azure

1. No Portal do Azure, navegue para o seu hub IoT.

2. Selecione Atualizações no menu de navegação para abrir a página Atualização de Dispositivo da sua instância do Hub IoT.

   

3. Selecione a guia Grupos e implantações na parte superior da página. Para obter mais informações, consulte Grupos de dispositivos.

   

4. Exiba o gráfico de conformidade de atualização e a lista de grupos. Você verá uma nova atualização disponível para seu grupo baseado em tag ou padrão. Talvez seja necessário atualizar uma vez. Para obter mais informações, consulte Conformidade com a Atualização de Dispositivo.

5. Selecione Implantar ao lado de uma ou mais atualizações disponíveis e confirme se o rótulo descritivo adicionado ao importar está presente e parece correto.

6. Confirme se o grupo correto está selecionado como o grupo-alvo e selecione Implantar.

7. Para iniciar a implantação, vá para a guia Implantação atual. Selecione o link Implantar ao lado da atualização desejada na seção Atualizações disponíveis. A melhor atualização disponível para um determinado grupo é indicada com um destaque Best .

   

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

   Gorjeta

   Por padrão, a data e a hora de início são definidas como Imediatamente. Certifique-se de selecionar uma data e hora diferentes se quiser que a implantação comece mais tarde.

   

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

10. Nos detalhes da implantação, Status se transforma em Ativo. A atualização implantada está marcada com (implantação).

    

11. Veja o gráfico de conformidade para ver se a atualização está em andamento.

    

12. Depois que o dispositivo for atualizado com êxito, você verá que o gráfico de conformidade e os detalhes de implantação foram atualizados para refletir o mesmo.

    

CLI do Azure

O az iot du device group list para verificar a melhor atualização disponível para o seu 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 de Dispositivo.
• --group-id: A ID do grupo de dispositivos que você está direcionando com esta implantação. Este ID é o valor da tag ADUGroup , ou $default para dispositivos sem tag .
• --best-updates: Este sinalizador indica que o comando deve buscar as melhores atualizações disponíveis para o grupo de dispositivos, incluindo uma contagem de quantos dispositivos precisam de cada atualização.
• '--resource-group -g': Nome do grupo de recursos da conta de Atualização de Dispositivo.
• '--update-compliance': esse sinalizador indica que o comando deve buscar informações de conformidade de atualização do grupo de dispositivos, como quantos dispositivos estão em sua atualização mais recente, quantos precisam de novas atualizações e quantos estão em andamento ao receber uma nova atualização.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Use az iot du device deployment create para criar uma implantação para um grupo de dispositivos.

O device deployment create comando usa os seguintes argumentos:

• --account: O nome da conta de Atualização de Dispositivo.
• --instance: O nome da instância de Atualização de Dispositivo.
• --group-id: A ID do grupo de dispositivos que você está direcionando com esta implantação. Este ID é o valor da tag ADUGroup , ou $default para dispositivos sem tag .
• --deployment-id: Uma ID para identificar essa implantação.
• --update-name, --update-providere --update-version: Esses três parâmetros definem o objeto updateId que é um identificador exclusivo para a atualização que você está usando nesta implantação.

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>

Argumentos opcionais permitem configurar a implantação. Para obter a lista completa, consulte Parâmetros opcionais

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

• --failed-count: O número de dispositivos com falha em uma implantação que acionará uma reversão.
• --failed-percentage: A porcentagem de dispositivos com falha em uma implantação que acionará uma reversão.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: O updateID da atualização que o grupo de dispositivos usará se uma reversão for iniciada.

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>

Se desejar que a implantação comece no futuro, use o --start-time parâmetro para fornecer a data/hora de destino para a implantação.

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 uma implantação de atualização

Portal do Azure

1. Selecione o grupo no qual você implantou e vá para a guia Atualizações atuais ou Histórico de implantação para confirmar se a implantação está em andamento

   

2. Selecione Detalhes ao lado da implantação que você criou. Aqui você pode exibir 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.

   

3. Selecione Atualizar para visualizar os detalhes de status mais recentes.

4. Você pode ir para a exibição de noções básicas do grupo para pesquisar o status de um dispositivo específico ou filtrar para exibir dispositivos que falharam na implantação

CLI do Azure

Use az iot du device deployment list para exibir 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 --status sinalizador para retornar informações sobre quantos dispositivos na implantação estão em andamento, concluídos ou falharam.

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

Repetir uma implantação de atualização

Se a implantação falhar por algum motivo, você poderá repetir a implantação para dispositivos com falha.

Portal do Azure

1. Vá para a guia Implantação atual na tela Detalhes do grupo.

   

2. Selecione Repetir dispositivos com falha e confirme a notificação de confirmação.

CLI do Azure

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

Este comando usa o --class-id argumento, que é gerado a partir da ID do modelo e das propriedades de compatibilidade relatadas pelo agente de atualização de 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>

Próximos passos

Resolver problemas comuns