Importa un aggiornamento del software (anteprima)

Prima di poter distribuire un aggiornamento software a un gruppo di dispositivi o a dispositivi che vengono registrati in uno spazio dei nomi, devi importare l'aggiornamento nel tuo namespace Azure Device Registry. Ogni aggiornamento software consiste in uno o più file di aggiornamento e un manifest di importazione. Il manifest di importazione descrive l'identità dell'aggiornamento, i dispositivi con cui è compatibile e come installarlo, così Azure Device Registry sa a quali dispositivi si applica l'aggiornamento.

Questo articolo ti mostra come importare un aggiornamento software da un container Archiviazione di Azure in uno spazio di nomi e come eliminare un aggiornamento importato di cui non hai più bisogno.

Prerequisites

• Una sottoscrizione di Azure attiva. Se non ne hai uno, crea un account gratuito.
• Un namespace di Azure Device Registry con aggiornamenti software abilitati. Per creare uno spazio di nomi e abilitare aggiornamenti software, vedi Introduzione ad Azure Device Registry.
• Permessi per leggere i file di aggiornamento nel tuo account di archiviazione, come il ruolo Storage Blob Data Contributor .
• Permessi per importare aggiornamenti software nel namespace, come il ruolo di Device Update Content Administrator nell'istanza degli aggiornamenti software collegata al tuo namespace.
• Un account Archiviazione di Azure con un container che contiene i tuoi file di aggiornamento e un manifesto di importazione:
  • File di aggiornamento: I file che il tuo dispositivo installa, come un'immagine, un pacchetto o uno script (ad esempio, .swu o .sh).
  • Manifesto di importazione: un file JSON con l'estensione .importmanifest.json che descrive l'aggiornamento. Ogni aggiornamento software richiede un manifest di importazione. Per informazioni su come crearne uno, vedere Preparare un aggiornamento da importare e lo schema del manifest di importazione.

Vai ad aggiornamenti software nel tuo namespace

1. Nel portale Azure, vai al tuo namespace Azure Device Registry.
2. Nel menu risorse, sotto Operazioni, seleziona aggiornamenti software (anteprima).
3. Nella pagina Aggiornamenti software (anteprima), seleziona la scheda Importazioni per visualizzare gli aggiornamenti software già importati nel namespace.

Se non hai ancora importato aggiornamenti, la pagina mostra Nessun aggiornamento da visualizzare.

Importa un aggiornamento software

1. In Aggiornamenti software (anteprima), seleziona + Import.

2. Su Importa aggiornamenti software, sotto Selezione file, seleziona + Aggiungi file.

   

3. Seleziona l'account di archiviazione che contiene i tuoi file di aggiornamento, poi seleziona Avanti.

4. Seleziona il contenitore che contiene i tuoi file di aggiornamento, poi seleziona Avanti.

5. In Seleziona file, selezionare i file di aggiornamento e il file manifest di importazione (con l'estensione .importmanifest.json) che si desidera importare.

   

6. Chiudi il selettore di file per tornare a Importa aggiornamenti software.

7. Nella casella Descrizione , inserisci opzionalmente una descrizione per l'aggiornamento.

8. In Scansione malware, seleziona Scansiona file di aggiornamento per malware se vuoi che i file di aggiornamento vengano controllati per malware noti prima che vengano importati. La scansione malware è disponibile in alcune regioni.

9. Seleziona Importa

Quando l'importazione ha successo, l'elemento importato appare nella lista Importazioni con nome, provider, versione e descrizione. Ora è possibile distribuirlo usando un processo di aggiornamento del software o un processo di aggiornamento dell'onboarding.

Correggi manifest di importazione mancante

Se selezioni Aggiorna file senza un manifest di importazione, l'importazione fallisce con il messaggio Nessun manifest di importazione è stato trovato.

1. Controlla il banner di errore nella pagina Importazione aggiornamenti software . Ti ricorda che i file manifest di importazione usano l'estensione .importmanifest.json.
2. Aggiungi un manifest di importazione che descriva l'aggiornamento del tuo contenitore di archiviazione dati.
3. Seleziona Sostituisci file, poi seleziona i file di aggiornamento e il manifesto di importazione.
4. Seleziona di nuovo Importa.

Importare aggiornamenti di elementi padre e figlio

Un manifesto di importazione può fare riferimento ad altri aggiornamenti. Ad esempio, un aggiornamento genitore può fare riferimento a uno o più aggiornamenti figli che devono essere installati insieme o in un ordine specifico. Quando importi un aggiornamento genitore insieme ai suoi aggiornamenti figli, la lista Importazioni mostra l'aggiornamento genitore con i relativi aggiornamenti figli.

Elimina un aggiornamento software

Se non hai più bisogno di un aggiornamento importato, puoi cancellarlo dal namespace.

1. Nella pagina Aggiornamenti software (anteprima), seleziona la scheda Importazioni.
2. Seleziona la casella accanto all'aggiornamento che vuoi eliminare.
3. Seleziona Elimina.
4. Quando richiesto, selezionare Elimina per confermare.

Eliminare un aggiornamento software non influisce sui dispositivi che lo hanno già installato. Tuttavia, non è più possibile usare l'aggiornamento in un nuovo processo.

Contenuti correlati

• Concetti relativi agli aggiornamenti software (anteprima)
• Distribuisci un aggiornamento software a un gruppo (anteprima)
• Distribuisci un aggiornamento di onboarding in un namespace (anteprima)