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

VAN TOEPASSING OP: Ontwikkelaar | Premie

Dit artikel bevat de stappen voor het implementeren van een zelf-hostend gatewayonderdeel van Azure API Management in Azure Kubernetes Service (AKS). Zie het stappenplan voor implementatie met behulp van een YAML-implementatiebestand of Helm voor het implementeren van een zelf-gehoste gateway in een Kubernetes-cluster.

Notitie

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

Vereiste voorwaarden

• Een Azure API Management-exemplaar maken
• Maak een Azure Kubernetes-cluster met behulp van de Azure CLI, Azure PowerShell of azure Portal.
• Richt een gatewayresource in uw API Management-exemplaar in.

De zelfgehoste gateway implementeren in AKS

1. Selecteer Gateways onder Implementatie en infrastructuur.

2. Selecteer de zelfgehoste gatewayresource die u moet implementeren.

3. Selecteer Implementatie.

4. Er is automatisch een nieuw token voor je gegenereerd in het Token-tekstvak 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 <gateway-naam>.yml bestandslink naast Deployment 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 volgende 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 installatiekopie van de zelfgehoste gateway die u hebt gedownload uit het Microsoft Containerregister.
    • Configureer de container om HTTP-poorten (8080) en HTTPS (443) beschikbaar te maken.

12. Voer de volgende opdracht uit om te controleren of uw gateway pod draait. Deze podnaam is een voorbeeld.

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

13. Voer de volgende opdracht uit om te controleren of de gatewayservice wordt uitgevoerd. De servicenaam en IP-adressen zijn voorbeelden.

    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 de Azure-portal en controleer of het geïmplementeerde gatewayknooppunt een gezonde status rapporteert.

Tip

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

Verwante inhoud

• Zie het overzicht van zelf-hostende gateways in Azure API Management voor meer informatie over de zelf-hostende gateway.
• Meer informatie over het implementeren van zelf-hostende API Management-gateway naar Kubernetes-clusters met Azure Arc.
• Meer informatie over de waarneembaarheidsmogelijkheden van de Azure API Management-gateways.
• Meer informatie over richtlijnen voor het uitvoeren van de zelfgehoste gateway op Kubernetes in productie.
• Meer informatie over Azure Kubernetes Service.