Sunucusuz geliştirme için Azure SignalR Yerel Öykünücüsü'ni kullanma

Sunucusuz uygulamalar geliştirirken, yerel geliştirmeyi ve tümleştirmeyi kolaylaştırmak için bir Azure SignalR Yerel Öykünücüsü sağlıyoruz. Öykünücü yalnızca sunucusuz senaryolar için çalışır; Azure SignalR Hizmeti proxy işlevi gören Varsayılan mod için yerel geliştirme yapmak için doğrudan kendi kendine konak SignalR kullanabilirsiniz. Ayrıca öykünücünün yalnızca Geçici aktarım türü (varsayılan) için çalıştığını ve Kalıcı aktarım türünü desteklemediğini unutmayın.

Kullanılabilir özellikler

• Auth
• En son Rest API desteği
• Üretim öncesi

Önemli

Ham bağlantı dizesi yalnızca tanıtım amacıyla bu makalede görünür.

bağlantı dizesi, uygulamanızın Azure SignalR Hizmeti erişmesi için gereken yetkilendirme bilgilerini içerir. bağlantı dizesi içindeki erişim anahtarı, hizmetinizin kök parolasına benzer. Üretim ortamlarında erişim anahtarlarınızı her zaman koruyun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek ve Microsoft Entra Id kullanarak bağlantı dizesi güvenliğini sağlamak ve Microsoft Entra ID ile erişimi yetkilendirmek için Azure Key Vault'u kullanın.

Erişim anahtarlarını diğer kullanıcılara dağıtmaktan, sabit kodlamaktan veya başkalarının erişebileceği herhangi bir yerde düz metin olarak kaydetmekten kaçının. Ele geçirilmiş olabileceklerini düşünüyorsanız anahtarlarınızı döndürün.

İzlenecek yol

Öykünücünün nasıl kullanılacağını göstermek için bu sunucusuz örneği kullanırız.

Ham bağlantı dizesi yalnızca tanıtım amacıyla bu makalede görünür. Üretim ortamlarında erişim anahtarlarınızı her zaman koruyun. Anahtarlarınızı güvenli bir şekilde yönetmek ve döndürmek ve Microsoft Entra Id kullanarak bağlantı dizesi güvenliğini sağlamak ve Microsoft Entra ID ile erişimi yetkilendirmek için Azure Key Vault'u kullanın.

1. Örnek depoyu yerel depoya kopyalama

   git clone https://github.com/Azure/azure-functions-signalrservice-extension.git
   cd azure-functions-signalrservice-extension/samples/bidirectional-chat
   

2. Öykünücüyü yükleme

   dotnet tool install  -g Microsoft.Azure.SignalR.Emulator
   

   Ya da öykünücü zaten yüklüyse öykünücüyü en son önizleme sürümüne güncelleştirin:

   dotnet tool update -g Microsoft.Azure.SignalR.Emulator
   

3. Tüm kullanılabilir komutları listelemek için öykünücüyü asrs-emulator çalıştırın

   

4. Aşağıdakini kullanarak varsayılan yukarı akış ayarlarını açın:

   asrs-emulator upstream init
   

   Geçerli klasöre varsayılan settings.json olarak bir yukarı akış UrlTemplatehttp://localhost:7071/runtime/webhooks/signalroluşturarak SignalR'ın yerel işlev tetikleyicisinin URL'sini oluşturur:

   {
   "UpstreamSettings": {
       "Templates": [
       {
           "UrlTemplate": "http://localhost:7071/runtime/webhooks/signalr",
           "EventPattern": "*",
           "HubPattern": "*",
           "CategoryPattern": "*"
       }
       ]
   }
   }
   

   Deseni daha kısıtlı hale getirmek için dosyasını düzenleyebilirsiniz; örneğin, yerine * olarak chatdeğiştirebilirsinizHubPattern. Dosya değiştirildiğinde, değişikliği öykünücüye çalışırken yüklenir.

5. Öykünücüyü başlatma

   asrs-emulator start
   

   Öykünücü başarıyla başlatıldıktan sonra, daha sonra kullanılacak ConnectionString'i oluşturur.

   Öykünücü, başlatıldığında gelişmiş seçenekler de sağlar; örneğin, öykünücünün kullandığı bağlantı noktasını özelleştirmek için kullanabilirsiniz asrs-emulator start -p 8999 . Kullanılabilir seçenekleri denetlemek için yazın asrs-emulator start --help .

6. Alt klasöre csharp gidin ve olarak yeniden adlandırın local.settings.sample.jsonlocal.settings.json, öykünücü tarafından oluşturulan ConnectionString'i kullanarak local.settings.json AzureSignalRConnectionStringdeğerini doldurun. Depolama UseDevelopmentStorage=true öykünücüsü AzureWebJobsStorage kullanırken depolama bağlantı dizesi doldurun. dosyasını kaydedin ve işlevi csharp ile func startalt klasörde çalıştırın.

   

7. Tarayıcıda demoyla oynamak için adresine gidin http://localhost:7071/api/index .

   

Sonraki adımlar

Bu makalede, uygulamalarınızda SignalR Hizmeti kullanmayı öğreneceksiniz. SignalR Hizmeti hakkında daha fazla bilgi edinmek için aşağıdaki makalelere bakın.

Azure SignalR Hizmeti iç işlevleri

Hızlı Başlangıç: SignalR Hizmeti kullanarak sohbet odası oluşturma