Oefening: De Azure CLI gebruiken om een Event Hub te maken

  • 10 minuten

U kunt nu een nieuwe Event Hub maken. Nadat u deze hebt gemaakt met Azure CLI-opdrachten, gebruikt u Azure Portal om uw nieuwe hub weer te geven. Activeer de sandbox voordat u verdergaat.

Een Event Hubs-naamruimte maken

Laten we een Event Hubs-naamruimte maken met behulp van Azure CLI en Bash in Azure Cloud Shell aan de rechterkant.

  1. Eerst gaan we standaardwaarden toewijzen die opnieuw kunnen worden gebruikt, zodat u deze waarden niet hoeft in te voeren met elke opdracht. Laten we met name de resourcegroep instellen op en de locatie op. Voer de volgende opdracht in Cloud Shell in en vervang de locatiewaarde door een regio dicht bij u in de buurt.

    az configure --defaults group="<rgn>[sandbox resource group name]</rgn>" location=westus2

    Met de gratis sandbox kunt u resources maken in een subset van de globale Azure-regio's. Selecteer een regio in deze lijst wanneer u resources maakt:

    • westus2
    • southcentralus
    • centralus
    • eastus
    • westeurope
    • southeastasia
    • japaneast
    • Zuid-Brazilië
    • australiasoutheast
    • centralindia

    Tip

    U kunt de knop Kopiëren gebruiken om opdrachten naar het klembord te kopiëren. Als u wilt plakken, klikt u met de rechtermuisknop op een nieuwe regel in de Cloud Shell-terminal en selecteert u Plakkenof gebruikt u de sneltoets Shift+Insert (⌘+V in macOS).

  2. Maak de Event Hubs-naamruimte door de volgende Azure CLI-opdracht uit te voeren. Hierbij worden de volgende parameters gebruikt:

    Parameter Beschrijving
    --name (vereist) Een unieke naam voor uw Event Hubs-naamruimte. De naam moet 6-50 tekens lang zijn, beginnen met een letter, eindigen met een letter of cijfer en mogen alleen letters, cijfers en afbreekstreepjes bevatten.
    --resourcegroep (vereist) Deze parameter kan worden weggelaten omdat deze standaard is ingesteld op de sandbox-resourcegroep die is opgegeven met de vorige opdracht.
    --location (optioneel) Deze parameter kan worden weggelaten omdat deze standaard is ingesteld op de locatie (regio) die is opgegeven met de vorige opdracht.
    --sku (optioneel) De standaardwaarde voor deze parameter, indien weggelaten, is Standard-. Dit is de gewenste waarde. De SKU bepaalt de connecties en drempelwaarden voor consumenten.

  3. Voordat u de opdracht uitvoert, stellen we de naamruimtenaam echter in als een omgevingsvariabele, zodat we deze opnieuw kunnen gebruiken.

    NS_NAME=ehubns-$RANDOM

  4. Wanneer u deze opdracht uitvoert, is de naamruimtenaam al voor u gedefinieerd en maakt de CLI-opdracht deze.

    az eventhubs namespace create --name $NS_NAME

    Notitie

    Het kan enige tijd duren voordat de naamruimte is gemaakt. Azure valideert de naamruimtenaam en als de naam bestaat of ongeldig is, retourneert de CLI Ongeldige aanvraag. In dit geval probeert u een andere naam door de Bash-opdracht opnieuw uit te voeren om de omgevingsvariabele in te stellen en vervolgens de Azure CLI-opdracht opnieuw uit te voeren.

  5. Haal de verbindingsreeks en primaire sleutel voor uw naamruimte op door de volgende opdracht uit te voeren.

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

    De uitvoer van deze opdracht heeft de JSON-indeling en bevat details die u nodig hebt bij het configureren van uw uitgevers- en consumententoepassingen. Sla de volgende waarden op voor later gebruik.

    • primaryConnectionString
    • primaire sleutel

Een Event Hub maken

Nu gaan we uw Event Hub maken.

  1. Eerst gaan we de naam van de Event Hub definiëren als een omgevingsvariabele door de volgende opdracht uit te voeren in Cloud Shell.

    HUB_NAME=hubname-$RANDOM

  2. Voer nu de Azure CLI-opdracht uit om een Event Hub te maken. Voor deze opdracht zijn de volgende parameters vereist.

    Parameter Beschrijving
    --name (vereist) De naam voor uw Event Hub is de omgevingsvariabele $HUB_NAME.
    --resourcegroep (vereist) De eigenaar van de resourcegroep is al gedefinieerd in een omgevingsvariabele.
    --namespace-name (vereist) De Event Hubs-naamruimte is de omgevingsvariabele $NS_NAME. 
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME

  3. Bekijk de details van uw Event Hub door de volgende Azure CLI-opdracht uit te voeren. Deze heeft de volgende parameters nodig.

    Parameter Beschrijving
    --resourcegroep (vereist) De eigenaar van de resourcegroep is al gedefinieerd in een omgevingsvariabele.
    --namespace-name (vereist) De naamruimte die u hebt gemaakt.
    --name (vereist) Naam van de Event Hub. 
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME

De Event Hub weergeven in Azure Portal

Laten we nu eens kijken hoe onze Event Hub eruitziet in Azure Portal.

  1. Meld u aan bij de Azure Portal met hetzelfde account dat u hebt gebruikt om de sandbox te activeren.

  2. Voer in de zoekbalk boven aan de portal Event Hubs-in en druk op Enter-. Het deelvenster Event Hubs voor uw abonnement wordt weergegeven.

  3. Zoek in de lijst met Event Hubs-naamruimten naar uw naamruimte. Omdat we de naamruimte als een omgevingsvariabele hebben toegewezen, namelijk ehubns-RANDOM, kunt u zoeken naar ehubns-NNNNN. Selecteer het. U ziet de pagina Overzicht voor uw Event Hubs-naamruimte.

  4. Selecteer in het middelste menuvenster onder EntiteitenEvent Hubs. Het deelvenster Event Hubs wordt weergegeven met een lijst met Event Hubs in uw naamruimte.

    Uw Event Hub wordt weergegeven, met de status (Actief) en de verwachte standaardwaarden voor berichtretentie (7 dagen (168 uur)) en aantal partities (4).

    Event Hub weergegeven in Azure Portal.

Samenvatting

U hebt een nieuwe Event Hub gemaakt en u beschikt over alle benodigde informatie om uw uitgevers- en consumententoepassingen te configureren.