Nasazení brány azure API Management na Azure Arc (Preview)

Článek
10/09/2021
3 min ke čtení

Díky integraci mezi Azure API Management a Azure Arc v Kubernetesmůžete nasadit komponentu brány API Management jako rozšíření v clusteru Kubernetess podporou Azure Arc.

Nasazení brány API Management na cluster Kubernetes s podporou Azure Arc s podporou API Management rozšiřuje podporu hybridních a více cloudových prostředí. Povolte nasazení pomocí rozšíření clusteru a zajistěte konzistentní správu a použití zásad Azure Arc s povoleným clusterem.

Důležité

API Management brána v místním prostředí v Azure ARC je momentálně ve verzi Preview.

Poznámka

Bránu v vlastním prostředí můžete nasadit také přímo do Kubernetes.

Požadavky

Připojení clusteru Kubernetes v podporované Azure Arc oblasti.
Nainstalujte k8s-extension rozšíření Azure CLI:
```
az extension add --name k8s-extension
```
Pokud jste už modul k8s-extension nainstalovali, aktualizujte ho na nejnovější verzi:
```
az extension update --name k8s-extension
```
Vytvořte instanci azure API Management.
Zřízení prostředku brány v instanci azure API Management .

Nasazení rozšíření API Management gateway pomocí Azure CLI

V Azure Portal přejděte ke své instanci API Management.
V boční navigační nabídce vyberte Brány.
V seznamu vyberte a otevřete zřízený prostředek brány.
V prostředku zřízené brány klikněte v boční navigační nabídce na Nasazení.
Poznamenejte si hodnoty Token (Token) a Configuration URL (Adresa URL konfigurace) pro další krok.

V Azure CLI nasaďte rozšíření brány pomocí az k8s-extension create příkazu . Vyplňte token hodnoty configuration URL a .

Následující příklad používá service.type='LoadBalancer' konfiguraci rozšíření. Další dostupné konfigurace rozšíření najdete v tématu.

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- Příznak pro authKey je volitelný, ale doporučuje se.

Pomocí následujícího příkazu rozhraní příkazového řádku ověřte stav nasazení:

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

Vraťte se do seznamu Brány a ověřte, že se ve stavu brány zobrazuje zelená značka zaškrtnutí s hodnotou počtu uzlů. Tento stav znamená, že nasazené pody brány v vlastním prostředí:
- Úspěšně komunikují s API Management službou.
- Mají pravidelný " heartbeat".

Nasazení rozšíření API Management brány pomocí Azure Portal

V Azure Portal přejděte ke svému Azure Arc připojenému clusteru.
V nabídce vlevo vyberte Rozšíření (Preview) > + Přidat API Management gateway > (Preview).
Vyberte Vytvořit.
V okně API Management brány nakonfigurujte rozšíření brány:
- Vyberte předplatné a skupinu prostředků pro vaši API Management prostředků.
- V části Podrobnosti o bráně vyberte API Management instance a Název brány. Zadejte obor názvů pro vaše rozšíření a volitelně několik replik , pokud je podporováno ve vaší API Management úrovni služby.
- V části Konfigurace Kubernetes vyberte výchozí konfiguraci nebo jinou konfiguraci pro váš cluster. Možnosti najdete v dostupných konfiguracích rozšíření.
Na kartě Monitorování volitelně povolte monitorování a nahrajte do brány a back-endu metriky pro sledování požadavků. Pokud je tato možnost povolená, vyberte existující pracovní prostor služby Log Analytics.
Vyberte Zkontrolovat a nainstalovat a pak Nainstalovat.

Dostupné konfigurace rozšíření

Vyžaduje se následující konfigurace rozšíření.

Nastavení	Popis
`gateway.endpoint`	Adresa URL konfigurace koncového bodu brány.
`gateway.authKey`	Token pro přístup k bráně.
`service.type`	Konfigurace služby Kubernetes pro bránu: `LoadBalancer` `NodePort` , nebo `ClusterIP` .

Nastavení Log Analytics

Pokud chcete povolit monitorování brány v vlastním hostování, nakonfigurujte následující nastavení Log Analytics:

Nastavení	Popis
`monitoring.customResourceId`	Azure Resource Manager ID prostředku API Management instance.
`monitoring.workspaceId`	ID pracovního prostoru služby Log Analytics.
`monitoring.ingestionKey`	Tajný kód s klíčem pro příjem dat ze služby Log Analytics