Doručování událostí do služby Azure Event Hubs pomocí témat oboru názvů – Azure Portal

Tento článek obsahuje podrobné pokyny k publikování událostí do Azure Event Gridu ve formátu JSON CloudEvents a jejich doručování pomocí modelu doručení nabízených oznámení.

Pokud chcete být konkrétní, pomocí webu Azure Portal a Curl publikujete události do tématu oboru názvů ve službě Event Grid a odešlete tyto události z odběru událostí do cíle obslužné rutiny služby Event Hubs. Další informace o modelu doručení nabízených oznámení najdete v tématu Přehled doručení nabízených oznámení.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.

Vytvoření oboru názvů Event Gridu

Obor názvů Event Gridu poskytuje uživatelem definovaný koncový bod, do kterého publikujete události. Následující příklad vytvoří ve vaší skupině prostředků obor názvů pomocí bashe ve službě Azure Cloud Shell. Název oboru názvů musí být jedinečný, protože je součástí položky DNS (Domain Name System).

1. Přejděte na Azure Portal.

2. Na panelu hledání v tématu zadejte Event Grid Namespacesa vyberte Event Grid Namespaces z výsledků.

   

3. Na stránce Obory názvů event Gridu vyberte na panelu příkazů + Vytvořit.

4. Na stránce Vytvořit obor názvů postupujte takto:

   1. Vyberte předplatné Azure, ve kterém chcete vytvořit obor názvů.
   2. Novou skupinu prostředků vytvoříte tak, že vyberete Vytvořit novou nebo vyberete existující skupinu prostředků.
   3. Zadejte název oboru názvů.
   4. Vyberte umístění, kam chcete vytvořit skupinu prostředků.
   5. Pak vyberte Zkontrolovat a vytvořit.
      
   6. Na stránce Zkontrolovat a vytvořit vyberte Vytvořit.

5. Na stránce Nasazení vyberte Přejít k prostředku po úspěšném nasazení.

Získání přístupového klíče

1. Na stránce Obor názvů služby Event Grid vyberte v nabídce vlevo přístupové klávesy.
2. Vyberte tlačítko kopírovat vedle přístupového klíče.
3. Uložte přístupový klíč někam. Použijete ho později v tomto rychlém startu.

Povolení spravované identity pro obor názvů Event Gridu

Povolte spravovanou identitu přiřazenou systémem v oboru názvů Event Gridu. Pokud chcete doručovat události do center událostí v oboru názvů služby Event Hubs pomocí spravované identity, postupujte takto:

1. Povolte spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem: obory názvů. Pokračujte ve čtení k další části a zjistěte, jak povolit spravovanou identitu pomocí Azure CLI.
2. Přidejte identitu do role Odesílatele dat služby Azure Event Hubs v oboru názvů služby Event Hubs. Pokračujte v čtení do další části a zjistěte, jak přidat přiřazení role.
3. Nakonfigurujte odběr událostí, který používá centrum událostí jako koncový bod, aby používal spravovanou identitu přiřazenou systémem nebo přiřazenou uživatelem.

V této části povolíte spravovanou identitu přiřazenou systémem v oboru názvů. Další kroky provedete později v tomto rychlém startu.

1. Na stránce Obor názvů služby Event Grid vyberte v nabídce vlevo možnost Identita.

2. Na stránce Identita vyberte Možnost Zapnuto pro stav.

3. Na panelu příkazů vyberte Uložit.

   

Vytvoření tématu v oboru názvů

Vytvořte téma, které slouží k uložení všech událostí publikovaných do koncového bodu oboru názvů.

1. V nabídce vlevo vyberte Témata .
2. Na stránce Témata vyberte na panelu příkazů + Téma.
3. Na stránce Vytvořit téma postupujte takto:
   1. Zadejte název tématu.
   2. Vyberte Vytvořit.
      

Vytvoření oboru názvů služby Event Hubs

Vytvořte prostředek služby Event Hubs, který se používá jako cíl obslužné rutiny pro odběr nabízeného doručení tématu oboru názvů. Tyto kroky proveďte na samostatné kartě internetového prohlížeče nebo v samostatném okně. Přejděte na web Azure Portal a přihlaste se pomocí stejných přihlašovacích údajů, které jste použili před a stejným předplatným Azure.

1. Na panelu hledání zadejte Event Hubs a vyberte Event Hubs.
2. Na stránce Event Hubs vyberte na panelu příkazů + Vytvořit.
3. Na stránce Vytvořit obor názvů postupujte takto:
   1. Vyberte předplatné Azure, které jste použili k vytvoření oboru názvů Event Gridu.
   2. Vyberte skupinu prostředků, kterou jste použili dříve.
   3. Zadejte název oboru názvů služby Event Hubs.
   4. Vyberte stejné umístění , které jste použili pro obor názvů Služby Event Grid.
   5. Vyberte Basic pro cenovou úroveň.
   6. Vyberte Zkontrolovat a vytvořit.
   7. Na stránce Revize vyberte Vytvořit.
4. Na stránce Nasazení vyberte Po úspěšném nasazení přejít k prostředku.

