Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Antes de poderes implementar uma atualização de software para um grupo de dispositivos ou para dispositivos que estão integrados num namespace, precisas de importar a atualização para o teu namespace do Azure Device Registry. Cada atualização de software consiste em um ou mais ficheiros de atualização e um manifesto de importação. O manifesto de importação descreve a identidade da atualização, os dispositivos com que é compatível e como a instalar, para que o Azure Device Registry saiba a que dispositivos se aplica a atualização.
Este artigo mostra-lhe como importar uma atualização de software de um contentor do Armazenamento do Azure para um namespace, e como eliminar uma atualização importada que já não precisa.
Importante
As atualizações de software do Azure Device Registry estão atualmente em pré-visualização. A pré-visualização atual destina-se a dispositivos ligados ao Hub IoT. Esta versão preliminar é fornecida sem um acordo de nível de serviço, e a funcionalidade e a sua experiência no portal podem mudar antes de se tornarem geralmente disponíveis. Para mais informações, consulte Termos Suplementares de Utilização para Microsoft Azure Previews.
Prerequisites
- Uma assinatura ativa do Azure. Se não tiver uma, crie uma conta gratuita.
- Um namespace do Azure Device Registry com atualizações de software ativadas. Para criar um namespace e ativar atualizações de software, consulte Começar com o Azure Device Registry para Hub IoT do Azure.
- Permissões para ler os ficheiros de atualização na sua conta de armazenamento, como a função Storage Blob Data Contributor.
- Permissões para importar atualizações de software para o namespace, como o papel Device Update Content Administrator na instância de atualizações de software que está ligada ao seu namespace.
- Uma conta Armazenamento do Azure com um contentor que guarda os seus ficheiros de atualização e um manifesto de importação:
-
Ficheiros de atualização: Os ficheiros que o seu dispositivo instala, como uma imagem, um pacote ou um script (por exemplo,
.swuou.sh). -
Manifesto de importação: Um ficheiro JSON com a
.importmanifest.jsonextensão que descreve a atualização. Cada atualização de software requer um manifesto de importação. Para aprender a criar um, consulte Preparar uma atualização para importar e o esquema de manifestos de importação.
-
Ficheiros de atualização: Os ficheiros que o seu dispositivo instala, como uma imagem, um pacote ou um script (por exemplo,
Vai às atualizações de software no teu namespace
- No Azure portal, aceda ao seu espaço de nomes Azure Device Registry.
- No menu de recursos, em Operações, selecione atualizações de software (pré-visualização).
- Na página de Atualizações de Software (pré-visualização), selecione o separador Importações para visualizar as atualizações de software que já foram importadas para o namespace.
Se ainda não importaste nenhuma atualização, a página mostra Sem atualizações para mostrar.
Importar uma atualização de software
Em atualizações de software (pré-visualização), selecione + Importar.
Em Importar atualizações de software, em seleção de ficheiros, selecione + Adicionar ficheiros.
Selecione a conta de armazenamento que contém os seus ficheiros de atualização e depois selecione Próximo.
Selecione o recipiente que contém os seus ficheiros de atualização e depois selecione Seguinte.
Em Selecionar ficheiros, selecione os ficheiros de atualização e o ficheiro de manifesto de importação (com a
.importmanifest.jsonextensão) que quer importar.Feche o seletor de ficheiros para voltar a Importação de atualizações de software.
Na caixa de Descrição , introduza opcionalmente uma descrição para a atualização.
Em Análise antimalware, selecione Analisar ficheiros de atualização à procura de malware se quiser que os ficheiros de atualização sejam verificados quanto à presença de malware conhecido antes de serem importados. A análise de malware está disponível em regiões selecionadas.
Selecione Importar.
Quando a importação é bem-sucedida, a importação aparece na lista Importações com o seu nome, fornecedor, versão e descrição. Agora pode implementá-lo usando uma tarefa de atualização de software ou uma tarefa de atualização de onboarding.
Corrigir um manifesto de importação em falta
Se selecionar Atualizar ficheiros sem manifesto de importação, a importação falha com a mensagem Nenhum manifesto de importação foi encontrado.
- Verifique o banner de erro na página Importar atualizações de software. Recorda que os ficheiros de manifesto de importação usam a extensão
.importmanifest.json. - Adiciona um manifesto de importação que descreva a atualização do teu recipiente de armazenamento.
- Selecione Substituir ficheiros e depois selecione os ficheiros de atualização e o manifesto de importação.
- Selecione Importar novamente.
Note
Nesta pré-visualização, 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.
Importação de atualizações de itens principais e subordinados
Um manifesto de importação pode referenciar outras atualizações. Por exemplo, uma atualização pai pode referenciar uma ou mais atualizações filhos que devem ser instaladas em conjunto ou numa ordem específica. Quando importas uma atualização principal juntamente com as suas atualizações subordinadas, a lista de Importações mostra a atualização principal com as atualizações subordinadas associadas.
Note
Nesta pré-visualização, o cliente de atualizações de software nos SDKs unificados do Azure IoT não instala atualizações que referenciam outras atualizações. Para implementar em dispositivos que usam o cliente de atualizações de software, importa atualizações cujos manifestos de importação não referenciam atualizações filhas. Para obter mais informações, consulte Limitações da pré-visualização.
Eliminar uma atualização de software
Se já não precisares de uma atualização importada, podes apagá-la do namespace.
- Na página de Atualizações de Software (pré-visualização), selecione o separador Importações .
- Seleciona a caixa de seleção ao lado da atualização que queres apagar.
- Selecione Eliminar.
- Quando solicitado, selecione Apagar para confirmar.
Eliminar uma atualização de software não afeta dispositivos que já a instalaram. No entanto, já não pode usar a atualização numa nova tarefa.