Udostępnij za pośrednictwem

Wdrażanie własnej bramy na platformie Kubernetes przy użyciu programu Helm

  • Artykuł

DOTYCZY: Developer | Premium

Helm to narzędzie do tworzenia pakietów typu open source, które ułatwia instalowanie cyklu życia aplikacji Kubernetes i zarządzanie nim. Umożliwia ona zarządzanie wykresami Kubernetes, które są pakietami wstępnie skonfigurowanych zasobów Kubernetes.

Ten artykuł zawiera kroki wdrażania składnika własnej bramy usługi Azure API Management w klastrze Kubernetes przy użyciu 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

Dodawanie repozytorium Helm

  1. Dodaj usługę Azure API Management jako nowe repozytorium programu Helm.

    helm repo add azure-apim-gateway https://azure.github.io/api-management-self-hosted-gateway/helm-charts/

  2. Zaktualizuj repozytorium, aby pobrać najnowsze wykresy programu Helm.

    helm repo update

  3. Zweryfikuj konfigurację programu Helm, wyświetlając listę wszystkich dostępnych wykresów.

    $ helm search repo azure-apim-gateway
NAME                                            CHART VERSION   APP VERSION     DESCRIPTION
azure-apim-gateway/azure-api-management-gateway 1.0.0           2.0.0           A Helm chart to deploy an Azure API Management ...

Wdrażanie własnej bramy na platformie Kubernetes

  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. Zanotuj adres URL tokenu i konfiguracji

  6. Instalowanie własnej bramy przy użyciu pakietu Helm

    helm install azure-api-management-gateway \
             --set gateway.configuration.uri='<your configuration url>' \
             --set gateway.auth.key='<your token>' \
             azure-apim-gateway/azure-api-management-gateway

  7. Wykonaj polecenie . Polecenie instruuje klaster Kubernetes na:

    • Pobierz obraz własnej bramy z usługi Microsoft Container Registry i uruchom go jako kontener.
    • Skonfiguruj kontener tak, aby uwidaczniał porty HTTP (8080) i HTTPS (8081).

    Ważne

    Domyślnie brama używa usługi ClusterIP i jest uwidoczniona tylko w klastrze. Można to zmienić, określając typ usługi Kubernetes podczas instalacji.

    Możesz na przykład uwidocznić go za pomocą modułu równoważenia obciążenia, dodając --set service.type=LoadBalancer

  8. Uruchom następujące polecenie, aby sprawdzić, czy zasobnik bramy jest uruchomiony. Nazwa zasobnika będzie inna.

    kubectl get pods
NAME                                           READY     STATUS    RESTARTS   AGE
azure-api-management-gateway-59f5fb94c-s9stz   1/1       Running   0          1m

  9. Uruchom następujące 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
azure-api-management-gateway   ClusterIP   10.0.229.55     <none>        8080/TCP,8081/TCP     1m

  10. 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