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

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

Pré-requisitos

• Acesso a um Hub IoT com Atualização de Dispositivo para Hub IoT habilitada.

• Um contêiner de Armazenamento do Azure sem Ponto de Extremidade Privado habilitado.

  • Se você não tiver certeza se o Ponto de Extremidade Privado está habilitado, acesse Centro de Link Privado, selecione "Pontos de extremidade privados" à esquerda e procure o nome da sua conta de Armazenamento do Azure na coluna "Recursos".

• Um dispositivo (ou simulador) IoT provisionado para obter uma Atualização de Dispositivo no Hub IoT.

• Siga as etapas em Preparar uma atualização para importar na Atualização de Dispositivo para Hub IoT para criar o manifesto de importação dos arquivos de atualização.

Azure portal

Navegadores compatíveis:

• 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 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.

Dica

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. Essa sintaxe funciona em ambientes Bash. Se você estiver executando esses comandos no PowerShell, substitua cada barra invertida por um acento grave ``` ou remova-as inteiramente.

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 as APIs de Atualização de Dispositivo para Hub IoT para importar uma atualização.

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

Azure portal

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.

    

CLI do Azure

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

Para importações usando APIs como alternativa

Também é possível importar uma atualização programaticamente por:

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

Observação

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

Arquivos de atualização e manifesto de importação devem ser carregados em um contêiner do Azure Storage Blob para staging. Para importar os arquivos preparados, forneça a URL do blob ou a SAS (Assinatura de Acesso Compartilhado) dos blobs particulares para a API de Atualização de Dispositivo. Se estiver usando uma SAS, lembre-se de fornecer uma janela de expiração de três horas ou mais

Dica

Para carregar grandes arquivos de atualização para o contêiner do Azure Storage Blob, você pode usar um dos seguintes para melhorar o desempenho:

• AzCopy
• Gerenciador de Armazenamento do Azure

Próximas etapas

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