Přidání spravované identity Event Gridu do role Odesílatele dat služby Event Hubs

1. Na stránce Oboru názvů služby Event Hubs vyberte v nabídce vlevo řízení přístupu (IAM).
2. Na panelu příkazů vyberte Přidat přiřazení role –> Přidat.
3. Na stránce Přidat přiřazení role vyhledejte odesílatele dat služby Event Hubs a ze seznamu rolí vyberte Odesílatele dat služby Azure Event Hubs a pak vyberte Další.
4. Na kartě Členové vyberte spravovanou identitu pro typ a pak vyberte + Vybrat členy.
5. Na stránce Vybrat spravované identity vyberte pro spravovanou identitu obor názvů služby Event Grid a pak vyberte spravovanou identitu, která má stejný název jako obor názvů služby Event Grid.
6. Na stránce Vybrat spravované identity zvolte Vybrat.
7. Teď na stránce Přidat přiřazení role vyberte Zkontrolovat a přiřadit.
8. Na stránce Revize a přiřazení vyberte Zkontrolovat a přiřadit.

Vytvoření centra událostí

1. Na stránce Obor názvů služby Event Hubs vyberte v nabídce vlevo službu Event Hubs.
2. Na stránce Event Hubs na panelu příkazů vyberte + Centrum událostí.
3. Na stránce Vytvořit centrum událostí zadejte název centra událostí a pak vyberte Zkontrolovat a vytvořit.
4. Na stránce Zkontrolovat a vytvořit vyberte Vytvořit.

Vytvoření odběru událostí

Vytvořte odběr událostí, který nastavuje režim doručení na Push, který podporuje doručování nabízených oznámení.

1. Přepněte na kartu nebo okno se stránkou oboru názvů Event Gridu otevřenou na kartě nebo v okně se stránkou Oboru názvů služby Event Hubs.
2. Na stránce Obor názvů event Gridu vyberte Témata v nabídce vlevo.
3. Na stránce Témata vyberte téma, které jste vytvořili v předchozím kroku.
4. Na panelu příkazů vyberte + Předplatné .
5. Na stránce Vytvořit odběr události postupujte takto:
   1. Na kartě Základní zadejte název odběru události.
   2. Pro režim doručování událostí vyberte Nabízené oznámení.
   3. Ověřte, že centrum událostí vybrané pro typ koncového bodu.
   4. Vyberte Konfigurovat koncový bod.
   5. Na stránce Vybrat centrum událostí postupujte takto:
      1. Vyberte předplatné Azure a skupinu prostředků, která má centrum událostí.
      2. Vyberte obor názvů služby Event Hubs a centrum událostí.
      3. Pak vyberte Potvrdit výběr.
   6. Zpět na stránce Vytvořit předplatné vyberte Typ spravované identity přiřazený systémem.
   7. Vyberte Vytvořit.

Odeslání událostí do tématu

Teď odešlete ukázkovou událost do tématu oboru názvů pomocí kroků v této části.

1. Spusťte Cloud Shell na webu Azure Portal. Přepněte na Bash.

   

2. Spuštěním následujícího příkazu v Cloud Shellu deklarujte proměnnou, která bude obsahovat přístupový klíč pro obor názvů. Přístupový klíč jste si poznamenali dříve v tomto rychlém startu.

   key=ACCESSKEY
   

3. Deklarujte proměnnou pro uložení identifikátoru URI operace publikování. Nahraďte NAMESPACENAME názvem oboru názvů služby Event Grid a TOPICNAME názvem tématu.

   publish_operation_uri=https://NAMESPACENAME.eastus-1.eventgrid.azure.net/topics/TOPICNAME:publish?api-version=2023-06-01-preview
   

4. Vytvořte ukázkovou událost kompatibilní s CloudEvents :

   event=' { "specversion": "1.0", "id": "'"$RANDOM"'", "type": "com.yourcompany.order.ordercreatedV2", "source" : "/mycontext", "subject": "orders/O-234595", "time": "'`date +%Y-%m-%dT%H:%M:%SZ`'", "datacontenttype" : "application/json", "data":{ "orderId": "O-234595", "url": "https://yourcompany.com/orders/o-234595"}} '
   

   Element data je datová část události. V tomto poli může být libovolný JSON ve správném formátu. Další informace ovlastnostech

5. Pomocí nástroje CURL odešlete událost do tématu. CURL je nástroj, který odesílá požadavky HTTP.

   curl -X POST -H "Content-Type: application/cloudevents+json" -H "Authorization:SharedAccessKey $key" -d "$event" $publish_operation_uri
   

   Na webu Azure Portal přejděte na stránku Oboru názvů služby Event Hubs, aktualizujte stránku a ověřte, že čítač příchozích zpráv v grafu indikuje, že byla přijata událost.

   

Další kroky

V tomto článku jste vytvořili a nakonfigurovali obor názvů Event Gridu a prostředky služby Event Hubs. Podrobné pokyny pro příjem událostí z centra událostí najdete v těchto kurzech:

• .NET Core
• Java
• Python
• JavaScript
• Přejít
• C (pouze odesílání)
• Apache Storm (pouze příjem)