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

Saiba como obter uma nova atualização e importá-la para a Atualização de Dispositivo para o Hub IoT. Se ainda não o fez, certifique-se de que revê os principais conceitos de importação e como preparar uma atualização para ser importada.

Pré-requisitos

• Acesso a um Hub IoT com a Atualização de Dispositivo para o Hub IoT habilitada.
• Um dispositivo IoT (ou simulador) provisionado para Atualização de Dispositivo no Hub IoT.
• Siga as etapas em Preparar uma atualização para importar para a Atualização de Dispositivo para o Hub IoT para criar o manifesto de importação para seus arquivos de atualização.

Portal do Azure

Browsers suportados:

• Microsoft Edge
• Google Chrome

CLI do Azure

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.

Gorjeta

Os comandos da CLI do Azure neste artigo usam o caractere de barra invertida \ para continuação de linha para que os argumentos de comando sejam mais fáceis de ler. Esta sintaxe funciona em ambientes Bash. Se você estiver executando esses comandos no PowerShell, substitua cada barra invertida por um backtick ''', ou remova-os completamente.

Importar uma atualização

Esta seção mostra como importar uma atualização usando o portal do Azure ou a CLI do Azure. Você também pode usar a Atualização de Dispositivo para APIs do Hub IoT para importar uma atualização.

Para importar uma atualização, primeiro carregue os arquivos de atualização e importe o manifesto para um contêiner de Armazenamento do Azure. Em seguida, importe a atualização do Armazenamento do Azure para a Atualização de Dispositivo para o Hub IoT, onde será armazenada para ser implantada nos dispositivos.

Portal do Azure

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.

    

CLI do Azure

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

Se, em vez disso, você estiver importando usando APIs

Você também pode importar uma atualização programaticamente:

• Usando Azure SDK para .NET, Java, JavaScript ou Python
• Usando a API REST de atualização de importação
• Usando módulos PowerShell de exemplo
  • Requer o PowerShell 5 ou posterior (inclui instalações do Linux, macOS e Windows)

Nota

Consulte Funções de usuário e acesso de atualização de dispositivo para obter a permissão de API necessária.

Os arquivos de atualização e o manifesto de importação devem ser carregados em um contêiner de Blob de Armazenamento do Azure para preparação. Para importar os arquivos em estágios, forneça a URL de blob ou a assinatura de acesso compartilhado (SAS) para blobs privados para a API de Atualização de Dispositivo. Se estiver usando uma SAS, certifique-se de fornecer uma janela de expiração de três horas ou mais

Gorjeta

Para carregar arquivos de atualização grandes no contêiner de Blob de Armazenamento do Azure, você pode usar uma das seguintes opções para obter um melhor desempenho:

• AzCopy
• Explorador do Storage do Azure

Passos Seguintes

• Criar Grupos
• Saiba mais sobre os conceitos de importação