Distribuera en lokal Azure API Management-gateway till Azure Kubernetes Service

GÄLLER FÖR: Utvecklare | Premie

Den här artikeln innehåller stegen för att distribuera en lokalt installerad gatewaykomponent i Azure API Management till Azure Kubernetes Service (AKS). Information om hur du distribuerar en lokalt installerad gateway till ett Kubernetes-kluster finns i artikeln instruktioner för distribution med hjälp av en YAML-distributionsfil eller med Helm.

Kommentar

Du kan också distribuera en lokalt installerad gateway till ett Azure Arc-aktiverat Kubernetes-kluster som ett klustertillägg.

Förutsättningar

• Skapa en Azure API Management-instans
• Skapa ett Azure Kubernetes-kluster med hjälp av Azure CLI, med Azure PowerShell eller med hjälp av Azure Portal.
• Etablera en gatewayresurs i din API Management-instans.

Distribuera den lokalt installerade gatewayen till AKS

1. Välj Gatewayer från under Distribution och infrastruktur.

2. Välj den gatewayresurs med egen värd som du tänker distribuera.

3. Välj Distribution.

4. En ny token i textrutan Token genererades automatiskt med standardvärdena Förfallodatum och Hemlig nyckel . Justera antingen eller båda om du vill och välj Generera för att skapa en ny token.

5. Kontrollera att Kubernetes har valts under Distributionsskript.

6. <Välj gateway-name>.yml-fillänken bredvid Distribution för att ladda ned filen.

7. Justera config.service.endpoint, portmappningar och containernamn i den .yml-filen efter behov.

8. Beroende på ditt scenario kan du behöva ändra tjänsttypen.

   • Standardvärdet är LoadBalancer, som är den externa lastbalanseraren.
   • Du kan använda den interna lastbalanseraren för att begränsa åtkomsten till den lokala gatewayen till endast interna användare.
   • I följande exempel används NodePort.

9. Välj ikonen kopiera som ligger på höger sida av textrutan Distribuera för att spara kommandot i kubectl urklipp.

10. Klistra in kommandot i terminal- eller kommandofönstret. Kommandot förväntar sig att den nedladdade miljöfilen finns i den aktuella katalogen.

    kubectl apply -f <gateway-name>.yaml
    

11. Kör kommandot. Kommandot instruerar AKS-klustret att:

    • Kör containern med en lokalt installerad gatewayavbildning som hämtats från Microsoft Container Registry.
    • Konfigurera containern för att exponera HTTP-portar (8080) och HTTPS (443).

12. Kör följande kommando för att kontrollera att gateway-podden körs. Det här poddnamnet är ett exempel.

    kubectl get pods
    NAME                                   READY     STATUS    RESTARTS   AGE
    contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m
    

13. Kör följande kommando för att kontrollera att gatewaytjänsten körs. Tjänstnamnet och IP-adresserna är exempel.

    kubectl get services
    NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
    contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m
    

14. Gå tillbaka till Azure-portalen och bekräfta att gatewaynoden som du distribuerade rapporterar felfri status.

Tips

Använd kommandot kubectl logs <gateway-pod-name> för att visa en ögonblicksbild av logg för gateway med egen värd.

Relaterat innehåll

• Mer information om den lokalt installerade gatewayen finns i Översikt över självhanterad gateway i Azure API Management.
• Lär dig hur du distribuerar en lokalt installerad API Management-gateway till Azure Arc-aktiverade Kubernetes-kluster.
• Läs mer om observerbarhetsfunktionerna i Azure API Management-gatewayerna.
• Läs mer om vägledning för att köra den lokalt installerade gatewayen på Kubernetes i produktion.
• Läs mer om Azure Kubernetes Service.