Azure portalı ve Azure Event Grid ile özel olayları web uç noktasına yönlendirme

  • Makale

Event Grid, birçok farklı Azure hizmeti ve uygulamasındaki olayları kolayca yönetmenizi sağlayan tam olarak yönetilen bir hizmettir. Olay odaklı ve sunucusuz uygulamalar derlemeyi kolaylaştırır. Hizmete genel bakış için bkz . Event Grid'e genel bakış.

Bu makalede, aşağıdaki görevleri gerçekleştirmek için Azure portalını kullanırsınız:

  1. Özel bir konu oluşturun.
  2. Özel konuya abone olun.
  3. Olayı tetikleme.
  4. Sonucu görüntüleyin. Normalde olayları, olay verilerini işleyen ve eylemler gerçekleştiren bir uç noktaya gönderirsiniz. Bununla birlikte, bu makaleyi basitleştirmek için olayları iletilerin toplandığı ve görüntülendiği bir web uygulamasına gönderirsiniz.

Önkoşullar

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Event Grid kaynak sağlayıcısını kaydetme

Event Grid'i daha önce kullanmadıysanız Event Grid kaynak sağlayıcısını kaydetmeniz gerekir. Event Grid'i daha önce kullandıysanız sonraki bölüme geçin.

Azure portalında aşağıdaki adımları uygulayın:

  1. Soldaki menüde Abonelikler'i seçin.

  2. Abonelik listesinden Event Grid için kullanmak istediğiniz aboneliği seçin.

  3. Abonelik sayfasında, soldaki menüden Ayarlar altında Kaynak sağlayıcıları'nı seçin.

  4. Microsoft.EventGrid'i arayın ve Durum'un Kayıtlı Olmadığını onaylayın.

  5. Sağlayıcı listesinden Microsoft.EventGrid'i seçin.

  6. Komut çubuğunda Kaydet'i seçin.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Microsoft.EventGrid'in durumunun Kayıtlı olarak değiştirildiğinden emin olmak için yenileyin.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Özel konu oluşturma

Event Grid konusu, olaylarınızı gönderdiğiniz kullanıcı tanımlı bir uç nokta sağlar.

  1. Azure portalda oturum açın.

  2. Konu başlığındaki arama çubuğuna Event Grid Konuları yazın ve açılan listeden Event Grid Konuları'nı seçin.

    Screenshot showing the Azure port search bar to search for Event Grid topics.

  3. Event Grid Konuları sayfasında araç çubuğunda + Oluştur'u seçin.

    Screenshot showing the Create Topic button on Event Grid topics page.

  4. Konu Oluştur sayfasında şu adımları izleyin:

    1. Azure aboneliğinizi seçin.

    2. Mevcut bir kaynak grubunu seçin veya Yeni oluştur'u seçin ve kaynak grubu için bir ad girin.

    3. Özel konu için benzersiz bir ad sağlayın. Konu adı bir DNS girdisi ile temsil edildiğinden konu adı benzersiz olmalıdır. Görüntüde gösterilen adı kullanmayın. Bunun yerine kendi adınızı oluşturun; 3-50 karakter arasında olmalı ve yalnızca a-z, A-Z, 0-9 ve "-" değerlerini içermelidir.

    4. Event Grid konusu için bir konum seçin.

    5. Sayfanın alt kısmındaki Gözden geçir ve oluştur'u seçin.

      Create Topic page

    6. Konu başlığı oluştur sayfasının Gözden geçir + oluştur sekmesinde Oluştur'u seçin.

      Review settings and create

  5. Dağıtım başarılı olduktan sonra Kaynağa git'i seçerek konunuzun Event Grid Konu sayfasına gidin. Bu sayfayı açık tutun. Bunu daha sonra hızlı başlangıçta kullanacaksınız.

    Screenshot showing the Event Grid topic home page.

    Not

    Hızlı başlangıcı basit tutmak için yalnızca Temel Bilgiler sayfasını kullanarak bir konu oluşturacaksınız. Sihirbazın diğer sayfalarında ağ, güvenlik ve veri yerleşimi ayarlarını yapılandırma hakkında ayrıntılı adımlar için bkz . Özel konu oluşturma.

İleti uç noktası oluşturma

