Delen via

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

  • Artikel

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 zelf-hostende gateway in Azure Arc is momenteel in preview. 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, EUAP - oost 2, Noord-centraal, Zuid-centraal, West-centraal, 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 ingerichte gatewayresource in de lijst.

  4. Klik in de ingerichte gatewayresource op Implementatie in het navigatiemenu aan de zijkant.

  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 waarden in configuration URL .

    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

    -protected- vlag is gateway.auth.token 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:

    • Communiceert met de API Management-service.
    • Een gewone 'heartbeat' 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 in het linkermenu Extensies>+ API Management-gateway toevoegen>(preview).

  3. Selecteer Maken.

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

    • Selecteer het abonnement en de resourcegroep voor uw API Management-exemplaar.
    • Selecteer in Gatewaygegevens de naam van 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 Controleren en 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. Zie de verwijzing naar de zelf-hostende gateway-extensie 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 opnamesleutel uit Log Analytics.

Notitie

Als u Log Analytics niet hebt ingeschakeld:

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

Volgende stappen