Condividi tramite


Guida introduttiva: Instradare gli eventi della Cache di Azure per Redis all'endpoint Web con il portale di Azure

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 della cache di Azure per Redis, per sottoscrivere eventi per tale istanza, per 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 questo avvio rapido, si invieranno eventi a un'app Web che raccoglierà e mostrerà 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.

Ridimensionamento del Visualizzatore della Griglia di eventi di Azure in formato JSON.

Creare un'istanza della cache di Azure per Redis

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

    L'opzione Crea una risorsa evidenziata nel riquadro di spostamento sinistro.

  2. Nella pagina Introduzione digitare Cache di Azure per Redis nella casella di ricerca. Quindi, selezionare Crea.

    Screenshot di Azure Marketplace con la cache di Azure per Redis nella casella di ricerca e l'opzione Crea è evidenziata con una casella rossa.

  3. Nella pagina Nuova cache per Redis configurare le impostazioni per la 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 contenente 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 in prossimità di altri servizi che useranno la cache.
    SKU della Cache Nell’elenco a discesa selezionare uno SKU. Lo SKU determina le dimensioni, le prestazioni e i parametri delle funzionalità disponibili per la cache. Per altre informazioni, vedere la panoramica su Cache Redis di Azure.
    Dimensioni della cache Elenco a discesa e selezionare una dimensione della 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 oppure selezionare il pulsante Avanti: Avanzate nella parte inferiore della pagina per visualizzare la scheda Avanzate.

    Screenshot che mostra la scheda Avanzate nel riquadro di lavoro e l'opzione disponibile da selezionare.

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

    Importante

    Per una sicurezza ottimale, Microsoft consiglia di usare Microsoft Entra ID con identità gestite per autorizzare le richieste nella cache quando possibile. L'autorizzazione con Microsoft Entra ID e le identità gestite offre sicurezza e facilità di utilizzo superiori rispetto all'autorizzazione con chiave condivisa. Per altre informazioni sull'uso delle identità gestite con le cache, vedere Usare Microsoft Entra ID per l'autenticazione della cache.

  7. Selezionare la scheda Avanti: Tag oppure 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. Viene visualizzata la 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 un po' di 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 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 in GitHub README per distribuire la soluzione nella sottoscrizione.

    Pulsante Distribuisci 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’istanza della cache. 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 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 omesso.
    Nome 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 omesso.
  3. Selezionare Avvisi (icona della campana) nel portale e quindi Vai al gruppo di risorse.

    Notifica di distribuzione del portale di Azure.

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

  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.

    Sito visualizzatore griglia di eventi vuoto.

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.

Nel portale di Azure seguire questa procedura:

  1. Nel menu a sinistra, selezionare Sottoscrizioni.

  2. Selezionare la sottoscrizione di Griglia di eventi che si vuole usare 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 sia non registrato.

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

  6. Selezionare Registra sulla barra dei comandi.

    Immagine che mostra la registrazione del provider Microsoft.EventGrid con la sottoscrizione di Azure.

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

    Immagine che mostra la corretta registrazione del provider Microsoft.EventGrid con la sottoscrizione di Azure.

Sottoscrivere l'istanza della cache di Azure per Redis

In questo passaggio, si sottoscriverà un argomento per indicare a Griglia di eventi gli eventi di cui si vuole tenere traccia e dove inviare tali 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. Vengono inviati eventi all'app di visualizzazione tramite un webhook per l'endpoint.

    Pagina Eventi del portale di Azure.

  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 avere una lunghezza compresa tra 3 e 64 caratteri. Può contenere solo lettere, numeri e trattini.
    Tipi di eventi Dal menu a discesa 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 dell'evento per ricevere gli eventi.
    Endpoint Scegliere Seleziona endpoint, immettere l'URL dell'app Web e aggiungere api/updates all'URL della home page, ad esempio https://cache.azurewebsites.net/api/updates, 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.

    Visualizzatore Griglia di eventi di Azure.

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 della cache di Azure per Redis verrà ridimensionata.

  1. Nel portale di Azure passare all'istanza della 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 è in corso il ridimensionamento della cache in base al nuovo piano tariffario, tramite Cache di Azure per Redis sulla sinistra viene visualizzato lo stato Ridimensionamento. 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. Si noterà che è stato ricevuto un evento ScalingCompleted.

    Ridimensionamento del Visualizzatore della Griglia di eventi di Azure in formato JSON.

Pulire le risorse

Se si intende continuare a usare questo evento, non è necessario 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: