Szybki start: przekieruj zdarzenia Azure Cache for Redis do internetowego punktu końcowego za pomocą Azure PortalQuickstart: Route Azure Cache for Redis events to web endpoint with the Azure portal

Azure Event Grid to usługa obsługi zdarzeń dla chmury.Azure Event Grid is an eventing service for the cloud. W tym przewodniku Szybki start użyjesz usługi Azure Portal, aby utworzyć wystąpienie usługi Azure Cache for Redis, zasubskrybować zdarzenia dla tego wystąpienia, wyzwolić zdarzenie i wyświetlić wyniki.In this quickstart, you'll use the Azure portal to create an Azure Cache for Redis instance, subscribe to events for that instance, trigger an event, and view the results. Zazwyczaj użytkownik wysyła zdarzenia do punktu końcowego, w którym następuje przetwarzanie danych zdarzenia i są wykonywane akcje.Typically, you send events to an endpoint that processes the event data and takes actions. Jednak aby uprościć ten przewodnik Szybki start, wyślesz zdarzenia do aplikacji internetowej, która będzie zbierać i wyświetlać komunikaty.However, to simplify this quickstart, you'll send events to a web app that will collect and display the messages.

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem Utwórz bezpłatne konto .If you don't have an Azure subscription, create a free account before you begin.

Po zakończeniu zobaczysz, że dane zdarzenia zostały wysłane do aplikacji internetowej.When you're finished, you'll see that the event data has been sent to the web app.

Azure Event Grid Podgląd w formacie JSON.

Tworzenie wystąpienia Azure Cache for Redis pamięci podręcznejCreate an Azure Cache for Redis cache instance

  1. Aby utworzyć pamięć podręczną, zaloguj się do Azure Portal i wybierz pozycję Utwórz zasób.To create a cache, sign in to the Azure portal and select Create a resource.

    W okienku nawigacji po lewej stronie zostanie wyróżniony zasób.

  2. Na stronie Nowy wybierz pozycję bazy danych , a następnie wybierz pozycję Azure cache for Redis.On the New page, select Databases and then select Azure Cache for Redis.

    W obszarze nowe są wyróżnione bazy danych, a usługa Azure cache for Redis jest wyróżniona.

  3. Na stronie nowy Redis Cache Skonfiguruj ustawienia dla nowej pamięci podręcznej.On the New Redis Cache page, configure the settings for your new cache.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    Nazwa DNSDNS name Podaj globalnie unikatową nazwę.Enter a globally unique name. Nazwa pamięci podręcznej musi być ciągiem z przedziału od 1 do 63 znaków, który zawiera tylko cyfry, litery lub łączniki.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać następujących po sobie łączników.The name must start and end with a number or letter, and can't contain consecutive hyphens. Nazwa hosta wystąpienia pamięci podręcznej to <DNS name> . Redis.cache.Windows.NET.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    SubskrypcjaSubscription Lista rozwijana i wybierz swoją subskrypcję.Drop down and select your subscription. Subskrypcja, w ramach której ma zostać utworzone nowe wystąpienie usługi Azure cache for Redis.The subscription under which to create this new Azure Cache for Redis instance.
    Grupa zasobówResource group Rozwiń i wybierz grupę zasobów lub wybierz pozycję Utwórz nową , a następnie wprowadź nową nazwę grupy zasobów.Drop down and select a resource group, or select Create new and enter a new resource group name. Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby.Name for the resource group in which to create your cache and other resources. Umieszczenie wszystkich zasobów aplikacji w jednej grupie zasobów pozwala łatwo zarządzać nimi i usuwać je razem.By putting all your app resources in one resource group, you can easily manage or delete them together.
    LokalizacjaLocation Lista rozwijana i wybierz lokalizację.Drop down and select a location. Wybierz region blisko innych usług, które będą korzystać z pamięci podręcznej.Select a region near other services that will use your cache.
    Warstwa cenowaPricing tier Lista rozwijana i wybierz warstwę cenową.Drop down and select a Pricing tier. Warstwa cenowa decyduje o rozmiarze, wydajności i funkcjach dostępnych dla pamięci podręcznej.The pricing tier determines the size, performance, and features that are available for the cache. Aby uzyskać więcej informacji, zobacz Omówienie pamięci podręcznej Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Wybierz kartę Sieć lub kliknij przycisk sieci w dolnej części strony.Select the Networking tab or click the Networking button at the bottom of the page.

  5. Na karcie Sieć wybierz metodę łączności.In the Networking tab, select your connectivity method.

  6. Wybierz kartę Dalej: Zaawansowane lub kliknij przycisk Dalej: Zaawansowane w dolnej części strony.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. Na karcie Zaawansowane dla podstawowego lub standardowego wystąpienia pamięci podręcznej wybierz opcję Włącz przełącznik, jeśli chcesz włączyć port inny niż TLS.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis w wersji 4 lub 6.

  8. Na karcie Zaawansowane wystąpienia pamięci podręcznej Premium Skonfiguruj ustawienia dla portu niezwiązanego z protokołem TLS, klastrowanie i trwałość danych.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Wybierz kartę następne: Tagi lub kliknij przycisk Dalej: Tagi w dolnej części strony.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Opcjonalnie na karcie Tagi wprowadź nazwę i wartość, jeśli chcesz przydzielić zasób.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Wybierz pozycję Przejrzyj i utwórz.Select Review + create. Nastąpi przekierowanie do karty Recenzja + tworzenie, w której platforma Azure weryfikuje konfigurację.You're taken to the Review + create tab where Azure validates your configuration.

  12. Po wyświetleniu komunikatu o pomyślnym sprawdzeniu poprawności, wybierz pozycję Utwórz.After the green Validation passed message appears, select Create.

Tworzenie pamięci podręcznej zajmuje trochę czasu.It takes a while for the cache to create. Postęp można monitorować na stronie Przegląd usługi Azure cache for Redis.You can monitor progress on the Azure Cache for Redis Overview page. Gdy stan jest wyświetlany jako uruchomiony, pamięć podręczna jest gotowa do użycia.When Status shows as Running, the cache is ready to use.

Tworzenie punktu końcowego komunikatówCreate a message endpoint

Przed subskrybowanie zdarzeń dla wystąpienia pamięci podręcznej utwórzmy punkt końcowy dla komunikatu zdarzenia.Before subscribing to the events for the cache instance, let's create the endpoint for the event message. Zazwyczaj w punkcie końcowym akcje są wykonywane na podstawie danych zdarzenia.Typically, the endpoint takes actions based on the event data. Aby uprościć ten przewodnik Szybki start, wdrożysz wstępnie sbudowaną aplikację internetową, która wyświetla komunikaty o zdarzeniach.To simplify this quickstart, you'll deploy a pre-built web app that displays the event messages. Wdrożone rozwiązanie zawiera plan usługi App Service, aplikację internetową usługi App Service i kod źródłowy z repozytorium GitHub.The deployed solution includes an App Service plan, an App Service web app, and source code from GitHub.

  1. Wybierz pozycję Deploy to Azure (Wd wdrażaj na platformie Azure) w witrynie GitHub README, aby wdrożyć rozwiązanie w subskrypcji.Select Deploy to Azure in GitHub README to deploy the solution to your subscription.

Przycisk Wd wdrażaj na platformie Azure.

  1. Na stronie Wdrożenie niestandardowe wykonaj następujące czynności:On the Custom deployment page, do the following steps:

    1. W przypadku grupy zasobów wybierz grupę zasobów utworzoną podczas tworzenia wystąpienia pamięci podręcznej.For Resource group, select the resource group that you created when creating the cache instance. Po zakończeniu pracy z samouczkiem łatwiej będzie wyczyścić grupę zasobów.It will be easier for you to clean up after you are done with the tutorial by deleting the resource group.
    2. W polach Nazwa witryny wprowadź nazwę aplikacji internetowej.For Site Name, enter a name for the web app.
    3. W przypadku nazwy planu hostingu wprowadź nazwę planu App Service do hostowania aplikacji internetowej.For Hosting plan name, enter a name for the App Service plan to use for hosting the web app.
    4. Zaznacz pole wyboru wyrażam zgodę na powyższe warunki i postanowienia.Select the check box for I agree to the terms and conditions stated above.
    5. Wybierz pozycję Kup.Select Purchase.
    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    SubskrypcjaSubscription Rozwijaj i wybierz swoją subskrypcję.Drop down and select your subscription. Subskrypcja, w ramach której ma być tworzyć ta aplikacja internetowa.The subscription under which to create this web app.
    Grupa zasobówResource group Rozwijaj i wybierz grupę zasobów lub wybierz pozycję Utwórz nową i wprowadź nazwę nowej grupy zasobów.Drop down and select a resource group, or select Create new and enter a new resource group name. Dzięki umieszczeniu wszystkich zasobów aplikacji w jednej grupie zasobów można łatwo nimi zarządzać lub usuwać je razem.By putting all your app resources in one resource group, you can easily manage or delete them together.
    Nazwa witrynySite Name Wprowadź nazwę aplikacji internetowej.Enter a name for your web app. Ta wartość nie może być pusta.This value cannot be empty.
    Nazwa planu hostinguHosting plan name Wprowadź nazwę planu App Service do hostowania aplikacji internetowej.Enter a name for the App Service plan to use for hosting the web app. Ta wartość nie może być pusta.This value cannot be empty.
  2. Wybierz pozycję Alerty (ikona dzwonka) w portalu, a następnie wybierz pozycję Przejdź do grupy zasobów.Select Alerts (bell icon) in the portal, and then select Go to resource group.

    Azure Portal powiadomienia o wdrożeniu.

  3. Na stronie Grupa zasobów na liście zasobów wybierz utworzoną aplikację internetową.On the Resource group page, in the list of resources, select the web app that you created. Na tej liście zobaczysz również App Service pamięci podręcznej.You'll also see the App Service plan and the cache instance in this list.

  4. Na App Service aplikacji internetowej wybierz adres URL, aby przejść do witryny internetowej.On the App Service page for your web app, select the URL to navigate to the web site. Adres URL powinien mieć ten format: https://<your-site-name>.azurewebsites.net .The URL should be in this format: https://<your-site-name>.azurewebsites.net.

  5. Upewnij się, że widzisz witrynę, ale żadne zdarzenia nie zostały jeszcze opublikowane w tej witrynie.Confirm that you see the site but no events have been posted to it yet.

    Pusta Event Grid podglądu.

Włączanie dostawcy zasobów usługi Event GridEnable Event Grid resource provider

Jeśli usługa Event Grid nie była wcześniej używana w subskrypcji platformy Azure, może być konieczne zarejestrowanie dostawcy zasobów usługi Event Grid.If you haven't previously used Event Grid in your Azure subscription, you may need to register the Event Grid resource provider.

W witrynie Azure Portal:In the Azure portal:

  1. W menu po lewej stronie wybierz pozycję subskrypcje .Select Subscriptions on the left menu.
  2. Wybierz subskrypcję, której używasz dla usługi Event Grid.Select the subscription you're using for Event Grid.
  3. W menu po lewej stronie w obszarze Ustawienia wybierz pozycję dostawcy zasobów.On the left menu, under Settings, select Resource providers.
  4. Znajdź dostawcę Microsoft.EventGrid.Find Microsoft.EventGrid.
  5. Jeśli nie jest on zarejestrowany, wybierz pozycję Zarejestruj.If not registered, select Register.

Ukończenie rejestracji może chwilę potrwać.It may take a moment for the registration to finish. Wybierz pozycję Odśwież, aby zaktualizować stan.Select Refresh to update the status. Gdy Stan będzie miał wartość Zarejestrowano, możesz kontynuować.When Status is Registered, you're ready to continue.

Subskrybowanie Azure Cache for Redis subskrypcjiSubscribe to the Azure Cache for Redis instance

W tym kroku zasubskrybujesz temat, aby poinformować Event Grid, które zdarzenia chcesz śledzić i gdzie mają być wysyłane zdarzenia.In this step, you'll subscribe to a topic to tell Event Grid which events you want to track, and where to send the events.

  1. W portalu przejdź do utworzonego wcześniej wystąpienia pamięci podręcznej.In the portal, navigate to your cache instance that you created earlier.

  2. Na stronie Azure Cache for Redis wybierz pozycję Zdarzenia w menu po lewej stronie.On the Azure Cache for Redis page, select Events on the left menu.

  3. Wybierz pozycję Web Hook.Select Web Hook. Zdarzenia są wysyłane do aplikacji przeglądarki przy użyciu punktu końcowego web hook.You are sending events to your viewer app using a web hook for the endpoint.

    Azure Portal strony Zdarzenia.

  4. Na stronie Tworzenie subskrypcji zdarzeń wprowadź następujące informacje:On the Create Event Subscription page, enter the following:

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    NazwaName Wprowadź nazwę subskrypcji zdarzeń.Enter a name for the event subscription. Wartość musi mieć od 3 do 64 znaków.The value must be between 3 and 64 characters long. Może zawierać tylko litery, cyfry i łączniki.It can only contain letters, numbers, and dashes.
    Typy zdarzeńEvent Types Rozwijaj i wybierz typy zdarzeń, które chcesz wypchnąć do miejsca docelowego.Drop down and select which event type(s) you want to get pushed to your destination. W tym przewodniku Szybki start będziemy skalować wystąpienie pamięci podręcznej.For this quickstart, we'll be scaling our cache instance. Dostępne opcje to stosowanie poprawek, skalowanie, importowanie i eksportowanie.Patching, scaling, import and export are the available options.
    Typ punktu końcowegoEndpoint Type Wybierz pozycję Web Hook.Select Web Hook. Program obsługi zdarzeń do odbierania zdarzeń.Event handler to receive your events.
    Punkt końcowyEndpoint Kliknij pozycję Wybierz punkt końcowy, wprowadź adres URL aplikacji internetowej i dodaj element do adresu URL strony głównej (na przykład : ), a następnie wybierz pozycję api/updates https://cache.azurewebsites.net/api/updates Potwierdź wybór.Click Select an endpoint, and enter the URL of your web app and add api/updates to the home page URL (for example: https://cache.azurewebsites.net/api/updates), and then select Confirm Selection. Jest to adres URL utworzonej wcześniej aplikacji internetowej.This is the URL of your web app that you created earlier.
  5. Teraz na stronie Tworzenie subskrypcji zdarzeń wybierz pozycję Utwórz, aby utworzyć subskrypcję zdarzeń.Now, on the Create Event Subscription page, select Create to create the event subscription.

  6. Wyświetl aplikację sieci Web ponownie i zwróć uwagę, że zdarzenie sprawdzania poprawności subskrypcji zostało do niej wysłane.View your web app again, and notice that a subscription validation event has been sent to it. Wybierz ikonę oka, aby rozwinąć dane zdarzenia.Select the eye icon to expand the event data. Usługa Event Grid wysyła zdarzenie weryfikacji, aby w punkcie końcowym mogło nastąpić sprawdzenie, czy dane zdarzenia mają być odbierane.Event Grid sends the validation event so the endpoint can verify that it wants to receive event data. Aplikacja internetowa zawiera kod do sprawdzania poprawności subskrypcji.The web app includes code to validate the subscription.

    Azure Event Grid Viewer.

Wysyłanie zdarzenia do punktu końcowegoSend an event to your endpoint

