Udostępnij za pośrednictwem

Wdrażanie własnej bramy na platformie Kubernetes przy użyciu języka YAML

  • Artykuł

DOTYCZY: Developer | Premia

W tym artykule opisano kroki wdrażania składnika własnej bramy usługi Azure API Management w klastrze Kubernetes.

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 na platformie Kubernetes

Napiwek

Poniższe kroki umożliwiają wdrożenie własnej bramy na platformie Kubernetes i włączenie uwierzytelniania w wystąpieniu usługi API Management przy użyciu tokenu dostępu bramy (klucza uwierzytelniania). Możesz również wdrożyć bramę hostowaną samodzielnie na platformie Kubernetes i włączyć uwierzytelnianie w wystąpieniu usługi API Management przy użyciu identyfikatora Entra firmy Microsoft.

  1. Wybierz pozycję Bramy w obszarze Wdrażanie i infrastruktura.
  2. Wybierz zasób własnej bramy, który chcesz wdrożyć.
  3. Wybierz pozycję Wdrożenie.
  4. Token dostępu w polu tekstowym Token został wygenerowany automatycznie na podstawie domyślnych wartości klucza wygasania i klucza tajnego . W razie potrzeby wybierz wartości w obu kontrolkach, aby wygenerować nowy token.
  5. Wybierz kartę Kubernetes w obszarze Skrypty wdrażania.
  6. <Wybierz link gateway-name>.yml plik i pobierz plik YAML.
  7. Wybierz ikonę kopiowania w prawym dolnym rogu pola tekstowego Wdróż, aby zapisać kubectl polecenia w schowku.
  8. W przypadku korzystania z usługi Azure Kubernetes Service (AKS) uruchom polecenie az aks get-credentials --resource-group <resource-group-name> --name <resource-name> --admin w nowej sesji terminalu.
  9. Uruchom polecenia , aby utworzyć niezbędne obiekty Kubernetes w domyślnej przestrzeni nazw i uruchomić zasobniki bramy hostowanej samodzielnie z obrazu kontenera pobranego z Rejestr Artefaktów Microsoft.
    • Pierwszy krok tworzy wpis tajny kubernetes zawierający token dostępu wygenerowany w kroku 4. Następnie tworzy wdrożenie platformy Kubernetes dla własnej bramy, która używa obiektu ConfigMap z konfiguracją bramy.

Upewnij się, że brama jest uruchomiona

  1. Uruchom następujące polecenie, aby sprawdzić, czy wdrożenie zakończyło się pomyślnie. Utworzenie wszystkich obiektów i zainicjowanie zasobników może zająć trochę czasu.

    kubectl get deployments

    Powinna zostać zwrócona

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

  2. Uruchom następujące polecenie, aby sprawdzić, czy usługi zostały pomyślnie utworzone. Adresy IP i porty usługi będą inne.

    kubectl get services

    Powinna zostać zwrócona

    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. Wróć do witryny Azure Portal i wybierz pozycję Przegląd.

  4. Upewnij się, że stan zawiera zielony znacznik wyboru, a następnie liczbę węzłów zgodną z liczbą replik określonych w pliku YAML. Ten stan oznacza, że wdrożone zasobniki własnej bramy pomyślnie komunikują się z usługą API Management i mają zwykły "puls". Zrzut ekranu przedstawiający stan własnej bramy w portalu.

Napiwek

  • Uruchom polecenie , kubectl logs deployment/<gateway-name> aby wyświetlić dzienniki z losowo wybranego zasobnika, jeśli istnieje więcej niż jeden.
  • Uruchom polecenie kubectl logs -h , aby uzyskać pełny zestaw opcji poleceń, takich jak wyświetlanie dzienników dla określonego zasobnika lub kontenera.

Następne kroki