Importar uma atualização de software (versão preliminar)

Antes de implantar uma atualização de software em um grupo de dispositivos ou em dispositivos que se integram a um namespace, você precisa importar a atualização para o namespace do Registro de Dispositivo do Azure. Cada atualização de software consiste em um ou mais arquivos de atualização e um manifesto de importação. O manifesto de importação descreve a identidade da atualização, os dispositivos com os quais ela é compatível e como instalá-la, para que o Azure Device Registry saiba para quais dispositivos a atualização se aplica.

Este artigo mostra como usar o portal Azure ou a CLI do Azure para importar uma atualização de software para um namespace e como excluir uma atualização importada que você não precise mais.

Importante

As atualizações de software do Azure Device Registry estão em versão prévia no momento. A prévia atual é direcionada para dispositivos conectados ao Hub IoT. Esta versão preliminar é fornecida sem um contrato de nível de serviço, e o recurso e a experiência do portal podem ser alterados antes de estarem disponíveis ao público em geral. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.

Prerequisites

  • Uma assinatura de Azure ativa. Se você não tiver uma, crie uma conta gratuita.
  • Um namespace do Azure Device Registry com atualizações de software habilitadas. Para criar um namespace e habilitar atualizações de software, consulte Introdução ao Azure Device Registry para Hub IoT do Azure.
  • Permissões para ler os arquivos de atualização em sua conta de armazenamento, como a função Colaborador de Dados de Blob de Armazenamento.
  • Permissões para importar atualizações de software para o namespace, como a função Device Update Content Administrator na instância de atualizações de software vinculada ao seu namespace. Usuários que só precisam visualizar atualizações importadas podem usar a função Device Update Content Reader em seu lugar. Para obter mais informações, consulte o controle de acesso.
  • Uma conta do Armazenamento do Azure com um contêiner que armazena seus arquivos de atualização e um manifesto de importação:
    • Arquivos de atualização: Os arquivos que seu dispositivo instala, como uma imagem, um pacote ou um script (por exemplo, .swu ou .sh).
    • Manifesto de importação: Um arquivo JSON com extensão .importmanifest.json que descreve a atualização. Toda atualização de software requer um manifesto de importação. Para saber como criar um, consulte Preparar uma atualização para importar e o esquema do manifesto de importação.
  • Para usar o CLI do Azure, use o CLI do Azure com a versão de pré-visualização 1.1.0b1 da extensão azure-iot. Para as etapas de instalação, consulte a configuração do CLI do Azure.

Visualizar atualizações de software importadas

  1. No portal do Azure, acesse seu namespace do Azure Device Registry.
  2. No menu de recursos, em Operações, selecione atualizações de software (prévia).
  3. Na página de Atualizações de Software (prévia), selecione a aba Importações para visualizar as atualizações de software que já foram importadas para o namespace.

Se você ainda não importou nenhuma atualização, a página exibirá Nenhuma atualização para exibir.

Importar uma atualização de software

  1. Em Atualizações de Software (prévia), selecione + Importar.

  2. Em Importar atualizações de software, em seleção de arquivo, selecione + Adicionar arquivos.

    Captura de tela da página Importar atualizações de software com o comando Adicionar arquivos.

  3. Selecione a conta de armazenamento que contém seus arquivos de atualização e então selecione Próximo.

  4. Selecione o contêiner que contém seus arquivos de atualização e então selecione Próximo.

  5. Em Selecionar arquivos, selecione os arquivos de atualização e o arquivo de manifesto de importação (com a extensão .importmanifest.json) que você deseja importar.

    Captura de tela dos arquivos de atualização e de um arquivo de manifesto de importação selecionado em um contêiner de armazenamento.

  6. Feche o seletor de arquivos para retornar a Importar atualizações de software.

  7. Na caixa Descrição, insira, opcionalmente, uma descrição para a atualização.

  8. Em Verificação de malware, selecione Verificar arquivos de atualização em busca de malware se desejar que os arquivos de atualização sejam verificados em busca de malware conhecido antes de serem importados. A varredura de malware está disponível em regiões selecionadas.

  9. Selecione Importar.

Quando a importação for concluída com sucesso, a atualização aparecerá na lista Importações com seu nome, provedor, versão e descrição. Agora você pode implantá-la usando uma tarefa de atualização de software ou uma tarefa de atualização de integração.

Exclua uma atualização de software

Se você não precisar mais de uma atualização importada, pode excluí-la do namespace.

  1. Na página de Atualizações de Software (prévia), selecione a aba Importações .
  2. Selecione a caixa de seleção ao lado da atualização que você quer deletar.
  3. Selecione Excluir.
  4. Quando solicitado, selecione Excluir para confirmar.

Deletar uma atualização de software não afeta dispositivos que já a instalaram. No entanto, você não pode mais usar a atualização em uma nova tarefa.

Troubleshooting

A importação falha porque o manifesto de importação está ausente

No portal do Azure, se você selecionar Atualizar arquivos sem manifesto de importação, a importação falha com a mensagem Nenhum manifesto de importação foi encontrado.

  1. Revise o banner de erro na página de Importar atualizações de software . Lembra que a importação de arquivos de manifesto usa a extensão .importmanifest.json.
  2. Adicione um manifesto de importação que descreva a atualização do seu contêiner de armazenamento.
  3. Selecione Substituir arquivos, depois selecione seus arquivos de atualização e o manifesto de importação.
  4. Selecione Importar novamente.

Note

Nesta prévia, você não pode criar ou editar um manifesto de importação no portal do Azure. Crie o manifesto de importação antes de importar a atualização.