Blob depolama olaylarını web uç noktasına yönlendirmek için Azure Event Grid kullanma (Azure portalı)

  • 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. Blob depolama hesabı oluşturun.
  2. Bu blob depolama için olaylara abone olun.
  3. Blob depolama alanına dosya yükleyerek bir olayı tetikleyin.
  4. İşleyici web uygulamasında sonucu görüntüleyin. Normalde olayları, olay verilerini işleyen ve eylemler gerçekleştiren bir uç noktaya gönderirsiniz. Basit tutmak için, iletileri toplayan ve görüntüleyen bir web uygulamasına olaylar gönderirsiniz.

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

İşiniz bittiğinde, olay verilerinin web uygulamasına gönderildiğini görürsünüz.

Screenshot that shows the sample Azure Event Grid Viewer app with an event.

Depolama hesabı oluşturma

  1. Azure portalda oturum açın.

  2. Bir Blob depolaması oluşturmak için Kaynak oluşturun'u seçin.

  3. Ara alanına Depolama hesap girin ve sonuç listesinden Depolama hesabı seçin.

    Screenshot showing the search for Storage account on the Create a resource page.

  4. Depolama hesabı sayfasında Oluştur'u seçerek depolama hesabını oluşturmaya başlayın. Olaylara abone olmak için, genel amaçlı v2 depolama hesabı veya bir Blob depolama hesabı oluşturun.

  5. Depolama hesabı oluştur sayfasında aşağıdaki adımları uygulayın:

    1. Azure aboneliği seçin.

    2. Kaynak grubu için yeni bir kaynak grubu oluşturun veya var olan bir kaynak grubunu seçin.

    3. Depolama hesabınızın adını girin.

    4. Depolama hesabının oluşturulmasını istediğiniz Bölgeyi seçin.

    5. Yedeklilik için açılan listeden Yerel olarak yedekli depolama (LRS) seçeneğini belirleyin.

    6. Sayfanın alt kısmındaki Gözden Geçir'i seçin.

      Screenshot showing the Create a storage account page.

    7. Gözden Geçir sayfasında ayarları gözden geçirin ve Oluştur'u seçin.

      Not

      Yalnızca Depolama V2 (genel amaçlı v2) ve Blob türünde depolama hesapları Depolama olay tümleştirmesini destekler. Depolama (genel amaçlı v1), Event Grid ile tümleştirmeyi desteklemez.

  6. Dağıtımın tamamlanması birkaç dakika sürer. Dağıtım sayfasında Kaynağa git'i seçin.

    Screenshot showing the deployment succeeded page with a link to go to the resource.

  7. Depolama hesabı sayfasında soldaki menüden Olaylar'ı seçin.

    Screenshot showing the Events page for an Azure storage account.

  8. Bu sayfayı web tarayıcısında açık tutun.

İleti uç noktası oluşturma

Blob depolamasındaki olaylara abone olmadan önce olay iletisi için uç noktayı oluşturalım. 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 Azure'a Dağıt'ı seçin.

    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ürer. Dağıtım sayfasında Kaynak grubuna git'i seçin.

    Screenshot showing the deployment succeeded page with a link to go 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 selection of web app in the resource group.

  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 selection of link to navigate to web app.

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

    View new site.

    Önemli

    Azure Event Grid Görüntüleyicisi penceresini açık tutun, böylece olayları gönderildikçe görebilirsiniz.

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.

Blob depolamaya abone olma

Event Grid’e hangi olayları izlemek istediğinizi ve olayların nereye gönderileceğini bildirmek için bir konuya abone olursunuz.

  1. Depolama hesabı sayfasını kapattıysanız, daha önce oluşturduğunuz Azure Depolama hesabınıza gidin. Soldaki menüde Tüm kaynaklar'ı seçin ve depolama hesabınızı seçin.

  2. Depolama hesabı sayfasında soldaki menüden Olaylar'ı seçin.

  3. Diğer Seçenekler'i ve Web Kancası'nı seçin. Uç nokta için bir web kancası kullanarak görüntüleyici uygulamanıza olay gönderiyorsunuz.

    Screenshot showing the selection of Web Hook on the Events page.

  4. Olay Aboneliği Oluştur sayfasında aşağıdaki adımları uygulayın:

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

    2. Sistem konusu için bir ad girin. Sistem konuları hakkında bilgi edinmek için bkz . Sistem konularına genel bakış.

      Screenshot showing the Create Event Subscription page with a name for the system topic.

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

      Screenshot showing the Create Event Subscription page with Web Hook selected as an endpoint.

  5. Uç Nokta için Bir uç nokta seçin'i seçin ve web uygulamanızın URL'sini girin ve giriş sayfası URL'sine ekleyin api/updates (örneğin: https://spegridsite.azurewebsites.net/api/updates) ve ardından Seçimi Onayla'yı seçin.

    Screenshot showing the Select Web Hook page.

  6. Şimdi Olay Aboneliği Oluştur sayfasında Oluştur'u seçerek olay aboneliğini oluşturun.

    Screenshot showing the Create Event Subscription page with all fields selected.

  7. 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 showing the Event Grid Viewer with the subscription validation event.

Şimdi, Event Grid’in iletiyi uç noktanıza nasıl dağıttığını görmek için bir olay tetikleyelim.

Uç noktanıza olay gönderme

Dosya yükleyerek Blob depolaması için bir olay tetiklemiş olursunuz. Dosyanın belirli bir içeriğe sahip olmasına gerek yoktur.

  1. Azure portalında Blob depolama hesabınıza gidin ve izin menüsünde Kapsayıcılar'ı seçin.

  2. + Kapsayıcı'yı seçin. Kapsayıcınıza bir ad verin ve herhangi bir erişim düzeyini kullanın ve Oluştur'u seçin.

    Screenshot showing the New container page.

  3. Yeni kapsayıcınızı seçin.

    Screenshot showing the selection of the container.

  4. Dosya yüklemek için Yükle'yi seçin. Blobu karşıya yükle sayfasında, test için karşıya yüklemek istediğiniz bir dosyaya göz atın ve seçin ve ardından bu sayfada Karşıya Yükle'yi seçin.

    Screenshot showing Upload blob page.

  5. Test dosyanıza göz atın ve yükleyin.

  6. Olayı tetiklediniz ve Event Grid, iletiyi abone olurken yapılandırdığınız uç noktaya gönderdi. İleti JSON biçimindedir ve bir veya daha fazla olay içeren bir dizi içerir. Aşağıdaki örnekte, JSON iletisi tek olaylı bir dizi içerir. Web uygulamanızı görüntüleyin ve blob oluşturma olayının alındığına dikkat edin.

    Screenshot showing the Event Grid Viewer page with the Blob Created event.

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.

Kaynak grubunu seçin ve Kaynak grubunu sil seçeneğini belirleyin.

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: