Esercizio - Usare l'interfaccia della riga di comando di Azure per creare un hub eventi

Completato

È ora possibile creare un nuovo hub eventi. Dopo averla creata con i comandi dell'interfaccia della riga di comando di Azure, usare il portale di Azure per visualizzare il nuovo hub.

Creare uno spazio dei nomi di Hub eventi

Creare uno spazio dei nomi di Hub eventi usando l'interfaccia della riga di comando di Azure e Bash in Azure Cloud Shell a destra.

  1. Prima di tutto, assegnare valori predefiniti che possono essere riutilizzati in modo da non dover immettere questi valori con ogni comando. In particolare, verranno impostati il gruppo di risorse e la località. Immettere il comando seguente in Cloud Shell e sostituire il valore della posizione con un'area vicina all'utente.

    az configure --defaults group=<rgn>[sandbox Resource Group]</rgn> location=westus2  
    

    La sandbox gratuita consente di creare risorse in un subset delle aree globali di Azure. Selezionare un'area nell'elenco durante la creazione delle risorse:

    • westus2
    • Stati Uniti centro-meridionali
    • centralus
    • eastus
    • westeurope
    • Asia sud-orientale
    • japaneast
    • brazilsouth
    • australiasoutheast
    • centralindia

    Suggerimento

    È possibile usare il pulsante Copia per copiare i comandi negli Appunti. Per incollare, fare clic con il pulsante destro del mouse su una nuova riga nel terminale di Cloud Shell e scegliere Incolla oppure usare i tasti di scelta rapida MAIUSC+INS (⌘+V in macOS).

  2. Creare lo spazio dei nomi di Hub eventi eseguendo il comando dell'interfaccia della riga di comando di Azure seguente, che accetta questi parametri:

    Parametro Descrizione
    --name (obbligatorio) Nome univoco per lo spazio dei nomi di Hub eventi. Il nome deve avere una lunghezza compresa tra 6 e 50 caratteri, iniziare con una lettera, terminare con una lettera o un numero e contenere solo lettere, numeri e trattini.
    --resource-group (obbligatorio) Questo parametro può essere omesso perché viene predefinito per il gruppo di risorse sandbox fornito dal comando precedente.
    --location (facoltativo) Questo parametro può essere omesso perché viene predefinito per la posizione (area) fornita dal comando precedente.
    --sku (facoltativo) Il valore predefinito per questo parametro, se omesso, è Standard, ovvero il valore desiderato. Lo SKU determina le connessioni e le soglie dei consumer.
  3. Prima di eseguire il comando, tuttavia, si imposta il nome dello spazio dei nomi come variabile di ambiente in modo da poterlo riutilizzare.

    NS_NAME=ehubns-$RANDOM
    
  4. Quando si esegue questo comando, il nome dello spazio dei nomi è già definito automaticamente e il comando dell'interfaccia della riga di comando lo crea.

    az eventhubs namespace create --name $NS_NAME
    

    Nota

    La creazione dello spazio dei nomi potrebbe richiedere qualche minuto. Azure convaliderà il nome dello spazio dei nomi e, se il nome esiste o non è valido, l'interfaccia della riga di comando restituisce Richiesta non valida. In questo caso, provare un nome diverso eseguendo nuovamente il comando Bash per impostare la variabile di ambiente e quindi riemettere il comando dell'interfaccia della riga di comando di Azure.

  5. Recuperare la stringa di connessione e la chiave primaria per lo spazio dei nomi eseguendo il comando seguente.

    az eventhubs namespace authorization-rule keys list \
        --name RootManageSharedAccessKey \
        --namespace-name $NS_NAME
    

    L'output di questo comando è in formato JSON e contiene i dettagli necessari durante la configurazione dell'editore e delle applicazioni consumer. Salvare i valori seguenti per usarli in seguito.

    • primaryConnectionString
    • primaryKey

Creare un hub eventi

Si vedrà ora come creare l'hub eventi.

  1. Prima di tutto, definiamo il nome dell'hub eventi come variabile di ambiente eseguendo il comando seguente in Cloud Shell.

    HUB_NAME=hubname-$RANDOM
    
  2. Eseguire ora il comando dell'interfaccia della riga di comando di Azure per creare un hub eventi. Questo comando richiede i parametri seguenti.

    Parametro Descrizione
    --name (obbligatorio) Il nome dell'hub eventi è la variabile di ambiente $HUB_NAME.
    --resource-group (obbligatorio) Il proprietario del gruppo di risorse è già definito in una variabile di ambiente.
    --namespace-name (obbligatorio) Lo spazio dei nomi di Hub eventi è la variabile di ambiente $NS_NAME.
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME
    
  3. Visualizzare i dettagli dell'hub eventi eseguendo il comando dell'interfaccia della riga di comando di Azure seguente, che richiede i parametri seguenti.

    Parametro Descrizione
    --resource-group (obbligatorio) Il proprietario del gruppo di risorse è già definito in una variabile di ambiente.
    --namespace-name (obbligatorio) Lo spazio dei nomi creato.
    --name (obbligatorio) Nome dell'hub eventi.
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME
    

Visualizzare l'hub eventi nel portale di Azure

Si osserverà ora l'aspetto dell'hub eventi nel portale di Azure.

  1. Accedere al portale di Azure usando lo stesso account con cui è stata attivata la sandbox.

  2. Nella barra di ricerca nella parte superiore del portale immettere Hub eventi e premere INVIO. Viene visualizzato il riquadro Hub eventi per la sottoscrizione.

  3. Nell'elenco degli spazi dei nomi di Hub eventi cercare lo spazio dei nomi. Poiché è stato assegnato lo spazio dei nomi come variabile di ambiente ehubns-RANDOM, cercare ehubns-NNNNN. Selezionarlo. Verrà visualizzata la pagina Panoramica per lo spazio dei nomi di Hub eventi.

  4. Nel riquadro del menu al centro, in Entità selezionare Hub eventi. Il riquadro Hub eventi viene visualizzato con l'elenco di hub eventi nello spazio dei nomi.

    L'hub eventi è elencato, visualizzando lo stato (Attivo) e i valori predefiniti previsti per la conservazione dei messaggi (7 giorni (168 ore)) e il numero di partizioni (4).

    Event Hub displayed in the Azure portal.

Riepilogo

È stato creato un nuovo hub eventi e sono disponibili tutte le informazioni necessarie per configurare l'editore e le applicazioni consumer.