Een zelf-hostende gateway implementeren in Kubernetes met YAML

VAN TOEPASSING OP: Ontwikkelaar | Premium

In dit artikel worden de stappen beschreven voor het implementeren van het zelf-hostende gatewayonderdeel van Azure API Management in een Kubernetes-cluster.

Vereisten

• Lees de volgende snelstartgids: Een Azure API Management-exemplaar maken.
• Maak een Kubernetes-cluster of heb toegang tot een bestaand cluster.

  Tip

  Clusters met één knooppunt werken goed voor ontwikkelings- en evaluatiedoeleinden. Gebruik on-premises kubernetes-gecertificeerde clusters met meerdere knooppunten of in de cloud voor productieworkloads.

• Richt een zelf-hostende gatewayresource in uw API Management-exemplaar in.

Implementeren naar Kubernetes

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 toegangstoken in het tekstvak Token voor u gegenereerd, op basis van de standaardwaarden voor vervaldatum en geheime sleutel . Kies indien nodig waarden in een van beide besturingselementen om een nieuw token te genereren.
5. Selecteer het tabblad Kubernetes onder Implementatiescripts.
6. Selecteer de <gatewaynaam>.yml bestandskoppeling en download het YAML-bestand.
7. Selecteer het kopieerpictogram in de rechterbenedenhoek van het tekstvak Implementeren om de kubectl opdrachten op het klembord op te slaan.
8. Wanneer u Azure Kubernetes Service (AKS) gebruikt, voert u deze uit az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin in een nieuwe terminalsessie.
9. Voer de opdrachten uit om de benodigde Kubernetes-objecten te maken in de standaardnaamruimte en start zelf-hostende gatewaypods uit de containerinstallatiekopie die u hebt gedownload uit de Microsoft-artefactregister.
   • Met de eerste stap maakt u een Kubernetes-geheim dat het toegangstoken bevat dat is gegenereerd in stap 4. Vervolgens wordt er een Kubernetes-implementatie gemaakt voor de zelf-hostende gateway die gebruikmaakt van een ConfigMap met de configuratie van de gateway.

Controleer of de gateway wordt uitgevoerd

1. Voer de volgende opdracht uit om te controleren of de implementatie is geslaagd. Het kan even duren voordat alle objecten zijn gemaakt en dat de pods zijn geïnitialiseerd.

   kubectl get deployments
   

   De waarde moet worden geretourneerd

   NAME             READY   UP-TO-DATE   AVAILABLE   AGE
   <gateway-name>   1/1     1            1           18s
   

2. Voer de volgende opdracht uit om te controleren of de services zijn gemaakt. Uw service-IP-adressen en poorten zijn anders.

   kubectl get services
   

   De waarde moet worden geretourneerd

   NAME                                TYPE           CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
   <gateway-name>-live-traffic         ClusterIP      None            <none>        4290/UDP,4291/UDP   9m1s
   <gateway-name>-instance-discovery   LoadBalancer   10.99.236.168   <pending>     80:31620/TCP,443:30456/TCP   9m1s
   

3. Ga terug naar Azure Portal en selecteer Overzicht.

4. Controleer of de status een groen vinkje weergeeft, gevolgd door een aantal knooppunten dat overeenkomt met het aantal replica's dat is opgegeven in het YAML-bestand. Deze status betekent dat de geïmplementeerde zelf-hostende gatewaypods met succes communiceren met de API Management-service en een normale 'heartbeat' hebben.

Volgende stappen

• Zie het overzicht van zelf-hostende gateways 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 richtlijnen voor het uitvoeren van de zelf-hostende gateway op Kubernetes in productie.