Guida introduttiva: Indirizzare gli eventi cache di Azure per Redis all'endpoint Web con il portale di Azure

  • Articolo

Griglia di eventi di Azure è un servizio di gestione degli eventi per il cloud. In questa guida introduttiva si userà il portale di Azure per creare un'istanza di cache di Azure per Redis, sottoscrivere eventi per tale istanza, attivare un evento e visualizzare i risultati. In genere, si inviano eventi a un endpoint che elabora i dati dell'evento e intraprende azioni. Tuttavia, per semplificare questa guida introduttiva, si invieranno eventi a un'app Web che raccoglierà e visualizzerà i messaggi.

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 sono stati inviati all'app Web.

Azure Event Grid Viewer scaling in JSON format.

Creare un'istanza della cache cache di Azure per Redis

  1. Per creare una cache, accedere al portale di Azure e selezionare Crea una risorsa.

    Create a resource is highlighted in the left navigation pane.

  2. Nella pagina Nuovo selezionare Database e quindi Cache di Azure per Redis.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  3. Nella pagina Nuova cache Redis configurare le impostazioni per la nuova cache.

    Impostazione Scegliere un valore Descrizione
    Abbonamento Nell'elenco a discesa selezionare la sottoscrizione. Sottoscrizione in cui creare la nuova istanza della cache di Azure per Redis.
    Gruppo di risorse Nell'elenco a discesa selezionare un gruppo di risorse oppure scegliere Crea nuovo e immettere il nome di un nuovo gruppo di risorse. Nome del gruppo di risorse in cui creare la cache e altre risorse. L'inserimento di tutte le risorse di un'app in un unico gruppo di risorse ne semplifica la gestione o l'eliminazione.
    Nome DNS Immettere un nome univoco. Il nome della cache deve essere una stringa compresa tra 1 e 63 caratteri che contengono solo numeri, lettere o trattini. Il nome deve iniziare e terminare con un numero o una lettera e non può contenere trattini consecutivi. Il nome host dell'istanza della cache è< nome> DNS.redis.cache.windows.net.
    Location Nell'elenco a discesa selezionare una località. Selezionare un'area vicina ad altri servizi che usano la cache.
    Tipo di cache A discesa e selezionare un livello. Il livello determina le dimensioni, le prestazioni e le funzionalità disponibili per la cache. Per altre informazioni, vedere la panoramica su Cache Redis di Azure.

  4. Selezionare la scheda Rete o selezionare il pulsante Rete nella parte inferiore della pagina.

  5. Nella scheda Rete selezionare il metodo di connettività.

  6. Selezionare la scheda Avanti: Avanzate o selezionare il pulsante Avanti: Avanzate nella parte inferiore della pagina per visualizzare la scheda Avanzate .

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • Per le cache Basic o Standard, attivare o disattivare la selezione per una porta non TLS. È anche possibile selezionare se si vuole abilitare l'autenticazione di Microsoft Entra.
    • Per una cache Premium, configurare le impostazioni per la porta non TLS, il clustering, l'identità gestita e la persistenza dei dati. È anche possibile selezionare se si vuole abilitare l'autenticazione di Microsoft Entra.

  7. Selezionare la scheda Avanti: Tag o selezionare il pulsante Avanti: Tag nella parte inferiore della pagina.

  8. Facoltativamente, nella scheda Tag immettere il nome e il valore se si vuole categorizzare la risorsa.

  9. Selezionare Rivedi e crea. Si viene reindirizzati alla scheda Rivedi e crea in cui Azure convalida la configurazione.

  10. Quando viene visualizzato il messaggio di convalida verde, selezionare Crea.

La creazione di una cache richiede tempo. È possibile monitorare lo stato di avanzamento nella pagina Panoramica della cache di Azure per Redis. Quando l'elemento Stato indica In esecuzione, la cache è pronta per l'uso.

Creare un endpoint del messaggio

Prima di sottoscrivere gli eventi per l'istanza della cache, 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 distribuirà 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 Deploy to Azure in GitHub README (Distribuisci in Azure in GitHub README) per distribuire la soluzione nella sottoscrizione.

    Deploy to Azure button.

  2. Nella pagina Distribuzione personalizzata procedere come segue:

    1. Per Gruppo di risorse selezionare il gruppo di risorse creato durante la creazione dell'istanza della cache. 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 la casella di controllo Accetto le condizioni riportate sopra.
    5. Selezionare Acquista.
    Impostazione Valore suggerito Descrizione
    Abbonamento Nell'elenco a discesa selezionare la sottoscrizione. Sottoscrizione in cui si vuole creare l'app Web.
    Gruppo di risorse Nell'elenco a discesa selezionare un gruppo di risorse oppure scegliere Crea nuovo e immettere il nome di un nuovo gruppo di risorse. L'inserimento di tutte le risorse di un'app in un unico gruppo di risorse ne semplifica la gestione o l'eliminazione.
    Nome del sito Immettere un nome per l'app Web. Questo valore non può essere vuoto.
    Nome del piano di hosting Immettere un nome per il piano di servizio app da usare per l'hosting dell'app Web. Questo valore non può essere vuoto.

  3. Selezionare Avvisi (icona della campana) nel portale e quindi Vai al gruppo di risorse.

    Azure portal deployment notification.

  4. Nell'elenco di risorse della pagina Gruppo di risorse selezionare l'app Web creata. Verranno visualizzati anche il piano di servizio app e l'istanza della cache in questo elenco.

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

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

    Empty Event Grid Viewer site.

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'istanza di cache di Azure per Redis

In questo passaggio si sottoscriverà un argomento per indicare a Griglia di eventi gli eventi da tenere traccia e dove inviare gli eventi.

  1. Nel portale passare all'istanza della cache creata in precedenza.

  2. Nella pagina cache di Azure per Redis selezionare Eventi nel menu a sinistra.

  3. Selezionare Webhook. Si inviano eventi all'app visualizzatore usando un web hook per l'endpoint.

    Azure portal Events page.

  4. Nella pagina Crea sottoscrizione di eventi immettere quanto segue:

    Impostazione Valore suggerito Description
    Nome Immettere un nome per la sottoscrizione di eventi. Il valore deve essere compreso tra 3 e 64 caratteri. Può contenere solo lettere, numeri e trattini.
    Tipi di evento A discesa e selezionare i tipi di evento di cui si vuole eseguire il push nella destinazione. Per questa guida introduttiva, verrà ridimensionata l'istanza della cache. L'applicazione di patch, il ridimensionamento, l'importazione e l'esportazione sono le opzioni disponibili.
    Tipo di endpoint Selezionare Webhook. Gestore eventi per ricevere gli eventi.
    Endpoint Selezionare Seleziona un endpoint e immettere l'URL dell'app Web e aggiungere api/updates all'URL della home page (ad esempio: https://cache.azurewebsites.net/api/updates) e quindi selezionare Conferma selezione. Si tratta dell'URL dell'app Web creata in precedenza.

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

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

    Azure Event Grid Viewer.

Inviare un evento all'endpoint

A questo punto, attivare un evento per vedere come la griglia di eventi distribuisce il messaggio nell'endpoint. L'istanza di cache di Azure per Redis verrà ridimensionata.

  1. Nella portale di Azure passare all'istanza di cache di Azure per Redis e selezionare Ridimensiona nel menu a sinistra.

  2. Selezionare il piano tariffario desiderato nella pagina Ridimensiona e selezionare Seleziona.

    Il passaggio a un piano tariffario diverso è soggetto alle restrizioni seguenti:

    • Non è possibile passare da un piano tariffario superiore a uno inferiore.
      • Non è possibile passare da una cache Premium a una cache Standard o Basic.
      • Non è possibile passare da una cache Standard a una cache Basic.
    • È possibile passare da una cache Basic a una cache Standard, ma non è possibile modificare contemporaneamente la dimensione. Se occorre una dimensione diversa, è possibile eseguire successivamente un'operazione di ridimensionamento in base ai propri requisiti.
    • Non è possibile passare direttamente da una cache Basic a una cache Premium. È innanzitutto necessario passare da Basic a Standard con una prima operazione di ridimensionamento e quindi da Standard a Premium con una successiva operazione.
    • Non è possibile passare da una dimensione maggiore alla dimensione C0 (250 MB) .

    Mentre la cache viene ridimensionata al nuovo piano tariffario, viene visualizzato uno stato di ridimensionamento usando cache di Azure per Redis a sinistra. Al termine dell'operazione, lo stato passa da Ridimensionamento a In esecuzione.

  3. È 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 e notare che è stato ricevuto un evento ScalingCompleted .

    Azure Event Grid Viewer scaling in JSON format.

Pulire le risorse

Se si prevede di continuare a usare questo evento, non pulire le risorse create in questa guida introduttiva. In caso contrario, eliminare le risorse create in questa guida introduttiva.

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: