Hızlı Başlangıç: Azure portalı ve Azure Event Grid ile web uç noktasına özel olaylar gönderme

Bu hızlı başlangıçta bir konu oluşturacak, Web kancası uç noktasını kullanarak bu konuya abonelik oluşturacak, örnek olayı tetikleyebilir ve ardından sonucu görüntüleyebilirsiniz. Normalde olayları, olay verilerini işleyen ve eylemler gerçekleştiren bir uç noktaya gönderirsiniz. Ancak, bu öğreticiyi basitleştirmek için, olayları iletileri toplayan ve görüntüleyen bir web uygulamasına gönderirsiniz.

Önkoşullar

• Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir Azure hesabı oluşturun.
• Yeni Azure Event Grid kullanıyorsanız bkz . Event Grid'e genel bakış.

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'ın 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.

   

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

   

Ö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.

   

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

   

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.

      

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

      

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.

   

   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.

   

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

   1. Kaynak grubu için mevcut bir kaynak grubunu seçin veya bir kaynak grubu oluşturun.

   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.

      

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.

   

5. Kaynak grubu sayfasındaki kaynak listesinde, oluşturduğunuz web uygulamasını (aşağıdaki örnekte contosoegriviewer) seçin.

   

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.

   

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

   

Ö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.

   

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.

      

   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.

      

   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.

   

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.

   

2. Cloud Shell bir PowerShell oturumu açarsa Cloud Shell penceresinin sol üst köşesinde bash'e geç'i seçin. Aksi takdirde sonraki adıma geçin.

   

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.

   

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.

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.

   

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.

İlgili içerik

Ö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:

• Blob depolama olaylarını bir özel web uç noktasına yönlendirme
• .NET için Azure Event Grid örnekleri
• Java için Azure Event Grid örnekleri