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

Para implantar uma atualização em dispositivos usando a Atualização de Dispositivo do Azure para Hub IoT, primeiro importe arquivos de atualização para o serviço de Atualização de Dispositivo, que armazena a atualização importada para implantar em dispositivos. Neste artigo, você aprenderá a importar uma atualização para o serviço de Atualização de Dispositivo usando o portal do Azure, a CLI do Azure ou as APIs da Atualização de Dispositivo.

Pré-requisitos

• Uma conta de Atualização de Dispositivo e uma instância configurada com um hub IoT.

• Um dispositivo ou simulador de IoT provisionado para a Atualização de Dispositivo dentro do Hub IoT.

• Atualize os arquivos para seu dispositivo e um arquivo de manifesto de importação associado criado seguindo as instruções em Preparar uma atualização para importar para a Atualização de Dispositivo.

• Um contêiner e uma conta de armazenamento do Azure para armazenar os arquivos importados. Ou você pode criar um novo contêiner e conta de armazenamento como parte do processo de importação baseado no portal do Azure.

  Importante

  Verifique se a conta de armazenamento que você usa ou criou não tem pontos de extremidade privados habilitados. Para ver se pontos de extremidade privados estão habilitados, você pode verificar o nome da conta de armazenamento do Azure em Pontos de extremidade privados no Centro de Link Privado.

Portal do Azure

• Navegadores com suporte: Microsoft Edge ou Google Chrome.

CLI do Azure

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

Dica

Os comandos da CLI do Azure neste artigo usam o caractere de barra invertida \ para continuação da linha de forma que seja mais fácil ler os argumentos do comando. Essa sintaxe funciona em ambientes Bash. Se estiver executando esses comandos no PowerShell, substitua cada barra invertida por um acento grave ` ou as remova inteiramente.

Importar uma atualização

Esta seção mostra como importar uma atualização usando o portal do Azure ou a CLI do Azure. Em vez disso, você também pode importar uma atualização usando as APIs da Atualização de Dispositivo.

Para importar uma atualização, primeiro carregue os arquivos de atualização e importe os arquivos de 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, que a armazena para implantar em dispositivos.

Portal do Azure

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

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 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 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 para preparação.
• --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

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

Importar usando as APIs da Atualização de Dispositivo

Você também pode importar uma atualização programaticamente usando qualquer um dos seguintes métodos:

• As APIs da Atualização de Dispositivo nos SDKs do Azure para .NET, Java, JavaScript ou Python
• A API REST Importar Atualização da Atualização de Dispositivo
• Módulos do PowerShell de exemplo (requer o PowerShell 5 ou posterior para Linux, macOS ou Windows)

Observação

Confira Acesso e funções de usuário da Atualização de Dispositivo para 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 do Azure Storage Blob para preparação. 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 em um contêiner do Azure Storage Blob, você pode usar um dos seguintes métodos para melhorar o desempenho:

• AzCopy
• Gerenciador de Armazenamento do Azure

Conteúdo relacionado

• Grupos de dispositivos
• Manifesto de importação da Atualização de Dispositivo