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. 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änk bredvid Distribution för att ladda ned filen.

7. config.service.endpointJustera , 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.
   • Exemplet nedan använder NodePort.

9. Välj kopieringsikonen till höger i textrutan Distribuera för att spara kommandot i kubectl Urklipp.

10. Klistra in kommandot i terminalfönstret (eller kommandot). 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 kommandot nedan för att kontrollera att gateway-podden körs. Poddens namn kommer att vara annorlunda.

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

13. Kör kommandot nedan för att kontrollera att gatewaytjänsten körs. Tjänstnamnet och IP-adresserna skiljer sig åt.

    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 Portal och bekräfta att gatewaynoden som du distribuerade rapporterar felfri status.

Dricks

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

Nästa steg

• 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.