Übung: Verwenden der Azure CLI zum Erstellen eines Event Hubs

  • 10 Minuten

Sie können nun einen neuen Event Hub erstellen. Nachdem Sie den Hub mit Azure CLI-Befehlen erstellt haben, verwenden Sie das Azure-Portal, um Ihren neuen Hub anzuzeigen.

Erstellen eines Event Hubs-Namespace

Nun erstellen wir einen Event Hubs-Namespace mithilfe der Azure CLI und Bash in Azure Cloud Shell auf der rechten Seite.

  1. Wählen Sie im Fenster Azure Cloud Shell rechts auf der Menüleiste Einstellungen und dann Zur klassischen Version wechseln aus. Einige der Befehle, die in diesem Lernmodul verwendet werden, funktionieren nur im klassischen Modus.

    Screenshot des Menüelements zum Wechseln von Azure Cloud Shell in den klassischen Modus.

  2. Wir weisen zunächst Standardwerte zu, die wiederverwendet werden können, damit Sie diese Werte nicht mit jedem Befehl eingeben müssen. Es geht hierbei vor allem um die Ressourcengruppe und den Standort. Geben Sie den folgenden Befehl in Cloud Shell ein, und ersetzen Sie den Standortwert durch eine Region in Ihrer Nähe.

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

    Mit der kostenlosen Sandbox können Sie Ressourcen in einem Teil der globalen Azure-Regionen erstellen. Wählen Sie eine Region aus dieser Liste aus, wenn Sie Ressourcen erstellen:

    • westus2
    • southcentralus
    • centralus
    • eastus
    • westeurope
    • southeastasia
    • japaneast
    • brazilsouth
    • australiasoutheast
    • centralindia

    Tipp

    Mit der Schaltfläche Kopieren können Sie Befehle in die Zwischenablage kopieren. Klicken Sie zum Einfügen im Cloud Shell-Terminal mit der rechten Maustaste auf eine neue Zeile, und wählen Sie dann Einfügen aus, oder verwenden Sie die Tastenkombination UMSCHALT+EINFG (⌘+V unter macOS).

  3. Erstellen Sie den Event Hubs-Namespace, indem Sie den folgenden Azure CLI-Befehl ausführen, der die folgenden Parameter verwendet:

    Parameter Beschreibung
    --name (erforderlich) Ein eindeutiger Name für Ihren Event Hubs-Namespace. Der Name muss zwischen 6 und 50 Zeichen lang sein, mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Zahl enden. Er darf nur Buchstaben, Zahlen und Bindestriche enthalten.
    --resource-group (erforderlich) Dieser Parameter kann ausgelassen werden, da er standardmäßig die Sandboxressourcengruppe verwendet, die vom vorherigen Befehl bereitgestellt wurde.
    --location (optional) Dieser Parameter kann ausgelassen werden, da er standardmäßig den Standort (Region) verwendet, der vom vorherigen Befehl angegeben wurde.
    --sku (optional) Wenn dieser Parameter nicht angegeben wird, lautet der Standardwert Standard, und das ist der gewünschte Wert. Die SKU bestimmt die Verbindungen und Consumerschwellenwerte.

  4. Legen Sie den Namespacenamen vor dem Ausführen des Befehls als Umgebungsvariable fest, damit Sie ihn wiederverwenden können.

    NS_NAME=ehubns-$RANDOM

  5. Wenn Sie diesen Befehl nun ausführen, ist der Namespacename bereits für Sie definiert, und der CLI-Befehl erstellt ihn.

    az eventhubs namespace create --name $NS_NAME

    Hinweis

    Es kann einige Zeit dauern, bis der Namespace erstellt wurde. Azure überprüft den Namespacenamen, und wenn der Name vorhanden oder ungültig ist, gibt die CLI Ungültige Anforderung zurück. Versuchen Sie es in diesem Fall mit einem anderen Namen, indem Sie den Bash-Befehl erneut ausführen, um die Umgebungsvariable festzulegen, und dann den Azure CLI-Befehl erneut ausführen.

  6. Rufen Sie die Verbindungszeichenfolge und den Primärschlüssel für Ihren Namespace ab, indem Sie den folgenden Befehl ausführen.

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

    Die Ausgabe dieses Befehls erfolgt im JSON-Format und enthält Details, die Sie benötigen, um Ihre Herausgeber- und Consumeranwendungen zu konfigurieren. Speichern Sie die folgenden Werte zur späteren Verwendung.

    • primaryConnectionString
    • primaryKey

Erstellen eines Ereignis-Hubs

Erstellen Sie nun Ihren Event Hub.

  1. Definieren Sie zunächst den Event Hub-Namen als eine Umgebungsvariable, indem Sie folgenden Befehl in Cloud Shell ausführen.

    HUB_NAME=hubname-$RANDOM

  2. Führen Sie nun den Azure CLI-Befehl aus, um einen Event Hub zu erstellen. Dieser Befehl benötigt die folgenden Parameter.

    Parameter Beschreibung
    --name (erforderlich) Der Name für Ihren Event Hub ist in der Umgebungsvariablen „$HUB_NAME“ enthalten.
    --resource-group (erforderlich) Der Ressourcengruppenbesitzer ist bereits in einer Umgebungsvariablen festgelegt.
    --namespace-name (erforderlich) Der Event Hubs-Namespace ist in der Umgebungsvariablen „$NS_NAME“ definiert. 
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME

  3. Zeigen Sie die Details Ihres Event Hub an, indem Sie den folgenden Azure CLI-Befehl ausführen, der die folgenden Parameter benötigt.

    Parameter Beschreibung
    --resource-group (erforderlich) Der Ressourcengruppenbesitzer ist bereits in einer Umgebungsvariablen festgelegt.
    --namespace-name (erforderlich) Der Namespace, den Sie erstellt haben
    --name (erforderlich) Name des Event Hubs. 
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME

Anzeigen des Event Hubs im Azure-Portal

Sehen Sie sich als Nächstes an, wie Ihr Event Hub im Azure-Portal aussieht.

  1. Melden Sie sich beim Azure-Portal mit dem Konto an, das Sie zum Aktivieren der Sandbox verwendet haben.

  2. Geben Sie oben im Portal in der Suchleiste Event Hubs ein, und drücken Sie die EINGABETASTE. Der Bereich Event Hubs wird für Ihr Abonnement wird angezeigt.

  3. Suchen Sie in der Liste der Event Hubs-Namespaces nach Ihrem Namespace. Da wir den Namespace als eine Umgebungsvariable „ehubns-RANDOM“ zugewiesen haben, suchen Sie nach „ehubns-NNNNN“. Wählen Sie ihn aus. Die Seite Übersicht für Ihren Event Hubs-Namespace wird angezeigt.

  4. Wählen Sie im mittleren Menübereich unter Entitäten die Option Event Hubs aus. Der Bereich Event Hubs wird mit einer Liste von Event Hubs in Ihrem Namespace angezeigt.

    Ihr Event Hub wird mit dem Status (Aktiv) und den erwarteten Standardwerten für die Nachrichtenaufbewahrung (7 Tage (168 Stunden)) und die Partitionsanzahl (4) angezeigt.

    Event Hub, der im Azure-Portal angezeigt wird

Zusammenfassung

Sie haben einen neuen Event Hub erstellt und verfügen nun über alle erforderlichen Informationen zum Konfigurieren Ihrer Herausgeber- und Consumeranwendungen.