Distribuire un gateway Gestione API di Azure in Azure Arc (anteprima)

SI APPLICA A: Sviluppatore | Premium

Con l'integrazione tra Azure Gestione API e Azure Arc in Kubernetes, è possibile distribuire il componente gateway Gestione API come estensione in un cluster Kubernetes abilitato per Azure Arc.

La distribuzione del gateway Gestione API in un cluster Kubernetes abilitato per Azure Arc espande Gestione API supporto per ambienti ibridi e multicloud. Abilitare la distribuzione usando un'estensione del cluster per eseguire la gestione e l'applicazione di criteri al cluster abilitato per Azure Arc un'esperienza coerente.

Importante

Gestione API gateway self-hosted in Azure Arc è attualmente in anteprima. Durante l'anteprima, l'estensione del gateway Gestione API è disponibile nelle aree seguenti:

• Asia (est, sud-orientale)
• Australia (centrale, centrale 2, est e sud-orientale)
• Brasile (sud-orientale)
• Canada (centrale, orientale)
• Europa (nord, ovest)
• Francia (centrale e meridionale)
• Germania (centro-settentrionale)
• India (Centro, Sud, Ovest, Jio centrale e Jio West)
• Giappone (Est e Ovest)
• Corea (centrale e meridionale)
• Norvegia (Est e Ovest)
• Sudafrica (Nord e Ovest)
• Svezia (centrale)
• Svizzera (Nord e Ovest)
• Emirati Arabi Uniti (Emirati Arabi Uniti - Centro e Nord)
• Regno Unito (Regno Unito -Sud)
• Stati Uniti (Stati Uniti - Stati Uniti centrali, UEAP centrale, Est, Est 2, EUAP orientale 2, Centro-settentrionale, Centro-sud, Centro-occidentale, Ovest, 2 ovest 2, Ovest 3)

Nota

È anche possibile distribuire il gateway self-hosted direttamente in Kubernetes.

Prerequisiti

• Connessione il cluster Kubernetes all'interno di un'area di Azure Arc supportata.

• Installare l'estensione dell'interfaccia della k8s-extension riga di comando di Azure:

  az extension add --name k8s-extension
  

  Se il k8s-extension modulo è già stato installato, eseguire l'aggiornamento alla versione più recente:

  az extension update --name k8s-extension
  

• Creare un'istanza di Gestione API di Azure.

• Effettuare il provisioning di una risorsa gateway nell'istanza di Azure Gestione API.

Distribuire l'estensione gateway Gestione API usando l'interfaccia della riga di comando di Azure

1. Nel portale di Azure accedere all'istanza di Gestione API.

2. Selezionare Gateway dal menu di spostamento laterale.

3. Selezionare e aprire la risorsa gateway di cui è stato effettuato il provisioning nell'elenco.

4. Nella risorsa gateway di cui è stato effettuato il provisioning fare clic su Distribuzione dal menu di spostamento laterale.

5. Prendere nota dei valori token e URL di configurazione per il passaggio successivo.

6. Nell'interfaccia della riga di comando di Azure distribuire l'estensione del gateway usando il az k8s-extension create comando . Compilare i token valori e configuration URL .

   • Nell'esempio seguente viene usata la configurazione dell'estensione service.type='LoadBalancer' . Vedere altre configurazioni delle estensioni disponibili.

   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
   

   Suggerimento

   -protected- flag per gateway.auth.token è facoltativo, ma consigliato.

7. Verificare lo stato della distribuzione usando il comando dell'interfaccia della riga di comando seguente:

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

8. Tornare all'elenco Gateway per verificare che lo stato del gateway mostri un segno di spunta verde con un conteggio dei nodi. Questo stato indica i pod gateway self-hosted distribuiti:

   • Comunicare correttamente con il servizio Gestione API.
   • Avere un normale "heartbeat".

Distribuire l'estensione gateway Gestione API usando portale di Azure

1. Nella portale di Azure passare al cluster connesso ad Azure Arc.

2. Nel menu a sinistra selezionare Estensioni>+ Aggiungi> Gestione API gateway (anteprima).

3. Seleziona Crea.

4. Nella finestra Installa Gestione API gateway configurare l'estensione del gateway:

   • Selezionare la sottoscrizione e il gruppo di risorse per l'istanza di Gestione API.
   • In Dettagli gateway selezionare l'istanza di Gestione API e il nome del gateway. Immettere un ambito spazio dei nomi per l'estensione e, facoltativamente, un numero di repliche, se supportato nel livello di servizio Gestione API.
   • Nella configurazione di Kubernetes selezionare la configurazione predefinita o una configurazione diversa per il cluster. Per le opzioni, vedere Configurazioni delle estensioni disponibili.

   

5. Nella scheda Monitoraggio abilitare facoltativamente il monitoraggio per caricare le richieste di rilevamento delle metriche nel gateway e nel back-end. Se abilitata, selezionare un'area di lavoro Log Analytics esistente.

6. Selezionare Rivedi e installa e quindi Installa.

Configurazioni di estensioni disponibili

L'estensione del gateway self-hosted per Azure Arc offre molte impostazioni di configurazione per personalizzare l'estensione per l'ambiente in uso. Questa sezione elenca le impostazioni di distribuzione necessarie e le impostazioni facoltative per l'integrazione con Log Analytics. Per un elenco completo delle impostazioni, vedere le informazioni di riferimento sull'estensione del gateway self-hosted.

Impostazioni obbligatorie

Sono necessarie le configurazioni di estensione seguenti.

Impostazione	Descrizione
gateway.configuration.uri	Endpoint di configurazione nel servizio Gestione API per il gateway self-hosted.
gateway.auth.token	Token gateway (chiave di autenticazione) per l'autenticazione al servizio Gestione API. In genere inizia con GatewayKey.
service.type	Configurazione del servizio Kubernetes per il gateway: LoadBalancer, NodePorto ClusterIP.

Impostazioni di Log Analytics

Per abilitare il monitoraggio del gateway self-hosted, configurare le impostazioni di Log Analytics seguenti:

Impostazione	Descrizione
monitoring.customResourceId	ID risorsa di Azure Resource Manager per l'istanza di Gestione API.
monitoring.workspaceId	ID area di lavoro di Log Analytics.
monitoring.ingestionKey	Segreto con chiave di inserimento da Log Analytics.

Nota

Se Log Analytics non è stato abilitato:

1. Avvio rapido Creare un'area di lavoro Log Analytics.
2. Informazioni su dove trovare le impostazioni dell'agente di Log Analytics.

Passaggi successivi

• Per altre informazioni sul gateway self-hosted, vedere Panoramica del gateway self-hosted di Gestione API di Azure.
• Altre informazioni sulle funzionalità di osservabilità dei gateway di Gestione API di Azure.
• Individuare tutte le estensioni Kubernetes abilitate per Azure Arc.
• Altre informazioni su Kubernetes abilitato per Azure Arc.
• Altre informazioni su come eseguire il gateway self-hosted in Kubernetes nell'ambiente di produzione.
• Per le opzioni di configurazione, vedere le informazioni di riferimento sull'estensione del gateway self-hosted.