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 molti 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.

In questo articolo viene usato il portale di Azure per eseguire le attività seguenti:

  1. Creare un account di archiviazione BLOB.
  2. Sottoscrivere eventi per l'archiviazione BLOB.
  3. Attivare un evento caricando un file nell'archivio BLOB.
  4. Visualizzare il risultato in un'app Web del gestore. In genere, si inviano eventi a un endpoint che elabora i dati dell'evento e intraprende azioni. Per semplificare l'invio di eventi a un'app Web che raccoglie e visualizza i messaggi.

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

Al termine, i dati degli eventi saranno stati inviati all'app Web.

Screenshot that shows the sample Azure Event Grid Viewer app with an event.

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 Archiviazione account e selezionare Archiviazione account dall'elenco dei risultati.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. Nella pagina Archiviazione account 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. Selezionare la sottoscrizione di Azure.

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

    3. Immettere il nome per l'account di archiviazione.

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

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

    6. Selezionare Rivedi nella parte inferiore della pagina.

      Screenshot showing the Create a storage account page.

    7. Nella pagina Verifica 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 showing the deployment succeeded page with a link to go to the resource.

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

    Screenshot showing the Events page for an Azure storage account.

  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 questa guida introduttiva, si distribuisce un'app Web predefinita 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.

    Button to deploy the Resource Manager template to 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. Sarà più semplice eseguire la pulizia dopo aver completato l'esercitazione eliminando il gruppo di risorse.

    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 showing the Custom deployment page.

  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 showing the deployment succeeded page with a link to go to the resource group.

  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 that shows the selection of web app in the resource group.

  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 that shows the selection of link to navigate to web app.

  7. Verificare che venga visualizzato il sito ma che al suo interno non sono stati ancora pubblicati eventi.

    View new site.

    Importante

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

Registrare il provider di risorse di Griglia di eventi

Se non si è usato Griglia di eventi prima, sarà necessario registrare il provider di risorse Griglia di eventi. Se è già stato usato Griglia di eventi, passare alla sezione successiva.

Nella portale di Azure seguire questa procedura:

  1. Nel menu a sinistra selezionare Sottoscrizioni.

  2. Selezionare la sottoscrizione da usare per Griglia di eventi dall'elenco delle sottoscrizioni.

  3. Nella pagina Sottoscrizione selezionare Provider di risorse in Impostazioni nel menu a sinistra.

  4. Cercare Microsoft.EventGrid e verificare che lo stato non sia registrato.

  5. Selezionare Microsoft.EventGrid nell'elenco dei provider.

  6. Selezionare Registra sulla barra dei comandi.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Aggiornare per assicurarsi che lo stato di Microsoft.EventGrid sia cambiato in Registrato.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

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 dell'account 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. Si inviano eventi all'app visualizzatore usando un web hook per l'endpoint.

    Screenshot showing the selection of Web Hook on the Events page.

  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.

      Screenshot showing the Create Event Subscription page with a name for the system topic.

    3. Selezionare Webhook per Tipo di endpoint.

      Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.

  5. Per Endpoint scegliere Selezionare 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 showing the Select Web Hook page.

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

    Screenshot showing the Create Event Subscription page with all fields selected.

  7. Visualizzare nuovamente l'app Web e notare che all'app è stato 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 showing the Event Grid Viewer with the subscription validation event.

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 showing the New container page.

  3. Selezionare il nuovo contenitore.

    Screenshot showing the selection of the container.

  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 showing Upload blob page.

  5. Passare al file di test e caricarlo.

  6. È stato attivato l'evento e Griglia di eventi ha inviato il messaggio all'endpoint configurato al momento della 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 showing the Event Grid Viewer page with the Blob Created event.

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.

Passaggi successivi

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