Freigeben über

Bereitstellen eines selbst gehosteten Gateways für Kubernetes mithilfe von Helm

Gilt für: Entwickler | Premium

Helm ist ein Open Source-Verpackungstool, das Ihnen dabei hilft, Kubernetes-Anwendungen zu installieren und ihren Lebenszyklus zu verwalten. Mit Helm können Sie Kubernetes-Charts verwalten, bei denen es sich um Pakete von vorkonfigurierten Kubernetes-Ressourcen handelt.

In diesem Artikel wird erläutert, wie Sie mithilfe von Helm eine selbst gehostete Gatewaykomponente von Azure API Management auf einem Kubernetes-Cluster bereitstellen.

Hinweis

Sie können ein selbst gehostetes Gateway auch als Clustererweiterung in einem Azure Arc-fähigen Kubernetes-Cluster bereitstellen.

Voraussetzungen

  • Erstellen Sie einen Azure Kubernetes-Cluster, oder haben Sie Zugriff auf einen vorhandenen Cluster.

    Tipp

    Cluster mit einem einzelnen Knoten eignen sich gut für Entwicklungs- und Evaluierungszwecke. Verwenden Sie für Produktionsworkloads einen für Kubernetes zertifizierten Cluster mit mehreren Knoten, entweder lokal oder in der Cloud.

Fügen Sie das Helm-Repository hinzu.

  1. Fügen Sie Azure API Management als neues Helm-Repository hinzu, indem Sie den folgenden Befehl verwenden.

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

  2. Aktualisieren Sie das Repository, um die neuesten Helmdiagramme abzurufen.

    helm repo update

  3. Überprüfen Sie Ihre Helm-Konfiguration, indem Sie alle verfügbaren Diagramme auflisten.

    helm search repo azure-apim-gateway

    Das folgende Beispiel zeigt die verfügbaren Diagramme.

    NAME                                            CHART VERSION   APP VERSION     DESCRIPTION
azure-apim-gateway/azure-api-management-gateway 1.15.0           2.11.0           A Helm chart to deploy an Azure API Management ...

Stellen Sie das selbstgehostete Gateway in Kubernetes bereit

Tipp

Mit den folgenden Schritte wird das selbstgehostete Gateway in Kubernetes bereitgestellt und die Authentifizierung bei der API Management-Instanz mithilfe eines Gatewayzugriffstokens (Authentifizierungsschlüssel) ermöglicht. Sie können das selbst gehostete Gateway auch für Kubernetes bereitstellen und die Authentifizierung für die API-Verwaltungsinstanz mithilfe der Microsoft Entra-ID aktivieren. Weitere Informationen finden Sie unter Selbst gehostete Gateway-Authentifizierungsoptionen.

  1. Navigieren Sie im Azure-Portal zu Ihrer API-Verwaltungsinstanz.

  2. Wählen Sie unter "Bereitstellung und Infrastruktur " im Menü "Randleiste" die Option "Selbst gehostete Gateways" aus.

  3. Wählen Sie die selbstgehostete Gatewayressource aus, die Sie bereitstellen möchten.

  4. Wählen Sie Bereitstellung aus.

  5. Im Textfeld Token wurde automatisch ein neues Token mit den Standardwerten Ablaufdatum und Schlüssel generiert. Passen Sie bei Bedarf eine oder beides an, und wählen Sie "Generieren " aus, um ein neues Token zu erstellen.

  6. Notieren Sie sich Ihre Token- und Konfigurations-URL.

  7. Installieren Sie das selbst gehostete Gateway mithilfe des Helm-Diagramms.

    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

  8. Führen Sie den Befehl aus. Mit dem Befehl wird ihr Kubernetes-Cluster angewiesen, Folgendes auszuführen:

    • Herunterladen des Image des selbstgehosteten Gateways aus der Microsoft Container Registry und Ausführen als Container.
    • Konfigurieren des Containers, sodass die Ports HTTP (8080) und HTTPS (8081) verfügbar sind.

    Wichtig

    Standardmäßig verwendet das Gateway einen ClusterIP-Dienst und wird nur innerhalb des Clusters verfügbar gemacht. Sie können dies ändern, indem Sie den Typ des Kubernetes-Dienstes während der Installation angeben.

    Sie können es beispielsweise über einen Load Balancer verfügbar machen, indem Sie --set service.type=LoadBalancer hinzufügen

Verwandte Inhalte

  • Last updated on