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

DOTYCZY: Developer | Premium

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

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

• Wykonaj procedury przedstawione w następującym przewodniku 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 klastrów z wieloma węzłami platformy Kubernetes w środowisku lokalnym lub w chmurze na potrzeby obciążeń produkcyjnych.

• Aprowizuj zasób własnej bramy 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ę 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".

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

• Aby dowiedzieć się więcej na temat własnej bramy, zobacz Omówienie własnej bramy.
• Dowiedz się , jak wdrożyć własną bramę 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.