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

Browsers suportados:

• Microsoft Edge
• Google Chrome

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.

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

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

   

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 é mostrada. Selecione uma conta existente ou crie uma conta usando + Conta de armazenamento. Essa conta é usada para um contêiner preparar suas atualizações para importação. A conta não deve ter pontos de extremidade públicos e privados habilitados ao mesmo tempo.

   

6. Depois de selecionar uma conta de armazenamento, a interface do usuário de contêineres é mostrada. Selecione um contêiner existente ou crie um contêiner usando + Contêiner. Esse contêiner é usado para preparar seus arquivos de atualização para importação

   Recomendamos que você use um novo contêiner sempre que importar uma atualização. O uso constante de novos contêineres ajuda a evitar a importação acidental de arquivos de atualizações anteriores. Se você não usar um novo contêiner, exclua todos os arquivos do contêiner existente antes de concluir esta etapa.

   

7. No contêiner, selecione Carregar. A interface do usuário de carregamento é mostrada.

   

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 manifesto, selecione todos os arquivos e selecione Abrir. Você pode segurar a tecla Shift e clicar para selecionar vários arquivos.

   

9. Quando tiver selecionado todos os seus ficheiros 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 começa e a tela alterna para a seção Histórico de importação. Selecione Atualizar para ver o progresso até que o processo de importação seja concluído (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 . Você deve ver sua atualização importada na lista agora.

    

O comando az iot du update stage lida com as etapas de pré-requisito de importação de uma atualização, incluindo o upload 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 forem preparados. Caso contrário, o comando az iot du update import conclui o processo.

O stage 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.
• --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 após o estágio.

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á incluí-los todos 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 --then-import sinalizador, a stage saída do comando incluirá um prompt para executar az iot du update import, incluindo argumentos pré-preenchidos.

Use az iot du update list para verificar se sua atualização ou 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