Ćwiczenie — tworzenie centrum zdarzeń za pomocą interfejsu wiersza polecenia platformy Azure

  • 10 min

Teraz możesz utworzyć nowe centrum zdarzeń. Po utworzeniu jej za pomocą poleceń interfejsu wiersza polecenia platformy Azure użyjesz witryny Azure Portal, aby wyświetlić nowe centrum.

Tworzenie przestrzeni nazw usługi Event Hubs

Utwórzmy przestrzeń nazw usługi Event Hubs przy użyciu interfejsu wiersza polecenia platformy Azure i powłoki Bash w usłudze Azure Cloud Shell po prawej stronie.

  1. W oknie usługi Azure Cloud Shell po prawej stronie wybierz pozycję Ustawienia na pasku menu, a następnie wybierz pozycję Przejdź do wersji klasycznej. Niektóre polecenia używane w tym module learn działają tylko w trybie klasycznym.

    Zrzut ekranu przedstawiający element menu umożliwiający przełączenie usługi Azure Cloud Shell do trybu klasycznego.

  2. Najpierw przypiszmy wartości domyślne, które można użyć ponownie, aby nie trzeba było wprowadzać tych wartości za pomocą każdego polecenia. Konkretnie określmy grupę zasobów i lokalizację. Wprowadź następujące polecenie w usłudze Cloud Shell i możesz zastąpić wartość lokalizacji regionem zbliżonym do Ciebie.

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

    Bezpłatna piaskownica umożliwia tworzenie zasobów w podzestawie regionów globalnych platformy Azure. Podczas tworzenia zasobów wybierz region z poniższej listy:

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

    Napiwek

    Do kopiowania poleceń do schowka możesz używać przycisku Kopiuj. Aby wkleić, kliknij prawym przyciskiem myszy nowy wiersz w terminalu usługi Cloud Shell i wybierz polecenie Wklej lub użyj skrótu klawiaturowego Shift+Insert (⌘+V w systemie macOS).

  3. Utwórz przestrzeń nazw usługi Event Hubs, uruchamiając następujące polecenie interfejsu wiersza polecenia platformy Azure, które przyjmuje następujące parametry:

    Parametr Opis
    --name (wymagany) Unikatowa nazwa przestrzeni nazw usługi Event Hubs. Nazwa musi mieć długość od 6 do 50 znaków, zaczynać się literą, kończyć literą lub cyfrą i zawierać tylko litery, cyfry i łączniki.
    --resource-group (wymagany) Ten parametr można pominąć, ponieważ domyślnie jest to grupa zasobów piaskownicy dostarczona z poprzedniego polecenia.
    --location (opcjonalnie) Ten parametr można pominąć, ponieważ domyślnie jest to lokalizacja (region) dostarczona z poprzedniego polecenia.
    --sku (opcjonalny) Wartość domyślna tego parametru, jeśli zostanie pominięta, to Standardowa, czyli wartość, której potrzebujemy. Jednostka SKU określa połączenia i progi konsumentów.

  4. Przed uruchomieniem polecenia ustawmy jednak nazwę przestrzeni nazw jako zmienną środowiskową, aby umożliwić jej ponowne użycie.

    NS_NAME=ehubns-$RANDOM

  5. Teraz po uruchomieniu tego polecenia nazwa przestrzeni nazw jest już zdefiniowana, a polecenie interfejsu wiersza polecenia je tworzy.

    az eventhubs namespace create --name $NS_NAME

    Uwaga

    Utworzenie przestrzeni nazw może zająć trochę czasu. Platforma Azure zweryfikuje nazwę przestrzeni nazw, a jeśli nazwa istnieje lub jest nieprawidłowa, interfejs wiersza polecenia zwraca nieprawidłowe żądanie. W takim przypadku spróbuj użyć innej nazwy, uruchamiając ponownie polecenie powłoki Bash, aby ustawić zmienną środowiskową, a następnie ponownie uruchom polecenie interfejsu wiersza polecenia platformy Azure.

  6. Pobierz parametry połączenia i klucz podstawowy dla przestrzeni nazw, uruchamiając następujące polecenie.

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

    Dane wyjściowe tego polecenia są w formacie JSON i zawierają szczegółowe informacje potrzebne podczas konfigurowania aplikacji wydawcy i konsumentów. Zapisz następujące wartości do późniejszego użycia.

    • primaryConnectionString
    • primaryKey

Tworzenie centrum zdarzeń

Teraz utwórzmy centrum zdarzeń.

  1. Najpierw zdefiniujmy nazwę centrum zdarzeń jako zmienną środowiskową, uruchamiając następujące polecenie w usłudze Cloud Shell.

    HUB_NAME=hubname-$RANDOM

  2. Teraz uruchom polecenie interfejsu wiersza polecenia platformy Azure, aby utworzyć centrum zdarzeń. To polecenie wymaga następujących parametrów.

    Parametr Opis
    --name (wymagany) Nazwa centrum zdarzeń to zmienna środowiskowa $HUB_NAME.
    --resource-group (wymagany) Właściciel grupy zasobów jest już zdefiniowany w zmiennej środowiskowej.
    --namespace-name (wymagany) Przestrzeń nazw usługi Event Hubs to zmienna środowiskowa $NS_NAME. 
    az eventhubs eventhub create --name $HUB_NAME --namespace-name $NS_NAME

  3. Wyświetl szczegóły centrum zdarzeń, uruchamiając następujące polecenie interfejsu wiersza polecenia platformy Azure, które wymaga następujących parametrów.

    Parametr Opis
    --resource-group (wymagany) Właściciel grupy zasobów jest już zdefiniowany w zmiennej środowiskowej.
    --namespace-name (wymagany) Utworzona przestrzeń nazw.
    --name (wymagany) Nazwa centrum zdarzeń. 
    az eventhubs eventhub show --namespace-name $NS_NAME --name $HUB_NAME

Wyświetlanie centrum zdarzeń w witrynie Azure Portal

Następnie zobaczmy, jak wygląda nasze centrum zdarzeń w witrynie Azure Portal.

  1. Zaloguj się do witryny Azure Portal przy użyciu tego samego konta, które zostało użyte do aktywowania piaskownicy.

  2. Na pasku wyszukiwania w górnej części portalu wprowadź ciąg Event Hubs i naciśnij Enter. Zostanie wyświetlone okienko usługi Event Hubs dla subskrypcji.

  3. Na liście przestrzeni nazw usługi Event Hubs poszukaj przestrzeni nazw. Ponieważ przypisano przestrzeń nazw jako zmienną środowiskową ehubns-RANDOM, poszukaj nazwy ehubns-NNNNN. Wybierz je. Zostanie wyświetlona strona Przegląd przestrzeni nazw usługi Event Hubs.

  4. W środkowym okienku menu w obszarze Jednostki wybierz pozycję Event Hubs. Okienko usługi Event Hubs zostanie wyświetlone z listą centrów zdarzeń w przestrzeni nazw.

    Twoje centrum zdarzeń jest wyświetlane, pokazując stan (Aktywne) i oczekiwane wartości domyślne przechowywania komunikatów (7 dni (168 godzin) i liczba partycji (4).

    Centrum zdarzeń wyświetlane w witrynie Azure Portal.

Podsumowanie

Utworzono nowe centrum zdarzeń i masz wszystkie niezbędne informacje gotowe do skonfigurowania aplikacji wydawcy i konsumentów.