Sdílet prostřednictvím

Nasazení brány azure API Management ve službě Azure Arc (Preview)

PLATÍ PRO: Vývojář | Prémie

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

Nasazení brány SLUŽBY API Management v clusteru Kubernetes s podporou Služby Azure Arc rozšiřuje podporu služby API Management pro hybridní a multicloudová prostředí. Povolte nasazení pomocí rozšíření clusteru, abyste zajistili konzistentní správu a aplikování zásad na cluster s podporou Azure Arc.

Důležité

Brána služby API Management na Azure Arc je aktuálně ve verzi Preview. Ve verzi Preview je rozšíření brány API Management dostupné v následujících oblastech:

  • Asie (východ, jihovýchod)
  • Austrálie (Centrální, Centrální 2, Východ a Jihovýchod)
  • Brazílie (jih a jihovýchod)
  • Kanada (střed, východ)
  • Evropa (severní, západní)
  • Francie (střed a jih)
  • Německo (severní a západní střed)
  • Indie (střed, jih, západ, Jio – střed a Jio – západ)
  • Japonsko (východ a západ)
  • Korea (střed a jih)
  • Norsko (východ a západ)
  • Jihoafrická republika (severní a západní)
  • Švédsko (střed)
  • Švýcarsko (severní a západní)
  • Spojené arabské emiráty (Spojené arabské emiráty - střed a sever)
  • Spojené království (UK - jih)
  • USA (USA – Střed, EUAP Střed, Východ, Východ 2, EUAP Východ 2, Severní Střed, Jižní Střed, Středozápad, Západ, Západ 2, Západ 3)

Poznámka:

Bránu samohostovanou můžete také nasadit přímo do Kubernetes.

Požadavky

Nasazení rozšíření brány pro správu API pomocí Azure CLI

  1. Na webu Azure Portal přejděte k vaší instanci služby API Management.

  2. V boční navigační nabídce vyberte Nasazení + infrastruktura>Brány.

  3. V seznamu vyberte a otevřete zřízený prostředek brány.

  4. V poskytnutém prostředku brány klikněte na Nasazení z navigačního menu.

  5. Poznamenejte si hodnoty Tokenu a koncového bodu konfigurace pro další krok.

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

    • Následující příklad používá service.type='LoadBalancer' konfiguraci rozšíření. Podívejte se na další dostupné konfigurace rozšíření.
    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- Příznak pro gateway.auth.token je volitelný, ale doporučuje se.

  7. 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>

  8. Vraťte se do seznamu Bran a ověřte, že stav brány zobrazuje zelené zaškrtnutí s počtem uzlů. Tento stav znamená stav nasazených podů vlastní brány:

    • Úspěšně komunikují se službou API Management.
    • Mít pravidelný "puls".

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

  1. Na webu Azure Portal přejděte do clusteru připojeného ke službě Azure Arc.

  2. V nabídce vlevo vyberte Nastavení>Rozšíření + aplikace>+ Přidat>API Management gateway (preview).

  3. Vyberte Vytvořit.

  4. V okně Instalace brány API Management nakonfigurujte rozšíření brány:

    • Vyberte předplatné a skupinu prostředků pro vaši instanci služby API Management.
    • V podrobnostech brány vyberte instanci služby API Management a název brány. Zadejte Namespace pro vaše rozšíření a volitelně zadejte počet replik, pokud to podporuje vaše úroveň služby API Management.
    • V konfiguraci Kubernetes vyberte výchozí konfiguraci nebo jinou konfiguraci clusteru. Možnosti najdete v dostupných konfiguracích rozšíření.

    Snímek obrazovky s nasazením rozšíření na webu Azure Portal

  5. Na kartě Monitorování můžete volitelně povolit monitorování pro nahrání požadavků sledování metrik do brány a back-endu. Pokud je tato možnost povolená, vyberte existující pracovní prostor služby Log Analytics .

  6. Vyberte Zkontrolovat a nainstalovat a pak vyberte Nainstalovat.

Dostupné konfigurace rozšíření

Rozšíření brány hostované přímo pro Azure Arc poskytuje mnoho nastavení konfigurace, aby bylo možné rozšíření přizpůsobit vašemu prostředí. V této části jsou uvedena požadovaná nastavení nasazení a volitelná nastavení pro integraci se službou Log Analytics. Pro úplný seznam nastavení viz referenci k rozšíření brány v místním prostředí.

Požadovaná nastavení

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

Nastavení Popis
gateway.configuration.uri Koncový bod konfigurace ve službě API Management pro bránu v místním prostředí
gateway.auth.token Token ověřovací brány (autentizační klíč) pro autentizaci ve službě API Management. Obvykle začíná na GatewayKey.
service.type Konfigurace služby Kubernetes pro bránu: LoadBalancer, NodePortnebo ClusterIP.

Nastavení Log Analytics

Pokud chcete povolit monitorování brány v místním prostředí, nakonfigurujte následující nastavení Log Analytics:

Nastavení Popis
monitoring.customResourceId ID prostředku Azure Resource Manageru pro instanci služby API Management
monitoring.workspaceId ID pracovního prostoru služby Log Analytics
monitoring.ingestionKey Tajný klíč pro příjem dat z Log Analytics

Poznámka:

Pokud jste nepovolili Log Analytics:

  1. Projděte rychlý průvodce vytvořením pracovního prostoru služby Log Analytics.
  2. Zjistěte, kde najít nastavení agenta Log Analytics.

Související obsah

  • Last updated on