Teraz wyzwólmy zdarzenie, aby zobaczyć, jak usługa Event Grid dystrybuuje komunikat do punktu końcowego.Now, let's trigger an event to see how Event Grid distributes the message to your endpoint. Będziemy skalować Twoje Azure Cache for Redis wystąpienie.We'll be scaling your Azure Cache for Redis instance.

  1. W okienku Azure Portal przejdź do swojego Azure Cache for Redis i wybierz pozycję Skaluj w menu po lewej stronie.In the Azure portal, navigate to your Azure Cache for Redis instance and select Scale on the left menu.

  2. Wybierz odpowiednią warstwę cenową na stronie Skala i kliknij pozycję Wybierz.Select the desired pricing tier from the Scale page and click Select.

    Można skalować do innej warstwy cenowej z następującymi ograniczeniami:You can scale to a different pricing tier with the following restrictions:

    • Nie można skalować z wyższej warstwy cenowej do niższej warstwy cenowej.You can't scale from a higher pricing tier to a lower pricing tier.
      • Nie można skalować z pamięci podręcznej Premium w dół do standardowej lub podstawowej pamięci podręcznej.You can't scale from a Premium cache down to a Standard or a Basic cache.
      • Nie można skalować z standardowej pamięci podręcznej w dół do podstawowej pamięci podręcznej.You can't scale from a Standard cache down to a Basic cache.
    • Można skalować z podstawowej pamięci podręcznej do standardowej pamięci podręcznej, ale nie można zmienić rozmiaru w tym samym czasie.You can scale from a Basic cache to a Standard cache but you can't change the size at the same time. Jeśli potrzebujesz innego rozmiaru, możesz wykonać kolejną operację skalowania do żądanego rozmiaru.If you need a different size, you can do a subsequent scaling operation to the desired size.
    • Nie można skalować bezpośrednio z podstawowej pamięci podręcznej do pamięci podręcznej Premium.You can't scale from a Basic cache directly to a Premium cache. Najpierw przeskaluj z podstawowej do standardowej w jednej operacji skalowania, a następnie ze Standardowa do Premium w kolejnej operacji skalowania. First, scale from Basic to Standard in one scaling operation, and then from Standard to Premium in a subsequent scaling operation.
    • Nie można skalować od większego rozmiaru do rozmiaru C0 (250 MB).You can't scale from a larger size down to the C0 (250 MB) size.

    Gdy pamięć podręczna jest skalowana do nowej warstwy cenowej, w bloku Azure Cache for Redis jest wyświetlany stan skalowania.While the cache is scaling to the new pricing tier, a Scaling status is displayed in the Azure Cache for Redis blade. Po zakończeniu skalowania stan zmieni się z Skalowanie na Uruchomione.When scaling is complete, the status changes from Scaling to Running.

  3. Zdarzenie zostało wyzwolone, a usługa Event Grid wysłała komunikat do punktu końcowego skonfigurowanego podczas subskrybowania.You've triggered the event, and Event Grid sent the message to the endpoint you configured when subscribing. Komunikat jest w formacie JSON i zawiera tablicę z co najmniej jednym zdarzeniami.The message is in the JSON format and it contains an array with one or more events. W poniższym przykładzie komunikat JSON zawiera tablicę z jednym zdarzeniem.In the following example, the JSON message contains an array with one event. Wyświetl aplikację internetową i zwróć uwagę, że odebrano zdarzenie ScalingCompleted.View your web app and notice that a ScalingCompleted event was received.

    Azure Event Grid Viewer w formacie JSON.

Czyszczenie zasobówClean up resources

Jeśli planujesz kontynuować pracę z tym zdarzeniem, nie czyść zasobów utworzonych w tym przewodniku Szybki start.If you plan to continue working with this event, don't clean up the resources created in this quickstart. W przeciwnym razie usuń zasoby utworzone w tym przewodniku Szybki start.Otherwise, delete the resources you created in this quickstart.

Wybierz grupę zasobów, a następnie wybierz pozycję Usuń grupę zasobów.Select the resource group, and select Delete resource group.

Następne krokiNext steps

Wiesz już, jak tworzyć tematy niestandardowe i subskrypcje zdarzeń. Dowiedz się więcej na temat tego, co może Ci ułatwić usługa Event Grid:Now that you know how to create custom topics and event subscriptions, learn more about what Event Grid can help you do: