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

DOTYCZY: Developer | Premium

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

Uwaga

Bramę hostowaną samodzielnie można również wdrożyć w klastrze Azure Arc-enabled Kubernetes jako rozszerzenie klastra.

Wymagania wstępne

• Wykonaj poniższy Szybki Start: Tworzenie wystąpienia usługi Azure API Management.

• Utwórz klaster Kubernetes lub uzyskaj dostęp do istniejącego klastra.

  Napiwek

  Klastry z jednym węzłem działają dobrze w celach programistycznych i ewaluacyjnych. Użyj certyfikowanych przez Kubernetes klastrów wielowęzłowych lokalnie lub w chmurze na potrzeby obciążeń produkcyjnych.

• Przygotuj zasób bramy samodzielnie hostowanej w wystąpieniu usługi API Management.

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ę własną hostowaną na platformie Kubernetes i w wystąpieniu usługi API Management włączyć uwierzytelnianie przy użyciu Microsoft Entra ID.

1. Wybierz pozycję Bramy w obszarze Wdrażanie i infrastruktura.
2. Wybierz zasób bramy samodzielnie hostowanej, który chcesz wdrożyć.
3. Wybierz pozycję Wdrożenie.
4. W polu tekstowym Token został automatycznie wygenerowany token dostępu na podstawie domyślnych wartości wygasania i klucza tajnego. W razie potrzeby wybierz wartości w obu kontrolkach, aby wygenerować nowy token.
5. Wybierz zakładkę Kubernetes w Skrypty wdrażania.
6. Wybierz link do pliku <gateway-name>.yml 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 samoobsługowej z obrazu kontenera pobranego z Rejestru Artefaktów Microsoft.
   • Pierwszy krok tworzy tajemnicę Kubernetes zawierającą token dostępu wygenerowany w kroku 4. Następnie tworzy wdrożenie w Kubernetes dla bramy samodzielnie hostowanej, która wykorzystuje obiekt ConfigMap zawierający 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. Tworzenie wszystkich obiektów i inicjalizacja 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 Status pokazuje zielony znacznik wyboru, a następnie liczba węzłów jest zgodna z liczbą replik określonych w pliku YAML. Ten stan oznacza, że wdrożone zasobniki własnego, hostowanego lokalnie, gatewaya pomyślnie komunikują się z usługą API Management i mają regularne "heartbeat".

Napiwek

• Uruchom polecenie kubectl logs deployment/<gateway-name>, aby wyświetlić dzienniki z losowo wybranego zasobnika, gdy 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.

Powiązana zawartość

• Aby dowiedzieć się więcej na temat bramy hostowanej lokalnie, zobacz Omówienie bramy hostowanej lokalnie.
• Dowiedz się , jak wdrożyć bramę wdrażaną na własnym serwerze usługi API Management w klastrach Kubernetes z obsługą usługi Azure Arc.
• Dowiedz się więcej na temat wskazówek dotyczących uruchamiania własnej bramy na platformie Kubernetes w środowisku produkcyjnym.