Condividi tramite

Recapitare eventi a Hub eventi di Azure usando argomenti dello spazio dei nomi - Portale di Azure

  • Articolo

L’articolo fornisce istruzioni dettagliate su come pubblicare eventi in Griglia di eventi di Azure in formato JSON CloudEvents e recapitarli usando il modello di recapito push.

Per la precisione, si useranno il portale di Azure e Curl per pubblicare eventi in un argomento dello spazio dei nomi in Griglia di eventi ed eseguire il push di tali eventi da una sottoscrizione eventi a una destinazione del gestore di Hub eventi. Per ulteriori informazioni sul modello di recapito push, vedere Panoramica del recapito push.

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

Creare uno spazio dei nomi di Griglia di eventi

Uno spazio dei nomi di Griglia di eventi fornisce un endpoint definito dall'utente a cui gli eventi vengono pubblicati. L'esempio seguente crea uno spazio dei nomi nel gruppo di risorse usando Bash in Azure Cloud Shell. Il nome dello spazio dei nomi deve essere univoco, poiché fa parte di una voce Domain Name System (DNS).

  1. Passare al portale di Azure.

  2. Nella barra di ricerca dell'argomento, digitare Event Grid Namespaces e selezionare Event Grid Namespaces tra i risultati.

    Screenshot che mostra la barra di ricerca nel portale di Azure.

  3. Nella pagina Spazi dei nomi di Griglia di eventi, selezionare + Crea sulla barra dei comandi. Screenshot che mostra la pagina Spazi dei nomi di Griglia di eventi con il pulsante Crea sulla barra dei comandi selezionata.

  4. Nella pagina Crea spazio dei nomi, seguire questa procedura:

    1. Selezionare la sottoscrizione di Azure in cui creare lo spazio dei nomi.
    2. Creare un nuovo gruppo di risorse selezionando Crea nuovo o selezionare un gruppo di risorse esistente.
    3. Immettere un nome per lo spazio dei nomi.
    4. Selezionare il percorso in cui si vuole creare il gruppo di risorse.
    5. Quindi selezionare Rivedi e crea.
      Screenshot che mostra la pagina Crea spazio dei nomi.
    6. Nella pagina Rivedi e crea selezionare Crea.

  5. Nella pagina Distribuzione, selezionare Vai alla risorsa dopo che la distribuzione è stata completata con successo.

Ottenere la chiave di accesso

  1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Chiavi di accesso nel menu a sinistra.
  2. Selezionare il pulsante copia accanto alla chiave di accesso. Screenshot che mostra la pagina Spazi dei nomi di Griglia di eventi con la scheda Chiavi di accesso selezionata.
  3. Salvare la chiave di accesso da qualche parte. perché verrà usato in seguito.

Abilitare l'identità gestita per lo spazio dei nomi di Griglia di eventi

Abilitare l'identità gestita assegnata dal sistema nello spazio dei nomi di Griglia di eventi. Per recapitare eventi agli hub eventi nello spazio dei nomi di Hub eventi usando l'identità gestita, seguire questa procedura:

  1. Abilitare l'identità gestita assegnata dal sistema o dall'utente: spazi dei nomi. Continuare a leggere la sezione successiva per informazioni su come abilitare l'identità gestita usando l'interfaccia della riga di comando di Azure.
  2. Aggiungere l'identità al ruolo Mittente dati di Hub eventi di Azure nello spazio dei nomi di Hub eventi; continuare a leggere la sezione successiva per scoprire come aggiungere l'assegnazione di ruolo.
  3. Configurare la sottoscrizione eventi che usa un hub eventi come endpoint per usare l'identità gestita assegnata dal sistema o dall'utente.

In questa sezione, si abiliterà un'identità gestita assegnata dal sistema nello spazio dei nomi. Gli altri passaggi saranno effettuati più avanti in questo avvio rapido.

  1. Nella pagina Spazio dei nomi di Griglia di eventi, selezionare Identità nel menu a sinistra.

  2. Nella pagina Identità, selezionare Attivata come Stato.

  3. Nella barra dei comandi, seleziona Salva.

    Screenshot che mostra la scheda Identità della pagina Spazi dei nomi di Griglia di eventi.

Creare un argomento nello spazio dei nomi

