Importar uma atualização à Atualização de Dispositivo para Hub IoT

Navegadores compatíveis:

• Microsoft Edge
• Google Chrome

Um ambiente da CLI do Azure:

• Use o ambiente Bash no Azure Cloud Shell.

  

• Ou, se preferir executar os 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 az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.
  3. Quando solicitado, instale as extensões da CLI do Azure no primeiro uso. Os comandos neste artigo usam a extensão azure-iot. Execute az extension update --name azure-iot para verificar se está usando a versão mais recente da extensão.

1. No portal do Azure, navegue até o Hub IoT com a Atualização do Dispositivo.

2. No lado esquerdo da página, selecione Atualizações em Gerenciamento Dispositivo.

   

3. Selecione a guia Atualizações na lista de guias na parte superior da tela.

   

4. Selecione + Importar uma nova atualização abaixo do cabeçalho Atualizações Disponíveis.

   

5. Selecione + Selecionar no contêiner de armazenamento. A interface do usuário das contas de Armazenamento é exibida. Selecione uma conta existente ou crie uma usando + Conta de armazenamento. Essa conta é usada por um contêiner para preparar as atualizações para importação. A conta não deve ter pontos de extremidade públicos e privados habilitados ao mesmo tempo.

   

6. Após selecionar uma conta de Armazenamento, a interface do usuário dos contêineres é exibida. Selecione um contêiner existente ou crie um contêiner usando + Contêiner. Esse contêiner é usado para preparar os arquivos de atualização para importação

   Recomendamos usar um novo contêiner cada vez que você importar uma atualização. Sempre usar novos contêineres ajuda a evitar a importação acidental de arquivos de atualizações anteriores. Se você não usar um contêiner novo, não deixe de excluir todos os arquivos do contêiner existente antes de concluir esta etapa.

   

7. No contêiner, selecione Atualizar. A interface do usuário de Upload é exibida.

   

8. Selecione o ícone de pasta no lado direito da seção Arquivos sob o cabeçalho Carregar blob. Use o seletor de arquivos para navegar até o local dos arquivos de atualização e importar o manifesto, selecione todos os arquivos e, em seguida, selecione Abrir. Você pode manter pressionada a tecla Shift e clicar para selecionar vários arquivos.

   

9. Quando você tiver selecionado todos os arquivos de atualização, selecione Carregar.

   

10. Selecione os arquivos carregados para designá-los a serem importados. Em seguida, selecione o botão Selecionar para retornar à página Importar atualização.

    

11. Na página Importar atualização, revise os arquivos a serem importados. Em seguida, selecione Importar atualização para iniciar o processo de importação. Para resolver erros, consulte Solução de problemas de atualização de proxy.

    

12. O processo de importação é iniciado e a tela é alterada para a seção Histórico de importação. Selecione Atualizar para exibir o progresso até a conclusão do processo de importação (dependendo do tamanho da atualização, o processo pode ser concluído em alguns minutos, mas pode levar mais tempo).

    

13. Quando a coluna Status indicar que a importação foi bem-sucedida, selecione o cabeçalho Atualizações Disponíveis. Agora a atualização importada deve estar presente na lista.

    

O comando az iot du update stage manipula as etapas de pré-requisito de importação de uma atualização, incluindo o carregamento dos arquivos de atualização em um contêiner de armazenamento de destino. Um sinalizador opcional também permite que esse comando importe automaticamente os arquivos depois que eles estiverem preparados. Caso contrário, o comando az iot du update import conclui o processo.

O comando stage 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.
• --manifest-path: o caminho do arquivo para o manifesto de importação que deve ser preparado.
• --storage-account: o nome da conta de armazenamento para preparar a atualização.
• --storage-container: o nome do contêiner dentro da conta de armazenamento selecionada para preparar a atualização.
• --overwrite: sinalizador opcional que indica se os blobs existentes devem ser substituídos no contêiner de armazenamento se houver um conflito.
• --then-import: sinalizador opcional que indica se a atualização deve ser importada para a Atualização de Dispositivo depois de preparada.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Por exemplo:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Se você tiver vários manifestos de importação, poderá incluir todos eles em um único comando. Por exemplo:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Se você não usar o sinalizador --then-import, a saída do comando stage incluirá um prompt para executar az iot du update import, incluindo argumentos pré-preenchidos.

Use az iot du update list para verificar se as atualizações foram importadas com êxito.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table