Wdrażenie bramy hostowanej samodzielnie dla usługi Azure API Management do Azure Kubernetes Service

DOTYCZY: Developer | Premium

Ten artykuł zawiera kroki wdrażania składnika samodzielnie hostowanej bramy usługi Azure API Management w usłudze Azure Kubernetes Service (AKS). Aby wdrożyć własną bramę w klastrze Kubernetes, zobacz artykuł z instrukcjami dotyczącymi wdrażania przy użyciu pliku YAML wdrożenia lub programu Helm.

Uwaga

Bramę wdrożoną samodzielnie można również wdrożyć w klastrze Kubernetes z włączoną usługą Azure Arc jako rozszerzenie klastra.

Wymagania wstępne

• Utwórz wystąpienie usługi Azure API Management
• Utwórz klaster usługi Azure Kubernetes przy użyciu interfejsu wiersza polecenia platformy Azure, programu Azure PowerShell lub witryny Azure Portal.
• Utwórz zasób bramy w Twoim wystąpieniu usługi API Management.

Uruchomienie bramy hostowanej lokalnie w usłudze AKS

1. Wybierz pozycję Bramy z obszaru Wdrażanie i infrastruktura.

2. Wybierz zasób bramy hostowanej samodzielnie, który chcesz wdrożyć.

3. Wybierz pozycję Wdrożenie.

4. Nowy token w polu tekstowym Token został automatycznie wygenerowany przy użyciu domyślnych wartości terminu wygaśnięcia i klucza sekretnego. Dostosuj jedną lub obie te wartości, a następnie wybierz pozycję Generuj , aby utworzyć nowy token.

5. Upewnij się, że w obszarze Skrypty wdrażania wybrano pozycję Kubernetes.

6. Wybierz link pliku <gateway-name>.yml znajdujący się obok pozycji Wdrożenie, aby pobrać plik.

7. Dostosuj config.service.endpoint, mapowania portów i nazwę kontenera w pliku .yml zgodnie z potrzebami.

8. W zależności od scenariusza może być konieczna zmiana typu usługi.

   • Wartość domyślna to LoadBalancer, czyli zewnętrzny moduł równoważenia obciążenia.
   • Możesz użyć wewnętrznego modułu równoważenia obciążenia, aby ograniczyć dostęp do własnej bramy tylko użytkownikom wewnętrznym.
   • W poniższym przykładzie użyto metody NodePort.

9. Wybierz ikonę kopiuj znajdującą się po prawej stronie pola tekstu Wdróż, aby zapisać kubectl polecenie do schowka.

10. Wklej polecenie do okna terminala (lub polecenia). Polecenie oczekuje, że pobrany plik środowiska będzie obecny w bieżącym katalogu.

    kubectl apply -f <gateway-name>.yaml
    

11. Wykonaj polecenie . Polecenie nakazuje klasterowi AKS, aby:

    • Uruchom kontener przy użyciu obrazu bramy samohostowanej pobranego z rejestru kontenerów firmy Microsoft.
    • Skonfiguruj kontener tak, aby uwidaczniał porty HTTP (8080) i HTTPS (443).

12. Uruchom następujące polecenie, aby sprawdzić, czy pod bramy jest uruchomiony. Ta nazwa podu jest przykładem.

    kubectl get pods
    NAME                                   READY     STATUS    RESTARTS   AGE
    contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m
    

13. Uruchom następujące polecenie, aby sprawdzić, czy usługa bramy jest uruchomiona. Nazwa usługi i adresy IP to przykłady.

    kubectl get services
    NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
    contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m
    

14. Wróć do witryny Azure Portal i upewnij się, że wdrożony węzeł bramy zgłasza stan dobrej kondycji.

Napiwek

Użyj polecenia , kubectl logs <gateway-pod-name> aby wyświetlić migawkę dziennika bramy hostowanej samodzielnie.

Powiązana zawartość

• Aby dowiedzieć się więcej na temat bramy hostowanej samodzielnie, zobacz Omówienie bramy hostowanej samodzielnie w usłudze Azure API Management.
• Dowiedz się, jak wdrożyć samodzielnie hostowaną bramę usługi API Management do klastrów Kubernetes z obsługą usługi Azure Arc.
• Dowiedz się więcej o możliwościach obserwacji bram usługi Azure API Management.
• Dowiedz się więcej na temat wskazówek dotyczących uruchamiania własnej bramy na platformie Kubernetes w środowisku produkcyjnym.
• Dowiedz się więcej o usłudze Azure Kubernetes Service.