Een zelf-hostende gateway van Azure API Management implementeren in Azure Kubernetes Service

  • Artikel

VAN TOEPASSING OP: Ontwikkelaar | Premium

Dit artikel bevat de stappen voor het implementeren van een zelf-hostend gatewayonderdeel van Azure API Management in Azure Kubernetes Service. Zie het how-to-artikel voor implementatie met behulp van een YAML-implementatiebestand of helm voor het implementeren van zelf-hostende gateways in een Kubernetes-cluster.

Belangrijk

Ondersteuning voor zelf-hostende gatewayversie 0 en versie 1 van Azure API Management eindigt op 1 oktober 2023, samen met de bijbehorende Configuratie-API v1. Gebruik onze migratiehandleiding voor het gebruik van zelf-hostende gateway v2.0.0 of hoger met configuration-API v2. Meer informatie vindt u in onze documentatie over afschaffing

Notitie

U kunt ook zelf-hostende gateway implementeren in een Kubernetes-cluster met Azure Arc als clusterextensie.

Vereisten

De zelf-hostende gateway implementeren in AKS

  1. Selecteer Gateways onder Implementatie en infrastructuur.

  2. Selecteer de zelf-hostende gatewayresource die u wilt implementeren.

  3. Selecteer Implementatie.

  4. Er is automatisch een nieuw token in het tekstvak Token gegenereerd met behulp van de standaardwaarden voor vervaldatum en geheime sleutel . Pas een van beide aan of beide indien gewenst en selecteer Genereren om een nieuw token te maken.

  5. Zorg ervoor dat Kubernetes is geselecteerd onder Implementatiescripts.

  6. Selecteer <de gatewaynaam>.yml bestandskoppeling naast Implementatie om het bestand te downloaden.

  7. Pas indien nodig de config.service.endpointpoorttoewijzingen en containernaam in het .yml-bestand aan.

  8. Afhankelijk van uw scenario moet u mogelijk het servicetype wijzigen.

    • De standaardwaarde is LoadBalancer, de externe load balancer.
    • U kunt de interne load balancer gebruiken om de toegang tot de zelf-hostende gateway te beperken tot alleen interne gebruikers.
    • In het onderstaande voorbeeld wordt gebruikgemaakt van NodePort.

  9. Selecteer het kopieerpictogram aan de rechterkant van het tekstvak Implementeren om de kubectl opdracht op het Klembord op te slaan.

  10. Plak de opdracht in het terminalvenster (of opdrachtvenster). De opdracht verwacht dat het gedownloade omgevingsbestand aanwezig is in de huidige map.

    kubectl apply -f <gateway-name>.yaml

  11. Voer de opdracht uit. Met de opdracht wordt uw AKS-cluster geïnstrueerd om het volgende te doen:

    • Voer de container uit met behulp van de zelf-hostende gatewayinstallatiekopie die u hebt gedownload uit Microsoft Container Registry.
    • Configureer de container om HTTP-poorten (8080) en HTTPS (443) beschikbaar te maken.

  12. Voer de onderstaande opdracht uit om te controleren of de gatewaypod wordt uitgevoerd. De podnaam is anders.

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

  13. Voer de onderstaande opdracht uit om te controleren of de gatewayservice wordt uitgevoerd. Uw servicenaam en IP-adressen verschillen.

    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. Ga terug naar Azure Portal en controleer of het gatewayknooppunt dat u hebt geïmplementeerd, de status In orde rapporteert.

Tip

Gebruik kubectl logs <gateway-pod-name> de opdracht om een momentopname van zelf-hostend gatewaylogboek weer te geven.

Volgende stappen