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. 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.
Notitie
U kunt ook zelf-hostende gateway implementeren in een Kubernetes-cluster met Azure Arc als clusterextensie.
Vereisten
- 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 zelf-hostende gateway implementeren in AKS
Selecteer Gateways onder Implementatie en infrastructuur.
Selecteer de zelf-hostende gatewayresource die u wilt implementeren.
Selecteer Implementatie.
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.
Zorg ervoor dat Kubernetes is geselecteerd onder Implementatiescripts.
Selecteer <de gatewaynaam>.yml bestandskoppeling naast Implementatie om het bestand te downloaden.
Pas indien nodig de
config.service.endpoint
poorttoewijzingen en containernaam in het .yml-bestand aan.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
.
- De standaardwaarde is
Selecteer het kopieerpictogram aan de rechterkant van het tekstvak Implementeren om de
kubectl
opdracht op het Klembord op te slaan.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
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.
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
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
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
- 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 zelf-hostende gateway op Kubernetes in productie.
- Meer informatie over Azure Kubernetes Service.