Özel konu için bir abonelik oluşturmadan önce olay iletisi için bir uç nokta oluşturun. Normalde, olay verileri temelinde uç nokta eylemleri gerçekleştirir. Bu hızlı başlangıcı basitleştirmek için, olay iletilerini görüntüleyen önceden oluşturulmuş bir web uygulaması dağıtacaksınız. Dağıtılan çözüm bir App Service planı, App Service web uygulaması ve GitHub'dan kaynak kod içerir.

  1. Çözümü aboneliğinize dağıtmak için makale sayfasında Azure'a dağıt'ı seçin. Azure portalında parametre değerlerini girin.

    Button to deploy the Resource Manager template to Azure.

  2. Özel dağıtım sayfasında aşağıdaki adımları uygulayın:

    1. Kaynak grubu için depolama hesabını oluştururken oluşturduğunuz kaynak grubunu seçin. Öğreticiyi tamamladıktan sonra kaynak grubunu silerek temizlemeniz daha kolay olacaktır.

    2. Site Adı için web uygulaması için bir ad girin.

    3. Barındırma planı adı için, web uygulamasını barındırmak için kullanılacak App Service planı için bir ad girin.

    4. Gözden geçir ve oluştur’u seçin.

      Screenshot showing the Custom deployment page.

  3. Gözden Geçir + oluştur sayfasında Oluştur'u seçin.

  4. Dağıtımın tamamlanması birkaç dakika sürebilir. Portalda Uyarılar 'ı (zil simgesi) ve ardından Kaynak grubuna git'i seçin.

    Screenshot showing the successful deployment message with a link to navigate to the resource group.

  5. Kaynak grubu sayfasındaki kaynak listesinde, oluşturduğunuz web uygulamasını seçin. App Service planını ve depolama hesabını da bu listede görürsünüz.

    Screenshot that shows the Resource Group page with the deployed resources.

  6. Web uygulamanızın App Service sayfasında, web sitesine gitmek için URL'yi seçin. URL şu biçimde olmalıdır: https://<your-site-name>.azurewebsites.net.

    Screenshot that shows the App Service page with the link to the site highlighted.

  7. Siteyi gördüğünüzden ancak henüz hiçbir olay gönderilmediğinden emin olun.

    Screenshot that shows the Event Grid Viewer sample app.

Özel konuya abone olma

Event Grid konusuna abone olarak Event Grid'e hangi olayları izlemek istediğinizi ve olayların nereye gönderileceği açıklanır.

  1. Şimdi, özel konunuzun Event Grid Konu sayfasında araç çubuğunda + Olay Aboneliği'ni seçin.

    Add event subscription button

  2. Olay Aboneliği Oluştur sayfasında şu adımları izleyin:

    1. Olay aboneliği için bir ad girin.

    2. Uç nokta türü için Web Kancası'nı seçin.

    3. Uç nokta seçin'i seçin.

      Provide event subscription values

    4. Web kancası uç noktası için web uygulamanızın URL'sini girin ve ana sayfa URL'sine api/updates ekleyin. Seçimi Onayla'yı seçin.

      Provide endpoint URL

    5. Olay Aboneliği Oluştur sayfasına dönüp Oluştur'u seçin.

  3. Web uygulamanızı yeniden görüntüleyin ve buna bir abonelik doğrulama olayının gönderildiğine dikkat edin. Göz simgesini seçerek olay verilerini genişletin. Uç noktanın olay verilerini almak istediğini doğrulayabilmesi için Event Grid doğrulama olayını gönderir. Web uygulaması aboneliği doğrulamak için kod içerir.

    Screenshot of the Event Grid Viewer app with the Subscription Validated event.

Konunuza olay gönderme

Şimdi, Event Grid’in iletiyi uç noktanıza nasıl dağıttığını görmek için bir olay tetikleyelim. Özel konunuza bir test olayı göndermek için Azure CLI veya PowerShell kullanın. Normalde olay verilerini bir uygulama veya Azure hizmeti gönderir.

Birinci örnekte, Azure CLI kullanılmaktadır. Özel konunun URL’si ve anahtarı ile örnek olay verilerini alır. <topic name> yerine özel konunuzun adını yazın. Örnek olay verileri oluşturulur. JSON’un data öğesi, olayınızın yüküdür. Bu alana doğru oluşturulmuş herhangi bir JSON gelebilir. Ayrıca, gelişmiş yönlendirme ve filtreleme için konu alanını da kullanabilirsiniz. CURL, HTTP istekleri gönderen bir yardımcı programdır.

Azure CLI

  1. Azure portalında Cloud Shell'i seçin. Cloud Shell, web tarayıcısının alt bölmesinde açılır.

    Select Cloud Shell icon

  2. Cloud Shell penceresinin sol üst köşesindeki Bash'i seçin.

    Screenshot that shows the Cloud Shell with Bash selected in the top-left corner.

  3. Konunun uç noktasını almak için aşağıdaki komutu çalıştırın: Komutu kopyalayıp yapıştırdıktan sonra, komutu çalıştırmadan önce konu adını ve kaynak grubu adını güncelleştirin. Örnek olayları bu konu uç noktasına yayımlarsınız.

    endpoint=$(az eventgrid topic show --name <topic name> -g <resource group name> --query "endpoint" --output tsv)

  4. Özel konunun anahtarını almak için aşağıdaki komutu çalıştırın: Komutu kopyalayıp yapıştırdıktan sonra, komutu çalıştırmadan önce konu adını ve kaynak grubu adını güncelleştirin. Event Grid konusunun birincil anahtarıdır. Bu anahtarı Azure portalından almak için Event Grid Konu Sayfasının Erişim anahtarları sekmesine geçin. Bir olayı özel bir konuya gönderebilmek için erişim anahtarına ihtiyacınız vardır.

    key=$(az eventgrid topic key list --name <topic name> -g <resource group name> --query "key1" --output tsv)

  5. Olay tanımıyla aşağıdaki deyimi kopyalayın ve ENTER tuşuna basın.

    event='[ {"id": "'"$RANDOM"'", "eventType": "recordInserted", "subject": "myapp/vehicles/motorcycles", "eventTime": "'`date +%Y-%m-%dT%H:%M:%S%z`'", "data":{ "make": "Ducati", "model": "Monster"},"dataVersion": "1.0"} ]'

  6. Olayı göndermek için aşağıdaki Curl komutunu çalıştırın: Komutun üst bilgisi daha aeg-sas-key önce edindiğiniz erişim anahtarına ayarlanır.

    curl -X POST -H "aeg-sas-key: $key" -d "$event" $endpoint

