Delen via

Een Azure API Management-gateway implementeren in Azure Arc (preview)

VAN TOEPASSING OP: Ontwikkelaar | Premie

Met de integratie tussen Azure API Management en Azure Arc in Kubernetes kunt u het API Management-gatewayonderdeel implementeren als een extensie in een Kubernetes-cluster met Azure Arc.

Als u de API Management-gateway implementeert op een Kubernetes-cluster met Azure Arc, wordt API Management-ondersteuning voor hybride en multicloudomgevingen uitgebreid. Schakel de implementatie in met behulp van een clusterextensie om het beheren en toepassen van beleid op uw Azure Arc-cluster een consistente ervaring te maken.

Belangrijk

API Management zelfgehoste gateway op Azure Arc is momenteel in de previewfase. Tijdens de preview is de API Management-gatewayextensie beschikbaar in de volgende regio's:

  • Azië (oost, zuidoost)
  • Australië (centraal, centraal 2, oost en zuidoost)
  • Brazilië (zuid en zuidoost)
  • Canada (Centraal, Oost)
  • Europa (noord, west)
  • Frankrijk (centraal en zuid)
  • Duitsland (Noord- en West-centraal)
  • India (Centraal, Zuid, West, Jio - centraal en Jio - west)
  • Japan (Oost en West)
  • Korea (centraal en zuid)
  • Noorwegen (Oost en West)
  • Zuid-Afrika (Noord & West)
  • Zweden (centraal)
  • Zwitserland (Noord en West)
  • Verenigde Arabische Emiraten (VAE - Centraal & Noord)
  • Verenigd Koninkrijk (VK -Zuid)
  • Verenigde Staten (VS - centraal, centraal EUAP, Oost, Oost 2, Oost 2 EUAP, Noord-centraal, Zuid-centraal, West-centraal, West, West 2, West 3)

Notitie

U kunt de zelf-hostende gateway ook rechtstreeks implementeren in Kubernetes.

Vereisten

De API Management-gatewayextensie implementeren met behulp van Azure CLI

  1. Blader in Azure Portal naar uw API Management-exemplaar.

  2. Selecteer Gateways in het navigatiemenu aan de zijkant.

  3. Selecteer en open uw geconfigureerde gatewayresource uit de lijst.

  4. Klik in uw geconfigureerde gatewayresource op Implementatie in het menu aan de linkerkant.

  5. Noteer de waarden voor het token en de configuratie-URL voor de volgende stap.

  6. Implementeer in Azure CLI de gateway-extensie met behulp van de az k8s-extension create opdracht. Vul de token- en configuration URL-waarden in.

    az k8s-extension create --cluster-type connectedClusters --cluster-name <cluster-name> \
    --resource-group <rg-name> --name <extension-name> --extension-type Microsoft.ApiManagement.Gateway \
    --scope namespace --target-namespace <namespace> \
    --configuration-settings gateway.configuration.uri='<Configuration URL>' \
    --config-protected-settings gateway.auth.token='<token>' \
    --configuration-settings service.type='LoadBalancer' --release-train preview

    Tip

    De -protected- vlag voor gateway.auth.token is optioneel, maar wordt aanbevolen.

  7. Controleer de implementatiestatus met behulp van de volgende CLI-opdracht:

    az k8s-extension show --cluster-type connectedClusters --cluster-name <cluster-name> --resource-group <rg-name> --name <extension-name>

  8. Ga terug naar de lijst Gateways om te controleren of de gatewaystatus een groen vinkje met het aantal knooppunten weergeeft. Deze status betekent dat de geïmplementeerde zelf-hostende gatewaypods:

    • Communiceren succesvol met de API Management-service.
    • Een regelmatige hartslag hebben.

De API Management-gatewayextensie implementeren met behulp van Azure Portal

  1. Navigeer in Azure Portal naar uw met Azure Arc verbonden cluster.

  2. Selecteer >>(preview).

  3. Selecteer Maken.

  4. Configureer in het Installeren venster API Management-gateway de gateway-extensie:

    • Selecteer het abonnement en de resourcegroep voor uw API Management-exemplaar.
    • In Gatewaygegevens selecteer het API Management-exemplaar en de gatewaynaam. Voer een naamruimtebereik in voor uw extensie en eventueel een aantal replica's, indien ondersteund in uw API Management-servicelaag.
    • Selecteer in de Kubernetes-configuratie de standaardconfiguratie of een andere configuratie voor uw cluster. Zie de beschikbare extensieconfiguraties voor opties.

    Schermopname van het implementeren van de extensie in Azure Portal

  5. Schakel op het tabblad Bewaking eventueel bewaking in om traceringsaanvragen voor metrische gegevens te uploaden naar de gateway en back-end. Als deze optie is ingeschakeld, selecteert u een bestaande Log Analytics-werkruimte .

  6. Selecteer Beoordeling + installeren en vervolgens Installeren.

Beschikbare extensieconfiguraties

De zelf-hostende gateway-extensie voor Azure Arc biedt veel configuratie-instellingen om de extensie voor uw omgeving aan te passen. In deze sectie vindt u de vereiste implementatie-instellingen en optionele instellingen voor integratie met Log Analytics. Raadpleeg de zelfgehoste gateway-extensie referentie voor een volledige lijst met instellingen.

Verplichte instellingen

De volgende extensieconfiguraties zijn vereist.

Instelling Beschrijving
gateway.configuration.uri Configuratie-eindpunt in API Management-service voor de zelf-hostende gateway.
gateway.auth.token Gatewaytoken (verificatiesleutel) voor verificatie bij API Management-service. Begint meestal met GatewayKey.
service.type Kubernetes-serviceconfiguratie voor de gateway: LoadBalancer, NodePortof ClusterIP.

Log Analytics-instellingen

Configureer de volgende Log Analytics-instellingen om bewaking van de zelf-hostende gateway in te schakelen:

Instelling Beschrijving
monitoring.customResourceId Resource-id van Azure Resource Manager voor het API Management-exemplaar.
monitoring.workspaceId Werkruimte-id van Log Analytics.
monitoring.ingestionKey Geheim met invoersleutel van Log Analytics.

Notitie

Als u Log Analytics niet hebt ingeschakeld:

  1. Doorloop de snelstartgids Een Log Analytics-werkruimte maken.
  2. Informatie over waar u de instellingen van de Log Analytics-agent kunt vinden.

Verwante inhoud