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

1. No portal Azure, vá para o seu hub de 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. Para segurança para download, selecione HTTPS (recomendado) ou HTTP. Essa configuração controla o protocolo que os dispositivos usam para baixar o conteúdo da atualização. HTTPS é o padrão e criptografa o conteúdo de atualização durante o trânsito.

   Para orientações sobre como escolher um protocolo e preparar seus dispositivos, veja Entender a segurança de downloads (TLS) em Atualização de Dispositivo para Hub IoT.

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

   

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

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

    

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

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.

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>

Dispositivos baixam conteúdo atualizado via HTTPS por padrão. Para usar HTTP em vez disso, adicione o parâmetro opcional --download-security descrito em Usar argumentos opcionais.

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"

Para escolher o protocolo que os dispositivos usam para baixar o conteúdo da atualização, adicione o parâmetro opcional --download-security . Os valores aceitos são HTTPS (recomendado) e HTTP. Se você omitir o parâmetro, a implantação usa o padrão HTTPS. Para orientações sobre como escolher um protocolo e preparar seus dispositivos, veja Entender a segurança de downloads (TLS) em Atualização de Dispositivo para Hub IoT.

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> \
    --download-security <HTTPS or HTTP>

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.

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

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.

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

Esse comando assume o --class-id argumento, que é gerado a partir do ID do modelo e das propriedades de compatibilidade reportados 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>