Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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,
.swuou.sh). -
Manifesto de importação: Um arquivo JSON com extensão
.importmanifest.jsonque 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.
-
Arquivos de atualização: Os arquivos que seu dispositivo instala, como uma imagem, um pacote ou um script (por exemplo,
- Para usar o CLI do Azure, use o CLI do Azure com a versão de pré-visualização
1.1.0b1da extensãoazure-iot. Para as etapas de instalação, consulte a configuração do CLI do Azure.
Visualizar atualizações de software importadas
- No portal do Azure, acesse seu namespace do Azure Device Registry.
- No menu de recursos, em Operações, selecione atualizações de software (prévia).
- 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
Em Atualizações de Software (prévia), selecione + Importar.
Em Importar atualizações de software, em seleção de arquivo, selecione + Adicionar arquivos.
Selecione a conta de armazenamento que contém seus arquivos de atualização e então selecione Próximo.
Selecione o contêiner que contém seus arquivos de atualização e então selecione Próximo.
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.Feche o seletor de arquivos para retornar a Importar atualizações de software.
Na caixa Descrição, insira, opcionalmente, uma descrição para a atualização.
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.
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.
- Na página de Atualizações de Software (prévia), selecione a aba Importações .
- Selecione a caixa de seleção ao lado da atualização que você quer deletar.
- Selecione Excluir.
- 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.
- 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. - Adicione um manifesto de importação que descreva a atualização do seu contêiner de armazenamento.
- Selecione Substituir arquivos, depois selecione seus arquivos de atualização e o manifesto de importação.
- 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.