Importar uma atualização para a Atualização de Dispositivos do Azure para o Hub IoT

• Navegadores com suporte: Microsoft Edge ou Google Chrome.

• Um ambiente Bash.

  Você pode usar o ambiente Bash no Azure Cloud Shell para executar os comandos nesse artigo. 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.

1. No portal do Azure, na página do Hub IoT da sua instância da Atualização de Dispositivo, selecione Gerenciamento de dispositivo>Atualizações na navegação à esquerda.

   

2. Na página Atualizações, selecione Importar uma nova atualização.

   

3. Na página Importar Atualização, selecione Selecionar do contêiner de armazenamento.

4. Na página Contas de Armazenamento, selecione uma conta de armazenamento existente ou crie uma conta selecionando Conta de armazenamento. Você usa a conta de armazenamento do contêiner para preparar os arquivos de atualização.

5. Na página Contêineres, selecione um contêiner existente ou crie um novo contêiner selecionando Contêiner. Você usa o contêiner para preparar os arquivos de atualização para importação.

   

   Dica

   Usar um contêiner novo cada vez que você importar uma atualização evita a importação acidental de arquivos de atualizações anteriores. Se você não usar um novo contêiner, exclua todos os arquivos anteriores do contêiner existente.

6. Na página do contêiner, selecione Carregar.

   

7. Na tela Carregar blob, selecione o ícone de pasta ao lado de Arquivos. Use o seletor de arquivos para navegar até o local dos arquivos de manifesto de atualização e importação, selecione os arquivos e, em seguida, selecione Abrir. Você pode usar a tecla Shift para selecionar vários arquivos.

   

8. Depois de selecionar todos os arquivos, selecione Upload.

   

9. Depois de carregarem, os arquivos serão exibidos na página do contêiner. Na página do contêiner, examine e selecione os arquivos a serem importados e selecione Selecionar.

   

10. Na tela Importar atualização, selecione Importar atualização.

    

O processo de importação começa e a tela muda para a tela Atualizações. Depois que a importação for bem-sucedida, ela será exibida na guia Atualizações. Para resolver erros, consulte Solução de problemas de atualização de proxy.

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 de serem 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 do Device Update.
• --instance: o nome da instância de Atualização do Dispositivo.
• --manifest-path: O caminho do arquivo do manifesto de importação a ser preparado.
• --storage-account: O nome da conta de armazenamento na qual a atualização será preparada.
• --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 sobrescritos no contêiner de armazenamento em caso de conflito.
• --then-import: Sinalizador opcional que indica se a atualização deve ser importada para o Device Update após ser 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

Você pode incluir vários manifestos de importação 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, com argumentos pré-preenchidos.

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

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