Dela via

Distribuera en lokalt installerad gateway till Kubernetes med Helm

  • Artikel

GÄLLER FÖR: Utvecklare | Premium

Helm är ett paketeringsverktyg med öppen källkod som hjälper dig att installera och hantera livscykeln för Kubernetes-program. Det gör att du kan hantera Kubernetes-diagram, som är paket med förkonfigurerade Kubernetes-resurser.

Den här artikeln innehåller stegen för att distribuera en lokalt installerad gatewaykomponent i Azure API Management till ett Kubernetes-kluster med hjälp av Helm.

Viktigt!

Stöd för azure API Management med egen värdbaserad gateway version 0 och version 1-containeravbildningar upphör den 1 oktober 2023, tillsammans med motsvarande Konfigurations-API v1. Använd vår migreringsguide för att använda lokalt installerad gateway v2.0.0 eller senare med Configuration API v2. Läs mer i vår utfasningsdokumentation

Kommentar

Du kan också distribuera en lokalt installerad gateway till ett Azure Arc-aktiverat Kubernetes-kluster som ett klustertillägg.

Förutsättningar

  • Skapa ett Kubernetes-kluster eller ha åtkomst till ett befintligt.

    Dricks

    Kluster med en nod fungerar bra i utvecklings- och utvärderingssyfte. Använd Kubernetes-certifierade kluster med flera noder lokalt eller i molnet för produktionsarbetsbelastningar.

Lägga till Helm-lagringsplatsen

  1. Lägg till Azure API Management som en ny Helm-lagringsplats.

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

  2. Uppdatera lagringsplatsen för att hämta de senaste Helm-diagrammen.

    helm repo update

  3. Verifiera Helm-konfigurationen genom att visa alla tillgängliga diagram.

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

Distribuera den lokalt installerade gatewayen till Kubernetes

  1. Välj Gatewayer från under Distribution och infrastruktur.

  2. Välj den gatewayresurs med egen värd som du tänker distribuera.

  3. Välj Distribution.

  4. En ny token i textrutan Token genererades automatiskt med standardvärdena Förfallodatum och Hemlig nyckel . Justera antingen eller båda om du vill och välj Generera för att skapa en ny token.

  5. Anteckna din token - och konfigurations-URL

  6. Installera den lokalt installerade gatewayen med hjälp av Helm-diagrammet

    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. Kör kommandot. Kommandot instruerar kubernetes-klustret att:

    • Ladda ned avbildningen av den lokalt installerade gatewayen från Microsoft Container Registry och kör den som en container.
    • Konfigurera containern så att den exponerar HTTP-portar (8080) och HTTPS -portar (8081).

    Viktigt!

    Som standard använder gatewayen en ClusterIP-tjänst och exponeras endast i klustret. Du kan ändra detta genom att ange typen av Kubernetes-tjänst under installationen.

    Du kan till exempel exponera den via en lastbalanserare genom att lägga till --set service.type=LoadBalancer

  8. Kör följande kommando för att kontrollera att gateway-podden körs. Poddens namn kommer att vara annorlunda.

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

  9. Kör följande kommando för att kontrollera att gatewaytjänsten körs. Tjänstnamnet och IP-adresserna skiljer sig åt.

    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. Gå tillbaka till Azure-portalen och bekräfta att gatewaynoden som du distribuerade rapporterar felfri status.

Dricks

Använd kubectl logs <gateway-pod-name> kommandot för att visa en ögonblicksbild av gatewayloggen med egen värd.

Nästa steg