Creare un argomento volto a contenere tutti gli eventi pubblicati nell'endpoint dello spazio dei nomi.

  1. Selezionare Argomenti nel menu a sinistra.
  2. Nella pagina Argomenti, selezionare + Argomento sulla barra dei comandi. Screenshot che mostra la pagina Argomenti.
  3. Nella pagina Crea argomento procedere come segue:
    1. Immettere un nome per l'argomento.
    2. Seleziona Crea.
      Screenshot che mostra la pagina Crea argomento.

Creare uno spazio dei nomi di Hub eventi

Creare una risorsa di Hub eventi usata come destinazione del gestore per la sottoscrizione del recapito push dell'argomento dello spazio dei nomi. Eseguire questi passaggi in un’altra scheda del browser Internet o in un’altra finestra. Passare al portale di Azure e accedere usando le stesse credenziali usate in precedenza e la stessa sottoscrizione di Azure.

  1. Digitare Hub eventi nella barra di ricerca e selezionare Hub eventi.
  2. Nella pagina Hub eventi, selezionare + Crea sulla barra dei comandi.
  3. Nella pagina Crea spazio dei nomi, seguire questa procedura:
    1. Selezionare la sottoscrizione di Azure usata per creare lo spazio dei nomi di Griglia di eventi.
    2. Selezionare il gruppo di risorse usato in precedenza.
    3. Immettere un nome per lo spazio dei nomi di Hub eventi.
    4. Selezionare la stessa posizione usata per lo spazio dei nomi di Griglia di eventi.
    5. Selezionare Basic come piano tariffario.
    6. Selezionare Rivedi e crea. Screenshot che mostra la pagina Crea spazio dei nomi di Hub eventi.
    7. Nella pagina Rivedi selezionare Crea.
  4. Nella pagina Distribuzione, selezionare Vai alla risorsa dopo che la distribuzione è stata completata con successo.

Aggiungere un'identità gestita di Griglia di eventi al ruolo Mittente dati di Hub eventi

  1. Nella pagina Spazio dei nomi di Hub eventi, selezionare Controllo di accesso (IAM) nel menu a sinistra.
  2. Selezionare Aggiungi ->Aggiungi assegnazione di ruolo sulla barra dei comandi. Screenshot che mostra la pagina Spazio dei nomi di Hub eventi con la scheda Controllo di accesso selezionata.
  3. Nella pagina Aggiungi assegnazione di ruolo, cercare Mittente dati di Hub eventi e selezionare Mittente dati di Hub eventi di Azure nell'elenco dei ruoli, quindi selezionare Avanti. Screenshot che mostra la pagina Aggiungi assegnazione di ruolo.
  4. Nella scheda Membri, selezionare Identità gestita per il tipo e quindi + Seleziona membri. Screenshot che mostra la scheda Membri della pagina Aggiungi assegnazione di ruolo.
  5. Nella pagina Seleziona identità gestite, selezionare Spazio dei nomi di Griglia di eventi per l'identità gestita e quindi selezionare l'identità gestita con lo stesso nome dello spazio dei nomi di Griglia di eventi. Screenshot che mostra la pagina Seleziona identità gestite.
  6. Nella pagina Seleziona identità gestite, scegliere Seleziona. Screenshot che mostra l'identità gestita selezionata.
  7. Nella pagina Aggiungi assegnazione di ruolo, selezionare Rivedi e assegna. Screenshot che mostra la pagina Aggiungi assegnazione di ruolo con l'identità gestita selezionata.
  8. Nella pagina Rivedi + assegna, selezionare Rivedi + assegna.

Creare un hub eventi

  1. Nella pagina dello spazio dei nomi di Hub eventi, selezionare Hub eventi nel menu a sinistra.
  2. Nella pagina Hub eventi, selezionare + Hub eventi sulla barra dei comandi. Screenshot che mostra la pagina Hub eventi con + Hub eventi selezionato.
  3. Nella pagina Crea hub eventi, immettere un nome per l'hub eventi e quindi selezionare Rivedi e crea. Screenshot che mostra la pagina Crea hub eventi.
  4. Nella pagina Rivedi e crea selezionare Crea.

Creare una sottoscrizione di eventi

