Condividi tramite

Guida introduttiva: Usare Griglia di eventi di Azure per instradare gli eventi di archiviazione BLOB all'endpoint Web (portale di Azure)

  • Articolo

Griglia di eventi è un servizio completamente gestito che consente di gestire facilmente gli eventi in numerosi servizi e applicazioni di Azure diversi. Semplifica la creazione di applicazioni basate su eventi e serverless. Per una panoramica del servizio, vedere Panoramica di Griglia di eventi.

Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.

Al termine, si noterà che i dati dell'evento vengono inviati all'app Web.

Screenshot che mostra l'app visualizzatore Griglia di eventi di Azure di esempio con un evento.

Creare un account di archiviazione

  1. Accedi al portale di Azure.

  2. Per creare un account di archiviazione BLOB, selezionare Crea una risorsa.

  3. In Cerca immettere Account di archiviazione e selezionare Account di archiviazione nell'elenco dei risultati.

    Screenshot che mostra la ricerca dell'account di archiviazione nella pagina Crea una risorsa.

  4. Nella pagina Account di archiviazione selezionare Crea per iniziare a creare l'account di archiviazione. Per sottoscrivere gli eventi, è necessario creare un account di archiviazione per utilizzo generico v2 o un account di archiviazione BLOB.

  5. Nella pagina Crea account di archiviazione eseguire la procedura seguente:

    1. Seleziona la tua sottoscrizione di Azure.

    2. In Gruppo di risorse creare un nuovo gruppo di risorse o selezionarne uno esistente.

    3. Immettere il nome dell'account di archiviazione.

    4. Selezionare l'area in cui si vuole creare l'account di archiviazione.

    5. Per Servizio primario selezionare Archiviazione BLOB di Azure o Azure Data Lake Storage Gen 2.

    6. Per Ridondanza selezionare Archiviazione con ridondanza locale dall'elenco a discesa.

    7. Selezionare Rivedi e crea nella parte inferiore della pagina.

      Screenshot che mostra la pagina Crea un account di archiviazione.

    8. Nella scheda Rivedi e crea esaminare le impostazioni e selezionare Crea.

      Nota

      Solo gli account di archiviazione di tipo archiviazione V2 (utilizzo generico v2) e BlobStorage supportano l'integrazione degli eventi. Archiviazione (utilizzo generico v1) non supporta l'integrazione con Griglia di eventi.

  6. Il completamento della distribuzione richiede alcuni minuti. Nella pagina Distribuzione selezionare Vai alla risorsa.

    Screenshot che mostra la pagina della distribuzione riuscita con un collegamento per passare alla risorsa.

  7. Nel menu sinistro della pagina Account di archiviazione selezionare Eventi.

    Screenshot che mostra la pagina Eventi per un account di archiviazione di Azure.

  8. Mantenere aperta questa pagina nel Web browser.

Creare un endpoint del messaggio

Prima di sottoscrivere gli eventi per l'account di archiviazione BLOB, creare l'endpoint per il messaggio dell'evento. L'endpoint richiede in genere azioni basate sui dati degli eventi. Per semplificare questo avvio rapido, si distribuisce un'app Web preesistente che visualizza i messaggi di evento. La soluzione distribuita include un piano di servizio app, un'app Web del servizio app e codice sorgente da GitHub.

  1. Selezionare Distribuisci in Azure per distribuire la soluzione nella sottoscrizione.

    Pulsante per distribuire il modello di Resource Manager in Azure.

  2. Nella pagina Distribuzione personalizzata procedere come segue:

    1. Per Gruppo di risorse selezionare il gruppo di risorse creato durante la creazione dell'account di archiviazione. Eliminando il gruppo di risorse, sarà più facile eseguire la pulizia dopo aver completato l'esercitazione.

    2. Per Nome sito immettere un nome per l'app Web.

    3. Per Nome piano di hosting immettere un nome per il piano del servizio app da usare per l'hosting dell'app Web.

    4. Selezionare Rivedi e crea.

      Screenshot che mostra la pagina Distribuzione personalizzata.

  3. Nella pagina Rivedi e crea selezionare Crea.

  4. Il completamento della distribuzione richiede alcuni minuti. Nella pagina Distribuzione selezionare Vai al gruppo di risorse.

    Screenshot che mostra la pagina della distribuzione riuscita con un collegamento per passare al gruppo di risorse.

  5. Nell'elenco di risorse della pagina Gruppo di risorse selezionare l'app Web creata. Questo elenco include anche il piano di servizio app e l'account di archiviazione.

    Screenshot che mostra la selezione dell'app Web nel gruppo di risorse.

  6. Nella pagina Servizio app per l'app Web selezionare l'URL per passare al sito Web. Il file deve essere nel formato https://<your-site-name>.azurewebsites.net.

    Screenshot che mostra la selezione del collegamento per passare all'app Web.

  7. Confermare che il sito viene visualizzato ma non viene ancora inviato alcun evento.

    Visualizzare il nuovo sito.

    Importante

    Mantenere aperta la finestra del visualizzatore Griglia di eventi di Azure in modo che sia possibile visualizzare gli eventi durante la pubblicazione.

Sottoscrivere l'account di archiviazione BLOB

Si sottoscrive un argomento per indicare a Griglia di eventi gli eventi di cui si vuole tenere traccia e dove inviare tali eventi.

  1. Se è stata chiusa la pagina Account di archiviazione, passare all'account Archiviazione di Azure creato in precedenza. Nel menu sinistro selezionare Tutte le risorse e quindi l'account di archiviazione.

  2. Nel menu sinistro della pagina Account di archiviazione selezionare Eventi.

  3. Selezionare Altre opzioni e Webhook. Vengono inviati eventi all'app di visualizzazione tramite un webhook per l'endpoint.

    Screenshot che mostra la selezione di Web Hook nella pagina Eventi.

  4. Nella pagina Crea sottoscrizione di eventi seguire questa procedura:

    1. Immettere un nome per la sottoscrizione di eventi.

    2. Immettere un nome per l'argomento di sistema. Per informazioni sugli argomenti di sistema, vedere Panoramica degli argomenti di sistema.

    3. Verificare che Tipo di endpoint sia impostato su Web Hook.

      Screenshot che mostra la pagina Crea sottoscrizione di eventi con un nome per l'argomento di sistema.

  5. Per Endpoint selezionare Configura un endpoint e immettere l'URL dell'app Web e aggiungere api/updates all'URL della home page (ad esempio: https://spegridsite.azurewebsites.net/api/updates), quindi selezionare Conferma selezione.

    Screenshot che mostra la pagina Seleziona web hook.

  6. A questo punto, nella pagina Crea sottoscrizione di eventi selezionare Crea per creare la sottoscrizione di eventi.

    Screenshot che mostra la pagina Crea sottoscrizione di eventi con tutti i campi selezionati.

  7. Visualizzare di nuovo l'app Web e notare che viene inviato un evento di convalida della sottoscrizione. Selezionare l'icona a forma di occhio per espandere i dati dell'evento. Griglia di eventi invia l'evento di convalida in modo che l'endpoint possa verificare che voglia ricevere i dati dell'evento. L'app Web include il codice per la convalida della sottoscrizione.

    Screenshot che mostra il Visualizzatore Griglia di eventi con l'evento di convalida della sottoscrizione.

A questo punto, attivare un evento per vedere come la griglia di eventi distribuisce il messaggio nell'endpoint.

Inviare un evento all'endpoint

Per attivare un evento per l'account di archiviazione BLOB, caricare un file. Non sono necessari contenuti specifici per il file.

  1. Nella portale di Azure passare all'account di archiviazione BLOB e selezionare Contenitori dal menu Consenti.

  2. Selezionare + Contenitore. Assegnare un nome al contenitore e usare qualsiasi livello di accesso e selezionare Crea.

    Screenshot che mostra la pagina Nuovo contenitore.

  3. Selezionare il nuovo contenitore.

    Screenshot che mostra la selezione del contenitore.

  4. Per caricare un file, selezionare Carica. Nella pagina Carica BLOB individuare e selezionare il file da caricare per i test, quindi selezionare Carica in tale pagina.

    Screenshot che mostra la pagina Carica BLOB per caricare un'immagine di esempio.

  5. Passare al file di test e caricarlo.

  6. L'evento è stato attivato e Griglia di eventi ha inviato il messaggio all'endpoint configurato durante la sottoscrizione. Il messaggio è in formato JSON e contiene una matrice con uno o più eventi. Nell'esempio seguente il messaggio JSON contiene una matrice con un solo evento. Visualizzare l'app Web. Si noterà che è stato ricevuto un evento creato da un BLOB.

    Screenshot che mostra la pagina Visualizzatore Griglia di eventi con l'evento Blob Created.

Pulire le risorse

Se si intende continuare a usare questo evento, non è necessario pulire le risorse create con questo articolo. In caso contrario, eliminare le risorse create in questo articolo.

Selezionare il gruppo di risorse e quindi fare clic su Elimina gruppo di risorse.

Contenuto correlato

Ora che si è appreso come creare argomenti personalizzati e sottoscrizioni di eventi, è possibile approfondire le operazioni possibili con Griglia di eventi: