Importar uma atualização para o Azure Device Update do Hub IoT

• Navegadores suportados Microsoft Edge ou Google Chrome.

• Um ambiente Bash.

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

1. No >, na página do hub IoT da sua instância do Device Update, na navegação à esquerda, selecione Gestão de dispositivosAtualizações.

   

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

   

3. Na página Importar atualização, selecione Selecionar a partir do contentor de armazenamento.

4. Na página Contas de armazenamento, selecione uma conta de armazenamento existente ou crie uma nova conta selecionando Conta de armazenamento. Utiliza a conta de armazenamento associada ao contentor para armazenar temporariamente os ficheiros de atualização.

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

   

   Sugestão

   Usar um novo contêiner cada vez que você importa uma atualização ajuda a evitar a importação acidental de arquivos de atualizações anteriores. Se você não usar um novo contêiner, certifique-se de excluir 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 da atualização e importar arquivos de manifesto, selecione os arquivos e selecione Abrir. Você pode usar a tecla Shift para selecionar vários arquivos.

   

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

   

9. Após o upload, os arquivos aparecem na página do contêiner. Na página de contêiner, revise e selecione os arquivos a serem importados e, em seguida, selecione Selecionar.

   

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

    

O processo de importação começa e a tela alterna para a tela Atualizações . Após a importação ser bem-sucedida, esta aparece no separador Atualizações. Para resolver quaisquer erros, consulte Resolução de problemas de atualização do proxy.

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 de prepará-los. 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 do Device Update.
• --instance: O nome da instância de Atualização de Dispositivo.
• --manifest-path: O caminho para o ficheiro do manifesto de importação a preparar.
• --storage-account: O nome da conta de armazenamento para a qual preparar a atualização.
• --storage-container: O nome do contêiner dentro da conta de armazenamento selecionada para a qual preparar a atualização.
• --overwrite: Parâmetro opcional que indica se os blobs existentes no contentor de armazenamento devem ser sobrescritos em caso de conflito.
• --then-import: Parâmetro opcional que indica se a atualização deve ser importada para o Device Update após ser colocada em pré-produção.

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 não utilizar a opção --then-import, a saída do comando stage inclui uma mensagem para executar az iot du update import com argumentos pré-preenchidos.

Use az iot du update list para verificar se suas atualizações são 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