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

Artikel
10/09/2021
3 minuten om te lezen

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

Als u de API Management-gateway implementeert op een kubernetes-cluster met Azure Arc-ondersteuning voor API Management hybride omgevingen en omgevingen met meerdere cloudomgevingen. Schakel de implementatie in met behulp van een clusterextensie om het beheren en toepassen van beleidsregels op Azure Arc cluster met ingeschakelde cluster een consistente ervaring te maken.

Belangrijk

API Management zelf-hostende gateway op Azure Arc is momenteel in preview.

Notitie

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

Vereisten

Verbinding maken Kubernetes-cluster binnen een ondersteunde Azure Arc regio.
Installeer de k8s-extension Azure CLI-extensie:
```
az extension add --name k8s-extension
```
Als u de module al hebt k8s-extension geïnstalleerd, moet u bijwerken naar de nieuwste versie:
```
az extension update --name k8s-extension
```
Een Azure API Management-exemplaar maken.
Een gatewayresource inrichten in uw Azure API Management-exemplaar.

De gateway-API Management implementeren met behulp van Azure CLI

Blader in het Azure-portaal naar uw API Management-exemplaar.
Selecteer Gateways in het navigatiemenu aan de zijkant.
Selecteer en open de inrichtende gatewayresource in de lijst.
Klik in de inrichtende gatewayresource op Implementatie in het navigatiemenu aan de zijkant.
Noteer de waarden voor Token en Configuratie-URL voor de volgende stap.

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

In het volgende voorbeeld wordt de service.type='LoadBalancer' extensieconfiguratie gebruikt. Zie meer beschikbare extensieconfiguraties.

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.endpoint='<Configuration URL>' \
  --configuration-protected-settings gateway.authKey='<token>' \
  --configuration-settings service.type='LoadBalancer' --release-train preview

Tip

-protected- vlag voor authKey is optioneel, maar wordt aanbevolen.

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>

Ga terug naar de lijst Gateways om te controleren of de gatewaystatus een groen vinkje met een aantal knooppunt bevat. Deze status betekent dat de geïmplementeerde zelf-hostende gatewaypods:
- Communiceren met de API Management service.
- Een normale 'heartbeat' hebben.

De gateway-API Management implementeren met behulp van Azure Portal

Navigeer Azure Portal naar uw Azure Arc verbonden cluster.
Selecteer in het menu links Extensies (preview) > + API Management gateway toevoegen > (preview).
Selecteer Maken.
Configureer in het API Management gateway installeren de gatewayextensie:
- Selecteer het abonnement en de resourcegroep voor uw API Management exemplaar.
- Selecteer in Gatewaydetails het API Management en gatewaynaam. Voer een naamruimtebereik in voor uw extensie en eventueel een aantal replica's, indien ondersteund in API Management servicelaag.
- Selecteer in Kubernetes-configuratie de standaardconfiguratie of een andere configuratie voor uw cluster. Zie beschikbare extensieconfiguraties voor opties.
Schakel op het tabblad Bewaking eventueel bewaking in om traceringsaanvragen voor metrische gegevens te uploaden naar de gateway en de back-up. Als deze optie is ingeschakeld, selecteert u een bestaande Log Analytics-werkruimte.
Selecteer Controleren en installeren en vervolgens Installeren.

Beschikbare extensieconfiguraties

De volgende extensieconfiguraties zijn vereist.

Instelling	Beschrijving
`gateway.endpoint`	De configuratie-URL van het gateway-eindpunt.
`gateway.authKey`	Token voor toegang tot de gateway.
`service.type`	Kubernetes-serviceconfiguratie voor de gateway: `LoadBalancer` `NodePort` , of `ClusterIP` .

Log Analytics-instellingen

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

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