Distribuera en Azure API Management-gateway Azure Arc (förhandsversion)

Artikel
10/09/2021
2 minuter för att läsa

Med integreringen mellan Azure API Management och Azure Arc på Kuberneteskan du distribuera API Management-gatewaykomponenten som ett tillägg i ett Azure Arc-aktiverat Kubernetes-kluster.

När du distribuerar API Management-gatewayen på Azure Arc-aktiverat Kubernetes-kluster API Management stöd för hybridmiljöer och miljöer med flera moln. Aktivera distributionen med hjälp av ett klustertillägg för att göra hanteringen och tillämpningen av Azure Arc-aktiverade klustret till en konsekvent upplevelse.

Viktigt

API Management gateway med egen värd på Azure Arc är för närvarande i förhandsversion.

Anteckning

Du kan också distribuera gatewayen med egen värd direkt till Kubernetes.

Förutsättningar

Anslut Kubernetes-klustret inom en Azure Arc region.
Installera k8s-extension Azure CLI-tillägget:
```
az extension add --name k8s-extension
```
Om du redan har installerat modulen k8s-extension uppdaterar du till den senaste versionen:
```
az extension update --name k8s-extension
```
Skapa en Azure API Management-instans.
Etablera en gatewayresurs i din Azure API Management instans.

Distribuera API Management gateway-tillägget med Hjälp av Azure CLI

I Azure Portal navigerar du till din API Management instans.
Välj Gatewayer på navigeringsmenyn på sidan.
Välj och öppna din etablerade gatewayresurs i listan.
I den etablerade gatewayresursen klickar du på Distribution på navigeringsmenyn på sidan.
Anteckna värdena för Token och Konfigurations-URL för nästa steg.

I Azure CLI distribuerar du gatewaytillägget med az k8s-extension create kommandot . Fyll i värdena token configuration URL och .

I följande exempel används service.type='LoadBalancer' tilläggskonfigurationen. Se fler tillgängliga tilläggskonfigurationer.

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

Tips

-protected- flaggan för authKey är valfri, men rekommenderas.

Kontrollera distributionsstatus med hjälp av följande CLI-kommando:

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

Gå tillbaka till listan Gatewayer för att kontrollera att gatewaystatusen visar en grön bock med antalet noder. Den här statusen innebär att de distribuerade gateway-poddarna med egen värd:
- Kommunicerar med API Management tjänsten.
- Ha ett vanligt "pulsslag".

Distribuera API Management gateway-tillägget med Azure Portal

I Azure Portal du till det Azure Arc anslutna klustret.
I den vänstra menyn väljer du Tillägg (förhandsversion) > + Lägg till API Management gateway > (förhandsversion).
Välj Skapa.
I fönstret Installera API Management gateway konfigurerar du gatewaytillägget:
- Välj prenumerationen och resursgruppen för din API Management instans.
- I Gatewayinformation väljer du API Management instans och Gatewaynamn. Ange ett namnområdesomfång för tillägget och eventuellt ett antal repliker om det stöds API Management tjänstnivån.
- I Kubernetes-konfigurationen väljer du standardkonfigurationen eller en annan konfiguration för klustret. Alternativ finns i tillgängliga tilläggskonfigurationer.
På fliken Övervakning kan du välja att aktivera övervakning för att ladda upp måttspårningsbegäranden till gatewayen och backend. Om aktiverad väljer du en befintlig Log Analytics-arbetsyta.
Välj Granska + installera och sedan Installera.

Tillgängliga tilläggskonfigurationer

Följande tilläggskonfigurationer krävs.

Inställning	Beskrivning
`gateway.endpoint`	Gatewayslutpunktens konfigurations-URL.
`gateway.authKey`	Token för åtkomst till gatewayen.
`service.type`	Kubernetes-tjänstkonfiguration för gatewayen: `LoadBalancer` `NodePort` , eller `ClusterIP` .

Log Analytics-inställningar

Konfigurera följande Log Analytics-inställningar för att aktivera övervakning av gatewayen med egen värd:

Inställning	Beskrivning
`monitoring.customResourceId`	Azure Resource Manager resurs-ID för API Management instansen.
`monitoring.workspaceId`	Arbetsyte-ID för Log Analytics.
`monitoring.ingestionKey`	Hemlighet med inmatningsnyckel från Log Analytics.