Delen via

Zelf-hostende gateway implementeren in Kubernetes met Helm

VAN TOEPASSING OP: Ontwikkelaar | Premie

Helm is een opensource-pakketprogramma waarmee u de levenscyclus van Kubernetes-toepassingen kunt installeren en beheren. Hiermee kunt u Kubernetes-grafieken beheren. Dit zijn pakketten van vooraf geconfigureerde Kubernetes-resources.

Dit artikel bevat de stappen voor het implementeren van een zelf-hostend gatewayonderdeel van Azure API Management in een Kubernetes-cluster met behulp van Helm.

Notitie

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

Vereisten

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

De Helm-opslagplaats toevoegen

  1. Voeg Azure API Management toe als een nieuwe Helm-opslagplaats.

    helm repo add azure-apim-gateway https://azure.github.io/api-management-self-hosted-gateway/helm-charts/

  2. Werk de opslagplaats bij om de meest recente Helm-grafieken op te halen.

    helm repo update

  3. Controleer uw Helm-configuratie door alle beschikbare grafieken weer te nemen.

    $ helm search repo azure-apim-gateway
NAME                                            CHART VERSION   APP VERSION     DESCRIPTION
azure-apim-gateway/azure-api-management-gateway 1.0.0           2.0.0           A Helm chart to deploy an Azure API Management ...

De zelf-hostende gateway implementeren in Kubernetes

  1. Selecteer Gateways onder Implementatie en infrastructuur.

  2. Selecteer de zelf-gehoste gateway-resource die u wilt implementeren.

  3. Selecteer Implementatie.

  4. Er werd automatisch een nieuw token voor u in het tekstvak Token gegenereerd, met gebruik van de standaardwaarde van Vervaldatum en Geheime sleutel. Pas een van beide aan of beide indien gewenst en selecteer Genereren om een nieuw token te maken.

  5. Noteer uw token en configuratie-URL

  6. De zelf-hostende gateway installeren met behulp van de Helm-grafiek

    helm install azure-api-management-gateway \
             --set gateway.configuration.uri='<your configuration url>' \
             --set gateway.auth.key='<your token>' \
             azure-apim-gateway/azure-api-management-gateway

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

    • Download de installatiekopie van de zelf-hostende gateway vanuit Microsoft Container Registry en voer deze uit als een container.
    • Configureer de container om HTTP-poorten (8080) en HTTPS (8081) beschikbaar te maken.

    Belangrijk

    De gateway maakt standaard gebruik van een ClusterIP-service en wordt alleen in het cluster weergegeven. U kunt dit wijzigen door het type Kubernetes-service op te geven tijdens de installatie.

    U kunt het bijvoorbeeld beschikbaar maken via een load balancer door --set service.type=LoadBalancer toe te voegen.

  8. Voer de volgende opdracht uit om te controleren of de gateway-pod draait. Je podnaam zal anders zijn.

    kubectl get pods
NAME                                           READY     STATUS    RESTARTS   AGE
azure-api-management-gateway-59f5fb94c-s9stz   1/1       Running   0          1m

  9. Voer de volgende 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
azure-api-management-gateway   ClusterIP   10.0.229.55     <none>        8080/TCP,8081/TCP     1m

  10. Ga terug naar de Azure-portal en controleer of het gatewayknooppunt dat u hebt geïmplementeerd, als in orde rapporteert.

Tip

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

Verwante inhoud