Gestire i manifesti di distribuzione IoT Edge nell'applicazione IoT Central

  • Articolo

Un manifesto della distribuzione consente di specificare i moduli che il runtime di IoT Edge deve scaricare e configurare. Un dispositivo IoT Edge può scaricare un manifesto della distribuzione quando si connette per la prima volta all'applicazione IoT Central. Questo articolo descrive come gestire i manifesti di distribuzione nell'applicazione IoT Central.

Per altre informazioni su IoT Edge e IoT Central, vedere Connettere i dispositivi azure IoT Edge a un'applicazione Azure IoT Central.

Per informazioni su come gestire i manifesti di distribuzione usando l'API REST di IoT Central, vedere Come usare l'API REST di IoT Central per gestire i manifesti di distribuzione.

Gestire i manifesti di distribuzione

La pagina Manifesti edge consente di gestire i manifesti di distribuzione nell'applicazione. Da questa pagina è possibile effettuare le seguenti operazioni:

  • Caricare o creare manifesti di distribuzione
  • Modificare i manifesti di distribuzione esistenti
  • Eliminare i manifesti di distribuzione

Caricare e creare manifesti di distribuzione

Quando si crea un nuovo manifesto della distribuzione, è possibile caricare il file JSON del manifesto della distribuzione o iniziare con un manifesto esistente:

  1. Nella pagina Manifesti perimetrali selezionare + Nuovo.

  2. Immettere un nome per il manifesto della distribuzione.

  3. Se l'applicazione usa organizzazioni, selezionare un'organizzazione a cui associare il manifesto della distribuzione.

  4. Cercare un file manifesto della distribuzione da caricare o scegliere un manifesto di distribuzione esistente come punto di partenza per il nuovo file. IoT Central convalida tutti i file caricati.

    Screenshot che mostra un manifesto della distribuzione caricato e convalidato.

  5. Selezionare Avanti. La pagina Verifica e fine mostra informazioni sul manifesto della distribuzione e sui moduli definiti. È anche possibile visualizzare il codice JSON non elaborato.

  6. Selezionare Crea. La pagina Manifesti edge include ora il nuovo manifesto della distribuzione.

Suggerimento

Se si dispone di un numero elevato di manifesti di distribuzione, è possibile ordinare e filtrare l'elenco visualizzato nella pagina Manifesti di Edge .

Modificare l'origine JSON di un manifesto della distribuzione

Per modificare un manifesto della distribuzione modificando direttamente il codice JSON:

  1. Passare alla pagina Manifesti perimetrali .

  2. Selezionare Modifica JSON nel menu di scelta rapida per il manifesto di distribuzione che si vuole modificare.

  3. Usare l'editor JSON per apportare le modifiche necessarie. Selezionare quindi Salva.

Sostituire il contenuto di un manifesto di distribuzione

Per sostituire completamente il contenuto di un manifesto della distribuzione:

  1. Passare alla pagina Manifesti perimetrali .

  2. Selezionare il manifesto della distribuzione che si vuole sostituire.

  3. Nella finestra di dialogo Personalizza cercare un nuovo file manifesto della distribuzione da caricare o scegliere un manifesto di distribuzione esistente come punto di partenza. IoT Central convalida tutti i file caricati.

  4. Selezionare Avanti. Nella pagina Rivedi e fine vengono visualizzate informazioni sul nuovo manifesto della distribuzione e sui moduli definiti. È anche possibile visualizzare il codice JSON non elaborato.

  5. Selezionare Salva. La pagina Manifesti edge include ora il manifesto della distribuzione aggiornato.

Gestire i dispositivi IoT Edge

Quando si aggiunge un dispositivo IoT Edge nella pagina dei dispositivi, è possibile scegliere un manifesto di distribuzione per il dispositivo. Nella finestra di dialogo Crea un nuovo dispositivo è possibile scegliere tra l'elenco dei manifesti del dispositivo caricati in precedenza nella pagina Manifesti edge . È anche possibile aggiungere un manifesto di distribuzione direttamente a un dispositivo dopo aver creato il dispositivo.

Se si aggiunge un dispositivo IoT Edge non assegnato a un modello di dispositivo, la finestra di dialogo Crea un nuovo dispositivo sarà simile alla schermata seguente:

Screenshot che mostra l'aggiunta di un dispositivo non assegnato all'applicazione.

Per scegliere il manifesto della distribuzione per il dispositivo:

  1. Attivare o disattivare Azure IoT Edge dispositivo? su Sì.

  2. Selezionare il manifesto della distribuzione IoT Edge da usare. È anche possibile scegliere di assegnare un manifesto di distribuzione dopo aver creato il dispositivo.

  3. Selezionare Crea.

Se si aggiunge un dispositivo IoT Edge assegnato a un modello di dispositivo, la finestra di dialogo Crea un nuovo dispositivo sarà simile alla schermata seguente:

Screenshot che mostra l'aggiunta di un dispositivo assegnato all'applicazione.

Per scegliere il manifesto della distribuzione per il dispositivo:

  1. L'interruttore Azure IoT Edge dispositivo? è già impostato su Sì perché IoT Central riconosce che si usa un modello di dispositivo IoT Edge.

  2. Selezionare il manifesto della distribuzione IoT Edge da usare. È anche possibile scegliere di assegnare un manifesto di distribuzione dopo aver creato il dispositivo.

  3. Selezionare Crea.

Quando un dispositivo IoT Edge si connette all'applicazione per la prima volta, scarica il manifesto della distribuzione, configura i moduli specificati nel manifesto della distribuzione ed esegue i moduli.

Se non si seleziona un manifesto di distribuzione quando si crea un dispositivo IoT Edge, è possibile assegnarne uno in un secondo momento singolarmente o a più dispositivi usando un processo.

Aggiornare il manifesto della distribuzione usato da un dispositivo

È possibile gestire il manifesto della distribuzione per un dispositivo esistente:

Screenshot che mostra le opzioni per gestire un manifesto di distribuzione in un dispositivo.

Usare Assegna manifesto perimetrale per selezionare un manifesto di distribuzione caricato in precedenza dalla pagina Manifesti edge . È anche possibile usare questa opzione per notificare manualmente a un dispositivo se è stato modificato il manifesto della distribuzione nella pagina Manifesti edge .

Usare Modifica manifesto per modificare il manifesto della distribuzione per questo dispositivo. Le modifiche apportate qui non influiscono sul manifesto della distribuzione nella pagina Manifesti di Edge .

Processi

Per assegnare o aggiornare il manifesto della distribuzione per più dispositivi, usare un processo. Usare il tipo di processo manifesto della distribuzione edge :

Screenshot che mostra il tipo di processo del manifesto della distribuzione.

Aggiungere moduli e proprietà ai modelli di dispositivo

Un manifesto di distribuzione definisce i moduli da eseguire nel dispositivo e, facoltativamente, le proprietà scrivibili che è possibile usare per configurare i moduli.

Se si assegna un modello di dispositivo a un dispositivo IoT Edge, è possibile definire i moduli e le proprietà scrivibili nel modello di dispositivo. Per aggiungere i moduli e le definizioni di proprietà a un modello di dispositivo:

  1. Passare alla pagina Riepilogo moduli del modello di dispositivo IoT Edge.
  2. Selezionare Importa moduli dal manifesto.
  3. Selezionare il manifesto di distribuzione appropriato dall'elenco.
  4. Selezionare Importa. IoT Central aggiunge i moduli personalizzati definiti nel manifesto della distribuzione al modello di dispositivo. I nomi dei moduli nel modello di dispositivo corrispondono ai nomi dei moduli personalizzati nel manifesto della distribuzione. L'interfaccia generata include definizioni di proprietà per le proprietà definite per il modulo personalizzato nel manifesto della distribuzione:

Screenshot che mostra l'importazione delle definizioni dei moduli in un modello di dispositivo.

Passaggi successivi

Dopo aver appreso come gestire i manifesti di distribuzione IoT Edge nell'applicazione Azure IoT Central, il passaggio successivo consigliato consiste nell'apprendere come connettere i dispositivi tramite un gateway trasparente IoT Edge.