Creare una sottoscrizione eventi impostando la modalità di recapito su Push, la quale supporta il recapito push.

  1. Passare alla scheda o finestra con la pagina Spazio dei nomi Griglia di eventi aperta dalla scheda o finestra con la pagina Spazio dei nomi di Hub eventi aperta.
  2. Nella pagina Spazio dei nomi Griglia di eventi, selezionare Argomenti nel menu a sinistra.
  3. Nella pagina Argomenti, selezionare l'argomento creato nel passaggio precedente.
  4. Selezionare + Sottoscrizione sulla barra dei comandi. Screenshot che mostra la pagina Argomento con il pulsante Crea sottoscrizione selezionato.
  5. Nella pagina Crea sottoscrizione di eventi procedere come segue:
    1. Nella scheda Basic, immettere un nome per la sottoscrizione eventi.
    2. Selezionare Push come modalità di recapito degli eventi.
    3. Verificare che l’Hub eventi sia selezionato come Tipo di endpoint.
    4. Selezionare Configura un endpoint. Screenshot che mostra la pagina Crea sottoscrizione con Push selezionato come modalità di recapito.
    5. Nella pagina Seleziona hub eventi, seguire questa procedura:
      1. Selezionare la sottoscrizione di Azure e il gruppo di risorse con l'hub eventi.
      2. Selezionare lo spazio dei nomi di Hub eventi e l'hub eventi.
      3. Quindi, selezionare Conferma selezione. Screenshot che mostra la pagina Seleziona hub eventi.
    6. Nella pagina Crea sottoscrizione. selezionare Assegnata dal sistema come Tipo di identità gestita. Screenshot che mostra la pagina Crea sottoscrizione con l'impostazione Assegnata dal sistema per il tipo di identità gestita.
    7. Seleziona Crea.

Inviare eventi all'argomento

Ora, inviare un evento campione all'argomento dello spazio dei nomi seguendo la procedura descritta in questa sezione.

  1. Avviare Cloud Shell nel portale di Azure. Passare a Bash.

    Screenshot che mostra Cloud Shell.

  2. In Cloud Shell, eseguire il comando seguente per dichiarare una variabile che contenga la chiave di accesso per lo spazio dei nomi. La chiave di accesso è stata annotata in precedenza durante questo avvio rapido.

    key=ACCESSKEY

  3. Dichiarare una variabile per contenere l'URI dell'operazione di pubblicazione. Sostituire NAMESPACENAME con il nome dello spazio dei nomi di Griglia di eventi e TOPICNAME con il nome dell'argomento.

    publish_operation_uri=https://NAMESPACENAME.eastus-1.eventgrid.azure.net/topics/TOPICNAME:publish?api-version=2023-06-01-preview

  4. Creare un evento campione conforme a CloudEvents:

    event=' { "specversion": "1.0", "id": "'"$RANDOM"'", "type": "com.yourcompany.order.ordercreatedV2", "source" : "/mycontext", "subject": "orders/O-234595", "time": "'`date +%Y-%m-%dT%H:%M:%SZ`'", "datacontenttype" : "application/json", "data":{ "orderId": "O-234595", "url": "https://yourcompany.com/orders/o-234595"}} '

    L'elemento data è il payload dell'evento. Questo campo accetta qualsiasi JSON ben formato. Per ulteriori informazioni sulle proprietà, note anche come attributi di contesto, che è possibile includere in un evento, vedere le specifiche di CloudEvents.

  5. Usare CURL per inviare l'evento all'argomento. CURL è un'utilità che invia richieste HTTP.

    curl -X POST -H "Content-Type: application/cloudevents+json" -H "Authorization:SharedAccessKey $key" -d "$event" $publish_operation_uri

    Passare alla pagina Spazio dei nomi di Hub eventi nel portale di Azure, aggiornare la pagina e verificare che il contatore dei messaggi in arrivo nel grafico indichi che è stato ricevuto un evento.

    Screenshot che mostra la pagina Hub eventi con il grafico che indica che è stato ricevuto un evento.

Passaggi successivi

In questo articolo sono stati creati e configurati lo spazio dei nomi di Griglia di eventi e le risorse di Hub eventi. Per istruzioni dettagliate su come ricevere eventi da un hub eventi, vedere queste esercitazioni: