Share via

Wdrażanie własnej bramy usługi Azure API Management w usłudze Azure Kubernetes Service

  • Artykuł

DOTYCZY: Developer | Premium

Ten artykuł zawiera kroki wdrażania składnika własnej bramy usługi Azure API Management w usłudze Azure Kubernetes Service. 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.

Ważne

Obsługa samoobsługowej bramy usługi Azure API Management w wersji 0 i wersji 1 obrazów kontenerów kończy się 1 października 2023 r. wraz z odpowiednim interfejsem API konfiguracji w wersji 1. Skorzystaj z naszego przewodnika migracji , aby użyć własnej bramy w wersji 2.0.0 lub nowszej z interfejsem API konfiguracji w wersji 2. Dowiedz się więcej w naszej dokumentacji dotyczącej wycofywania

Uwaga

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

Wymagania wstępne

Wdrażanie własnej bramy w usłudze AKS

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

  2. Wybierz zasób własnej bramy, 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 Wygasanie i Klucz tajny. 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 gateway-name>.yml file (Nazwa bramy.yml obok pozycji Wdrożenie , aby pobrać plik.

  7. config.service.endpointDostosuj wartości , 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ę kopiowania znajdującą się po prawej stronie pola tekstowego Wdróż, aby zapisać kubectl polecenie w schowku.

  10. Wklej polecenie do okna terminalu (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 instruuje klaster usługi AKS, aby:

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

  12. Uruchom poniższe polecenie, aby sprawdzić, czy zasobnik bramy jest uruchomiony. Nazwa zasobnika będzie inna.

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

  13. Uruchom poniższe polecenie, aby sprawdzić, czy usługa bramy jest uruchomiona. Nazwa usługi i adresy IP będą inne.

    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 kubectl logs <gateway-pod-name> polecenia , aby wyświetlić migawkę własnego dziennika bramy.

Następne kroki