Saját üzemeltetésű átjáró üzembe helyezése a Kubernetesben a YAML használatával

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Prémium

Ez a cikk az Azure API Management saját üzemeltetésű átjáró összetevőjének Kubernetes-fürtön való üzembe helyezésének lépéseit ismerteti.

Fontos

Az Azure API Management saját üzemeltetésű átjáró 0-s és 1-es verziójú tárolórendszerképeinek támogatása 2023. október 1-jén megszűnik, a hozzá tartozó Configuration API 1-es verziójával együtt. A migrálási útmutatónk segítségével a Configuration API 2-es verziójával használhatja a saját üzemeltetésű átjáró 2.0.0-s vagy újabb verzióját. További információ az elavulással kapcsolatos dokumentációnkban

Feljegyzés

Saját üzemeltetésű átjárót is üzembe helyezhet egy Azure Arc-kompatibilis Kubernetes-fürtön fürtbővítményként.

Előfeltételek

• Tekintse át a következő rövid útmutatót: Azure API Management-példány létrehozása.
• Hozzon létre egy Kubernetes-fürtöt, vagy rendelkezzen hozzáféréssel egy meglévőhöz.

  Tipp.

  Az egycsomópontos fürtök jól működnek fejlesztési és értékelési célokra. A Kubernetes minősített többcsomópontos fürtöit a helyszínen vagy a felhőben használhatja éles számítási feladatokhoz.

• Saját üzemeltetésű átjáróerőforrás kiépítése az API Management-példányban.

Üzembe helyezés a Kubernetesben

Tipp.

Az alábbi lépésekben üzembe helyezi a saját üzemeltetésű átjárót a Kubernetesben, és engedélyezi a hitelesítést az API Management-példányon átjáró-hozzáférési jogkivonat (hitelesítési kulcs) használatával. A saját üzemeltetésű átjárót a Kubernetesben is üzembe helyezheti, és a Microsoft Entra ID használatával engedélyezheti a hitelesítést az API Management-példányon.

1. Válassza az Átjárók lehetőséget az Üzembe helyezés és az infrastruktúra területen.
2. Válassza ki az üzembe helyezni kívánt saját üzemeltetésű átjáróerőforrást.
3. Válassza az Üzembe helyezés lehetőséget.
4. A jogkivonat szövegmezőjében automatikusan létrejött egy hozzáférési jogkivonat az alapértelmezett lejárati és titkos kulcsértékek alapján. Ha szükséges, válasszon értékeket bármelyik vagy mindkét vezérlőben egy új jogkivonat létrehozásához.
5. Válassza a Kubernetes lapot az Üzembehelyezési szkriptek csoportban.
6. Válassza ki az <átjárónév>.yml fájlhivatkozást, és töltse le a YAML-fájlt.
7. A parancsok vágólapra mentéséhez kubectl válassza a Másolás ikont a Központi telepítés szövegmező jobb alsó sarkában.
8. Az Azure Kubernetes Service (AKS) használatakor futtassa az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin egy új terminál munkamenetben.
9. A parancsok futtatásával hozza létre a szükséges Kubernetes-objektumokat az alapértelmezett névtérben, és indítsa el a saját üzemeltetésű átjáró podjait a Microsoft Eszközjegyzék letöltött tárolórendszerképből.
   • Az első lépés létrehoz egy Kubernetes-titkos kulcsot, amely tartalmazza a 4. lépésben létrehozott hozzáférési jogkivonatot. Ezután létrehoz egy Kubernetes-üzembe helyezést a saját üzemeltetésű átjáróhoz, amely egy ConfigMap-et használ az átjáró konfigurációjával.

Ellenőrizze, hogy az átjáró fut-e

1. Futtassa a következő parancsot annak ellenőrzéséhez, hogy az üzembe helyezés sikeres volt-e. Az összes objektum létrehozása és a podok inicializálása eltarthat egy kis ideig.

   kubectl get deployments
   

   Vissza kell térnie

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

2. Futtassa a következő parancsot annak ellenőrzéséhez, hogy a szolgáltatások sikeresen létrejöttek-e. A szolgáltatás IP-címei és portja eltérő lesz.

   kubectl get services
   

   Vissza kell térnie

   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. Lépjen vissza az Azure Portalra, és válassza az Áttekintés lehetőséget.

4. Győződjön meg arról, hogy az Állapot zöld pipát, majd egy csomópontszámot jelenít meg, amely megfelel a YAML-fájlban megadott replikák számának. Ez az állapot azt jelenti, hogy az üzembe helyezett, saját üzemeltetésű átjáró podok sikeresen kommunikálnak az API Management szolgáltatással, és rendszeres "szívveréssel" rendelkeznek.

Tipp.

• Futtassa a kubectl logs deployment/<gateway-name> parancsot egy véletlenszerűen kiválasztott pod naplóinak megtekintéséhez, ha több van.
• Futtassa kubectl logs -h a parancsbeállítások teljes készletét, például egy adott pod vagy tároló naplóinak megtekintését.

Következő lépések

• A saját üzemeltetésű átjáróval kapcsolatos további információkért tekintse meg a saját üzemeltetésű átjáró áttekintését.
• Megtudhatja , hogyan helyezhet üzembe saját üzemeltetésű API Management-átjárót az Azure Arc-kompatibilis Kubernetes-fürtökön.
• További információ a saját üzemeltetésű átjáró éles Kubernetesen való futtatásáról.