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

È ora possibile creare un nuovo hub eventi. Dopo aver creato l'hub eventi, si userà il portale di Azure per visualizzare il nuovo hub.

Creare uno spazio dei nomi di Hub eventi

Si vedrà ora come creare uno spazio dei nomi di Hub eventi usando la shell Bash supportata da Azure Cloud Shell.

  1. Impostare prima di tutto i valori predefiniti per l'interfaccia della riga di comando di Azure in Cloud Shell. Così facendo si eviterà di doverli digitare tutte le volte. In particolare, verranno impostati il gruppo di risorse e la località. Digitare il comando seguente nell'interfaccia della riga di comando di Azure, sostituendo se preferibile la località con una nelle vicinanze.

    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
    • southcentralus
    • centralus
    • eastus
    • westeurope
    • southeastasia
    • japaneast
    • brazilsouth
    • australiasoutheast
    • centralindia
    az configure --defaults group=<rgn>[sandbox Resource Group]</rgn> location=westus2
    
  2. Creare lo spazio dei nomi di Hub eventi con il comando az eventhubs namespace create. Usare i parametri seguenti.

    Parametro Descrizione
    --name (obbligatorio) Immettere un nome univoco con una lunghezza compresa tra 6 e 50 caratteri per lo spazio dei nomi di Hub eventi. Il nome deve contenere solo lettere, numeri e trattini. Deve iniziare con una lettera e terminare con una lettera o un numero.
    --resource-group (obbligatorio) Si tratta del gruppo di risorse sandbox di Azure creato in precedenza, tratto dai valori predefiniti.
    --l (facoltativo) Immettere la posizione del data center di Azure più vicino. Verrà usata l'impostazione predefinita.
    --sku (facoltativo) Il piano tariffario per lo spazio dei nomi [Basic/Standard]. Il valore predefinito è Standard. Determina le connessioni e le soglie dei consumer.

    Impostare il nome in una variabile di ambiente in modo da poterlo riutilizzare.

    NS_NAME=ehubns-$RANDOM
    

    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 nella finestra di Cloud Shell e scegliere Incolla oppure usare la scelta rapida da tastiera MAIUSC+INS (⌘+V in macOS).

    az eventhubs namespace create --name $NS_NAME
    

    Nota

    Azure convaliderà il nome immesso e l'interfaccia della riga di comando restituisce Richiesta non valida se il nome esiste già o non è valido. Provare a usare un altro nome modificando la variabile di ambiente e rieseguendo il comando.

  3. Recuperare la stringa di connessione per lo spazio dei nomi di Hub eventi usando il comando seguente. Sarà necessaria per configurare le applicazioni per inviare e ricevere messaggi tramite l'hub eventi.

    az eventhubs namespace authorization-rule keys list \
        --name RootManageSharedAccessKey \
        --namespace-name $NS_NAME
    
    Parametro Descrizione
    --resource-group (obbligatorio) Si tratta del gruppo di risorse sandbox di Azure creato in precedenza, tratto dai valori predefiniti.
    --namespace-name (obbligatorio) Immettere il nome dello spazio dei nomi creato.

    Questo comando restituisce un blocco JSON con la stringa di connessione per lo spazio dei nomi di Hub eventi che si userà in un secondo momento per configurare le applicazioni di pubblicazione e consumer. Salvare il valore delle chiavi seguenti per un uso successivo.

    • primaryConnectionString
    • primaryKey

Creare un hub eventi

Si vedrà ora come creare il nuovo hub eventi.

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

  2. Creare un nuovo hub eventi con il comando eventhub create. Sono necessari i parametri seguenti:

    Parametro Descrizione
    --name (obbligatorio) Immettere un nome per l'hub eventi.
    --resource-group (obbligatorio) Proprietario del gruppo di risorse.
    --namespace-name (obbligatorio) Immettere lo spazio dei nomi creato.

    Per prima cosa definire il nome dell'hub eventi in una variabile di ambiente.

    HUB_NAME=hubname-$RANDOM
    
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME
    
  3. Visualizzare i dettagli dell'hub eventi con il comando eventhub show. È necessario quanto segue:

    Parametro Descrizione
    --resource-group (obbligatorio) Proprietario del gruppo di risorse.
    --namespace-name (obbligatorio) Immettere 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 il risultato nel portale di Azure.

  1. Trovare lo spazio dei nomi di Hub eventi usando la barra di ricerca nella parte superiore del portale.

  2. Selezionare lo spazio dei nomi per aprirlo.

  3. Selezionare Spazio dei nomi di Hub eventi nella sezione ENTITÀ.

  4. Fare clic su Hub eventi.

    L'hub eventi viene visualizzato con stato Attivo e i valori predefiniti per Conservazione messaggi (7) e Conteggio partizioni (4).

    Hub eventi visualizzato nel portale di Azure

Riepilogo

È stato creato un nuovo hub eventi e sono ora disponibili tutte le informazioni necessarie per configurare le applicazioni di pubblicazione e consumer.