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

PLATÍ PRO: Vývojář | Prémie

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

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

• Projděte si následující rychlý start: Vytvoření instance Azure API Managementu.
• 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.

• Zřízení prostředku brány v místním prostředí v instanci služby API Management

Nasazení do Kubernetes

Tip

Následující kroky nasadí bránu v místním prostředí do Kubernetes a povolí ověřování do instance služby API Management pomocí přístupového tokenu brány (ověřovacího klíče). Bránu v místním prostředí můžete také nasadit do Kubernetes a povolit ověřování do instance služby API Management pomocí ID Microsoft Entra.

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. Přístupový token v textovém poli Token se automaticky vygeneroval na základě výchozích hodnot klíčů s vypršenou platností a tajnými klíči. V případě potřeby zvolte hodnoty v obou ovládacích prvcích a vygenerujte nový token.
5. V části Skripty nasazení vyberte kartu Kubernetes.
6. <Vyberte odkaz na soubor> brány.yml a stáhněte soubor YAML.
7. Výběrem ikony kopírování v pravém dolním rohu textového pole Deploy (Nasadit) uložte kubectl příkazy do schránky.
8. Při použití služby Azure Kubernetes Service (AKS) spusťte az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin v nové relaci terminálu.
9. Spuštěním příkazů vytvořte potřebné objekty Kubernetes ve výchozím oboru názvů a spusťte pody brány v místním prostředí z image kontejneru stažené z Registr artefaktů Microsoft.
   • První krok vytvoří tajný klíč Kubernetes, který obsahuje přístupový token vygenerovaný v kroku 4. Dále vytvoří nasazení Kubernetes pro bránu v místním prostředí, která používá ConfigMap s konfigurací brány.

Ověřte, že je brána spuštěná.

1. Spuštěním následujícího příkazu zkontrolujte, jestli nasazení proběhlo úspěšně. Vytvoření všech objektů a inicializace podů může chvíli trvat.

   kubectl get deployments
   

   Měla by se vrátit.

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

2. Spuštěním následujícího příkazu zkontrolujte, jestli se služby úspěšně vytvořily. IP adresy a porty vaší služby se budou lišit.

   kubectl get services
   

   Měla by se vrátit.

   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. Vraťte se na web Azure Portal a vyberte Přehled.

4. Ověřte, že stav zobrazuje zelenou značku zaškrtnutí a za ním počet uzlů, který odpovídá počtu replik zadaných v souboru YAML. Tento stav znamená, že nasazené pody brány v místním prostředí úspěšně komunikují se službou API Management a mají běžný prezenční signál.

Tip

• Spuštěním kubectl logs deployment/<gateway-name> příkazu zobrazte protokoly z náhodně vybraného podu, pokud existuje více než jeden.
• Spusťte kubectl logs -h úplnou sadu možností příkazů, jako je například zobrazení protokolů pro konkrétní pod nebo kontejner.

Další kroky

• Další informace o bráně v místním prostředí najdete v přehledu brány v místním prostředí.
• Zjistěte , jak nasadit bránu služby API Management v místním prostředí do clusterů Kubernetes s podporou Služby Azure Arc.
• Přečtěte si další informace o pokynech pro spuštění brány v místním prostředí v kubernetes v produkčním prostředí.