Konfigurera en Service Fabric-serverdel i API Management med hjälp av Azure-portalen

Förutsättningar för att konfigurera en exempeltjänst i ett Service Fabric-kluster som kör Windows som en anpassad serverdel:

• Windows-utvecklingsmiljö – Installera Visual Studio 2019 och Azure-utveckling, ASP.NET och webbutveckling samt arbetsbelastningar för plattformsoberoende utveckling i .NET Core. Konfigurera sedan en .NET-utvecklingsmiljö.

• Service Fabric-kluster – Se Självstudie: Distribuera ett Service Fabric-kluster som kör Windows till ett virtuellt Azure-nätverk. Du kan skapa ett kluster med ett befintligt X.509-certifikat eller i testsyfte skapa ett nytt självsignerat certifikat. Klustret skapas i ett virtuellt nätverk.

• Exempel på Service Fabric-app – Skapa en webb-API-app och distribuera till Service Fabric-klustret enligt beskrivningen i Integrera API Management med Service Fabric i Azure.

  De här stegen skapar en grundläggande tillståndslös ASP.NET Core Reliable Service med hjälp av standardmallen webb-API-projekt. Senare exponerar du HTTP-slutpunkten för den här tjänsten via Azure API Management.

  Anteckna programnamnet, till exempel fabric:/myApplication/myService.

• API Management-instans – en befintlig eller ny API Management-instans på premium - eller utvecklarnivån och i samma region som Service Fabric-klustret. Om du behöver en skapar du en API Management-instans.

• Virtuellt nätverk – Lägg till din API Management-instans i det virtuella nätverk som du skapade för Service Fabric-klustret. API Management kräver ett dedikerat undernät i det virtuella nätverket.

  Anvisningar för hur du aktiverar anslutning till virtuella nätverk för API Management-instansen finns i Så här använder du Azure API Management med virtuella nätverk.

Lägga till Service Fabric-klustercertifikat i API Management

Service Fabric-klustercertifikatet lagras och hanteras i ett Azure-nyckelvalv som är associerat med klustret. Lägg till det här certifikatet i DIN API Management-instans som ett klientcertifikat.

Anvisningar för hur du lägger till ett certifikat i DIN API Management-instans finns i Så här skyddar du serverdelstjänster med klientcertifikatautentisering i Azure API Management.

Lägg till Service Fabric-serverdel

1. I Azure-portalen går du till din API Management-instans.

2. Under API:er väljer du Serverdelar>+ Lägg till.

3. Ange ett serverdelsnamn och en valfri beskrivning

4. I Typ väljer du Service Fabric.

5. I Körnings-URL anger du namnet på den Service Fabric-serverdelstjänst som API Management vidarebefordrar begäranden till. Exempel: fabric:/myApplication/myService.

6. I Maximalt antal återförsök för partitionsmatchning anger du ett tal mellan 0 och 10.

7. Ange hanteringsslutpunkten för Service Fabric-klustret. Den här slutpunkten är URL:en för klustret på port 19080, till exempel https://mysfcluster.eastus.cloudapp.azure.com:19080.

8. I Klientcertifikat väljer du det Service Fabric-klustercertifikat som du lade till i DIN API Management-instans i föregående avsnitt.

9. I Auktoriseringsmetod för hanteringsslutpunkt anger du ett tumavtryck eller ett X509-servernamn för ett certifikat som används av Service Fabric-klusterhanteringstjänsten för TLS-kommunikation.

10. Aktivera inställningarna Verifiera certifikatkedja och Verifiera certifikatnamn.

11. I Autentiseringsuppgifter för auktorisering anger du autentiseringsuppgifter om det behövs för att nå den konfigurerade serverdelstjänsten i Service Fabric. För exempelappen som används i det här scenariot behövs inte autentiseringsuppgifter för auktorisering.

12. Välj Skapa.

    

Om du vill använda en anpassad serverdel refererar du till den med hjälp av set-backend-service principen. Den här principen omvandlar standardbas-URL:en för serverdelstjänsten för en inkommande API-begäran till en angiven serverdel, i det här fallet Service Fabric-serverdelen.

Principen set-backend-service kan vara användbar med ett befintligt API för att omvandla en inkommande begäran till en annan serverdel än den som anges i API-inställningarna. I demonstrationssyfte i den här artikeln skapar du ett test-API och ställer in principen för att dirigera API-begäranden till Service Fabric-serverdelen.

Skapa API

Följ stegen i Lägg till ett API manuellt för att skapa ett tomt API.

• Lämna url:en för webbtjänsten tom i API-inställningarna.

• Lägg till ett API URL-suffix, till exempel infrastrukturresurser.

  

Lägga till GET-åtgärden i API:et

Som du ser i Distribuera en Service Fabric-serverdelstjänst stöder exempeltjänsten ASP.NET Core som distribueras i Service Fabric-klustret en enda HTTP GET-åtgärd på URL-sökvägen /api/values.

Standardsvaret på den sökvägen är en JSON-matris med två strängar:

["value1", "value2"]

Om du vill testa integreringen av API Management med klustret lägger du till motsvarande GET-åtgärd i API:et på sökvägen /api/values:

1. Välj det API som du skapade i föregående steg.

2. Välj + Lägg till åtgärd.

3. I fönstret Klientdel anger du följande värden och väljer Spara.

   Inställning	Värde
   Visningsnamn	Testa serverdelen
   URL	GET
   URL	/api/values

   

Konfigurera set-backend-service princip

set-backend-service Lägg till principen i test-API:et.

1. På fliken Design i avsnittet Inkommande bearbetning väljer du kodredigerarens (</>) ikon.

2. Placera markören inuti det <inkommande> elementet

3. Lägg till policy-instruktionen set-service-backend .

   • I backend-idersätter du namnet på Service Fabric-serverdelen.

   • sf-resolve-condition är ett villkor för att matcha en tjänstplats igen och skicka en begäran igen. Antalet återförsök angavs när serverdelen konfigurerades. Till exempel:

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

4. Välj Spara.

   

Testa serverdels-API

1. På fliken Test väljer du den GET-åtgärd som du skapade i ett tidigare avsnitt.

2. Välj Skicka.

   När http-svaret är korrekt konfigurerat visar det en HTTP-framgångskod och visar JSON som returneras från serverdelstjänsten Service Fabric.