Nasazení brány v místním prostředí do Kubernetes pomocí Helmu

  • Článek

PLATÍ PRO: Vývojář | Premium

Helm je opensourcový nástroj pro balení, který vám pomůže nainstalovat a spravovat životní cyklus aplikací Kubernetes. Umožňuje spravovat grafy Kubernetes, což jsou balíčky předem nakonfigurovaných prostředků Kubernetes.

Tento článek obsahuje postup nasazení komponenty brány v místním prostředí služby Azure API Management do clusteru Kubernetes pomocí Nástroje Helm.

Důležité

Podpora místních imagí kontejnerů služby Azure API Management verze 0 a verze 1 končí 1. října 2023 spolu s odpovídajícím konfiguračním rozhraním API v1. Pomocí našeho průvodce migrací můžete používat místní bránu verze 2.0.0 nebo vyšší s rozhraním CONFIGURATION API v2. Další informace najdete v naší dokumentaci k vyřazení

Poznámka:

Bránu v místním prostředí můžete také nasadit do clusteru Kubernetes s podporou Azure Arc jako rozšíření clusteru.

Požadavky

  • Vytvořte cluster Kubernetes nebo získejte přístup k existujícímu clusteru.

    Tip

    Clustery s jedním uzlem dobře fungují pro účely vývoje a hodnocení. Pro produkční úlohy používejte clustery s certifikací Kubernetes Certified multi-node místně nebo v cloudu.

Přidání úložiště Helm

  1. Přidejte Azure API Management jako nové úložiště Helm.

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

  2. Aktualizujte úložiště, aby se načítá nejnovější grafy Helm.

    helm repo update

  3. Ověřte konfiguraci Helmu tak, že zobrazíte všechny dostupné grafy.

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

Nasazení brány v místním prostředí do Kubernetes

  1. V části Nasazení a infrastruktura vyberte Brány.

  2. Vyberte prostředek brány v místním prostředí, který chcete nasadit.

  3. Vyberte Nasazení.

  4. V textovém poli Token se automaticky vygeneroval nový token s použitím výchozích hodnot vypršení platnosti a tajného klíče . V případě potřeby upravte buď nebo obojí, a výběrem možnosti Generovat vytvořte nový token.

  5. Poznamenejte si token a adresu URL konfigurace.

  6. Instalace brány v místním prostředí pomocí chartu Helm

    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. Spusťte příkaz . Příkaz dává clusteru Kubernetes pokyn, aby:

    • Stáhněte si image brány v místním prostředí ze služby Microsoft Container Registry a spusťte ji jako kontejner.
    • Nakonfigurujte kontejner tak, aby zpřístupnil porty HTTP (8080) a HTTPS (8081).

    Důležité

    Ve výchozím nastavení brána používá službu ClusterIP a je přístupná pouze uvnitř clusteru. Můžete to změnit zadáním typu služby Kubernetes během instalace.

    Můžete ho například zveřejnit prostřednictvím nástroje pro vyrovnávání zatížení přidáním --set service.type=LoadBalancer

  8. Spuštěním následujícího příkazu zkontrolujte, jestli je pod brány spuštěný. Název vašeho podu se bude lišit.

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

  9. Spuštěním následujícího příkazu zkontrolujte, jestli je služba brány spuštěná. Název vaší služby a IP adresy se budou lišit.

    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. Vraťte se na web Azure Portal a ověřte, že uzel brány, který jste nasadili, hlásí stav v pořádku.

Tip

Pomocí kubectl logs <gateway-pod-name> příkazu zobrazíte snímek protokolu brány v místním prostředí.

Další kroky