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

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

2. Selecione Atualizações em Gerenciamento de dispositivos na navegação à esquerda.

   

3. Na página Atualizações, selecione a guia Grupos e Implantações e exiba o gráfico de conformidade de atualizações e a lista de grupos de dispositivos. Talvez seja necessário atualizar o modo de exibição para ver as atualizações importadas recentemente disponíveis para seu 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 este grupo.

   

5. 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.

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

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

   

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 24 horas a partir da hora atual. Certifique-se de selecionar uma data e hora diferentes se quiser que a implantação comece mais cedo ou mais tarde.

   

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

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

    

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

    Após a atualização bem-sucedida do dispositivo, o gráfico de conformidade e os detalhes de implantação são atualizados para refletir esse status.

Você pode usar o ambiente Bash no Azure Cloud Shell para executar os seguintes comandos. 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, você pode executar 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 azure-iot extensão quando solicitado na primeira utilização. Para se certificar de que está a utilizar a versão mais recente da extensão, execute az extension update --name azure-iot.

Verificar a disponibilidade da atualização

1. Use o az iot du device group list comando para identificar seu 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 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: o ID do grupo de dispositivos que você está segmentando com esta implantação, que é o ADUGroup valor da tag ou $default para dispositivos sem tag.
   • --resource-group: O nome do grupo de recursos da conta de Atualização de Dispositivo.
   • --best-updates: Retorna as 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 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 recebendo uma nova atualização no momento.

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

   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 de Dispositivo.
• --group-id: o ID do grupo de dispositivos que você está segmentando com esta implantação, que é o ADUGroup valor da tag ou $default para dispositivos sem tag.
• --deployment-id: Uma ID para identificar essa implantação.
• --update-name, --update-providere --update-version: Os parâmetros que definem o updateId objeto, um identificador exclusivo para a atualização nesta implantação.

Execute o comando 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>

Usar argumentos opcionais

Os argumentos opcionais permitem configurar ainda mais a implantação. Para obter a lista completa de argumentos opcionais, consulte 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 em uma implantação que dispara uma reversão.
• --failed-percentage: A porcentagem de dispositivos com falha em uma implantação que dispara uma reversão.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: Os parâmetros para a atualização a ser usada se uma reversão for iniciada.

Execute o comando 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> \
    --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 --start-time parâmetro para fornecer a data e a hora de destino para a 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"

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

2. Na página Detalhes do grupo, vá para 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 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.

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

   

Vá para a guia Noções básicas do grupo da página Detalhes do grupo para pesquisar o status de um dispositivo específico ou filtre para exibir dispositivos que falharam na implantação.

Use az iot du device deployment list para exibir todas as implantações 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

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.

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>