Azure portalını kullanarak API Management'ta Service Fabric arka ucu ayarlama

Windows çalıştıran bir Service Fabric kümesindeki örnek hizmeti özel arka uç olarak yapılandırma önkoşulları:

• Windows geliştirme ortamı - Visual Studio 2019'u ve Azure geliştirme, ASP.NET ve web geliştirme ile .NET Core platformlar arası geliştirme iş yüklerini yükleyin. Ardından bir .NET dağıtım ortamı ayarlayın.

• Service Fabric kümesi - Bkz . Öğretici: Windows çalıştıran bir Service Fabric kümesini Azure sanal ağına dağıtma. Mevcut bir X.509 sertifikasına sahip bir küme oluşturabilir veya test amacıyla yeni, otomatik olarak imzalanan bir sertifika oluşturabilirsiniz. Küme bir sanal ağda oluşturulur.

• Örnek Service Fabric uygulaması - Azure'da API Management'ı Service Fabric ile Tümleştirme bölümünde açıklandığı gibi bir Web API uygulaması oluşturun ve Service Fabric kümesine dağıtın.

  Bu adımlar, varsayılan Web API proje şablonunu kullanarak temel durum bilgisi olmayan ASP.NET Core Reliable Service oluşturur. Daha sonra, Azure API Management aracılığıyla bu hizmet için HTTP uç noktasını kullanıma sunarsınız.

  Uygulama adını not alın, örneğin fabric:/myApplication/myService.

• API Management örneği - Premium veya Geliştirici katmanında ve Service Fabric kümesiyle aynı bölgede bulunan mevcut veya yeni bir API Management örneği. Gerekirse bir API Management örneği oluşturun.

• Sanal ağ - API Management örneğinizi Service Fabric kümeniz için oluşturduğunuz sanal ağa ekleyin. API Management, sanal ağda ayrılmış bir alt ağ gerektirir.

  API Management örneği için sanal ağ bağlantısını etkinleştirme adımları için bkz . Sanal ağlarla Azure API Management'ı kullanma.

API Management'a Service Fabric küme sertifikası ekleme

Service Fabric küme sertifikası, kümeyle ilişkilendirilmiş bir Azure anahtar kasasında depolanır ve yönetilir. Bu sertifikayı API Management örneğinize istemci sertifikası olarak ekleyin.

API Management örneğinize sertifika ekleme adımları için bkz . Azure API Management'ta istemci sertifikası kimlik doğrulamasını kullanarak arka uç hizmetlerinin güvenliğini sağlama.

Service Fabric arka ucu ekleme

1. Azure portalında API Management örneğine gidin.

2. API'ler'in altında Arka Uçlar>+ Ekle'yi seçin.

3. Arka uç adı ve isteğe bağlı bir açıklama girin

4. Tür'de Service Fabric'i seçin.

5. Çalışma Zamanı URL'sinde, API Management'ın istekleri ileteceği Service Fabric arka uç hizmetinin adını girin. Örnek: fabric:/myApplication/myService.

6. Bölüm çözümlemesi yeniden deneme sayısı üst sınırı alanına 0 ile 10 arasında bir sayı girin.

7. Service Fabric kümesinin yönetim uç noktasını girin. Bu uç nokta, örneğin bağlantı noktasındaki 19080kümenin URL'sidir https://mysfcluster.eastus.cloudapp.azure.com:19080.

8. İstemci sertifikası bölümünde, önceki bölümde API Management örneğine eklediğiniz Service Fabric küme sertifikasını seçin.

9. Yönetim uç noktası yetkilendirme yöntemi bölümünde, TLS iletişimi için Service Fabric küme yönetim hizmeti tarafından kullanılan bir sertifikanın parmak izini veya sunucu X509 adını girin.

10. Sertifika zincirini doğrula ve Sertifika adını doğrula ayarlarını etkinleştirin.

11. Yetkilendirme kimlik bilgileri bölümünde, gerekirse Service Fabric'te yapılandırılan arka uç hizmetine ulaşmak için kimlik bilgilerini sağlayın. Bu senaryoda kullanılan örnek uygulama için yetkilendirme kimlik bilgileri gerekli değildir.

12. Oluştur'u belirleyin.

    

Özel bir arka uç kullanmak için ilkeyi set-backend-service kullanarak buna başvurun. Bu ilke, gelen API isteğinin varsayılan arka uç hizmet tabanı URL'sini belirtilen bir arka uçtan(bu örnekte Service Fabric arka ucuna) dönüştürür.

İlke, set-backend-service gelen bir isteği API ayarlarında belirtilenden farklı bir arka uçtan dönüştürmek için mevcut BIR API ile yararlı olabilir. Bu makaledeki tanıtım amacıyla bir test API'sini oluşturun ve ilkeyi API isteklerini Service Fabric arka ucuna yönlendirecek şekilde ayarlayın.

API oluşturma

Boş bir API oluşturmak için API'yi el ile ekleme'deki adımları izleyin.

• API ayarlarında Web hizmeti URL'sini boş bırakın.

• Doku gibi bir API URL son eki ekleyin.

  

API'ye GET işlemi ekleme

Service Fabric arka uç hizmetini dağıtma bölümünde gösterildiği gibi, Service Fabric kümesinde dağıtılan örnek ASP.NET Core hizmeti URL yolunda /api/valuestek bir HTTP GET işlemini destekler.

Bu yoldaki varsayılan yanıt, iki dizeden oluşan bir JSON dizisidir:

["value1", "value2"]

API Management'ın kümeyle tümleştirmesini test etmek için, yolundaki /api/valuesAPI'ye karşılık gelen GET işlemini ekleyin:

1. Önceki adımda oluşturduğunuz API’yi seçin.

2. + İşlem Ekle’yi seçin.

3. Ön uç penceresinde aşağıdaki değerleri girin ve Kaydet'i seçin.

   Ayar	Value
   Görünen ad	Arka ucu test et
   URL	GET
   URL	/api/values

   

İlkeyi yapılandırma set-backend-service

İlkeyi set-backend-service test API'sine ekleyin.

1. Tasarım sekmesindeki Gelen işleme bölümünde kod düzenleyicisi (</>) simgesini seçin.

2. İmleci gelen> öğesinin <içine yerleştirme

3. İlke deyimini set-service-backend ekleyin.

   • içinde backend-id, Service Fabric arka ucunuzun adını kullanın.

   • sf-resolve-condition, bir hizmet konumunu çözümlemeye ve isteği yeniden göndermeye yönelik bir koşuldur. Arka uç yapılandırıldığında yeniden deneme sayısı ayarlandı. Örneğin:

     <set-backend-service backend-id="mysfbackend" sf-resolve-condition="@(context.LastError?.Reason == "BackendConnectionFailure")"/>
     

4. Kaydet'i seçin.

   

Arka uç API'lerini test edin

1. Test sekmesinde, önceki bölümde oluşturduğunuz GET işlemini seçin.

2. Gönder'i seçin.

   Düzgün yapılandırıldığında, HTTP yanıtı bir HTTP başarı kodu gösterir ve arka uç Service Fabric hizmetinden döndürülen JSON'ı görüntüler.