Azure PowerShell

İkinci örnek, benzer adımları gerçekleştirmek için PowerShell'i kullanır.

  1. Azure portalında Cloud Shell'i seçin (alternatif olarak adresine https://shell.azure.com/gidin). Cloud Shell, web tarayıcısının alt bölmesinde açılır.

    Select Cloud Shell icon

  2. Cloud Shell'de Cloud Shell penceresinin sol üst köşesindeki PowerShell'i seçin. Azure CLI bölümündeki örnek Cloud Shell pencere görüntüsüne bakın.

  3. Aşağıdaki değişkenleri ayarlayın. Her komutu kopyalayıp yapıştırdıktan sonra, komutu çalıştırmadan önce konu adını ve kaynak grubu adını güncelleştirin:

    Kaynak grubu:

    $resourceGroupName = "<resource group name>"

    Event Grid konu adı:

    $topicName = "<topic name>"

  4. Konunun uç noktasını ve anahtarlarını almak için aşağıdaki komutları çalıştırın:

    $endpoint = (Get-AzEventGridTopic -ResourceGroupName $resourceGroupName -Name $topicName).Endpoint
$keys = Get-AzEventGridTopicKey -ResourceGroupName $resourceGroupName -Name $topicName

  5. Olayı hazırlayın. Cloud Shell penceresinde deyimleri kopyalayın ve çalıştırın.

    $eventID = Get-Random 99999

#Date format should be SortableDateTimePattern (ISO 8601)
$eventDate = Get-Date -Format s

#Construct body using Hashtable
$htbody = @{
    id= $eventID
    eventType="recordInserted"
    subject="myapp/vehicles/motorcycles"
    eventTime= $eventDate   
    data= @{
        make="Ducati"
        model="Monster"
    }
    dataVersion="1.0"
}

#Use ConvertTo-Json to convert event body from Hashtable to JSON Object
#Append square brackets to the converted JSON payload since they are expected in the event's JSON payload syntax
$body = "["+(ConvertTo-Json $htbody)+"]"

  6. Olayı göndermek için Invoke-WebRequest cmdlet'ini kullanın.

    Invoke-WebRequest -Uri $endpoint -Method POST -Body $body -Headers @{"aeg-sas-key" = $keys.Key1}

Event Grid Görüntüleyicisi'nde doğrulama

Olayı tetiklediniz ve Event Grid, iletiyi abone olurken yapılandırdığınız uç noktaya gönderdi. Az önce gönderdiğiniz olayı görmek için web uygulamanızı görüntüleyin.

Event Grid Viewer

Kaynakları temizleme

Bu olayla çalışmaya devam etmeyi planlıyorsanız bu makalede oluşturulan kaynakları temizlemeyin. Aksi takdirde, bu makalede oluşturduğunuz kaynakları silin.

  1. Soldaki menüden Kaynak Grupları'nı seçin. Sol menüde görmüyorsanız, soldaki menüden Tüm Hizmetler'i ve kaynak grupları'nı seçin.

    Screenshot that shows the Resource Groups page.

  2. Kaynak grubu sayfasını başlatmak için kaynak grubunu seçin.

  3. Araç çubuğunda Kaynak grubunu sil'i seçin.

  4. Kaynak grubunun adını girerek silme işlemini onaylayın ve Sil'i seçin.

    Görüntüde gördüğünüz diğer kaynak grubu Cloud Shell penceresi tarafından oluşturulmuş ve kullanılmıştır. Cloud Shell penceresini daha sonra kullanmayı planlamıyorsanız silin.

Sonraki adımlar

Özel konu ve olay abonelikleri oluşturma işlemini öğrendiğinize göre artık Event Grid’in size nasıl yardımcı olabileceği konusunda daha fazla bilgi edinebilirsiniz:

Event Grid'de olayları farklı programlama dilleri kullanarak yayımlama ve kullanma hakkında bilgi edinmek için aşağıdaki örneklere bakın.