Distribuire un gateway self-hosted di Gestione API di Azure nel servizio Azure Kubernetes

SI APPLICA A: Sviluppatore | Premium

Questo articolo illustra i passaggi per la distribuzione del componente gateway self-hosted dell'Azure API Management su Azure Kubernetes Service (AKS). Per la distribuzione di un gateway self-hosted in un cluster Kubernetes, vedere l'articolo sulle procedure per la distribuzione usando un file YAML di distribuzione o con Helm.

Note

È anche possibile distribuire il gateway self-hosted in un Cluster Kubernetes con abilitazione di Azure Arc come estensione del cluster.

Prerequisiti

• Creare un'istanza di Gestione API di Azure
• Creare un cluster Azure Kubernetes usando l'interfaccia della riga di comando di Azure, usando Azure PowerShell o usando il portale di Azure.
• Effettuare il provisioning di una risorsa gateway nell'istanza di Gestione API.

Distribuire il gateway self-hosted in AKS

1. Selezionare Gateway in Distribuzione e infrastruttura.

2. Selezionare la risorsa gateway self-hosted che si intende distribuire.

3. Selezionare Distribuzione.

4. Un nuovo token di accesso nella casella di testo Token è stato generato automaticamente usando i valori predefiniti Scadenza e Chiave privata. Modificarne uno o entrambi, se necessario, e selezionare Genera per creare un nuovo token.

5. Assicurarsi che Kubernetes sia selezionato in Script di distribuzione.

6. Selezionare il collegamento al file<gateway-name>.yml accanto a Distribuzione per scaricare il file.

7. Modificare config.service.endpoint, mapping delle porte, e il nome del contenitore nel file .yml in base alle esigenze.

8. A seconda dello scenario, potrebbe essere necessario modificare il tipo di servizio.

   • Il valore predefinito è LoadBalancer, ovvero il servizio di bilanciamento del carico esterno.
   • È possibile usare servizio di bilanciamento del carico interno per limitare l'accesso al gateway self-hosted solo agli utenti interni.
   • Nell'esempio seguente viene usato NodePort.

9. Selezionare l'icona copia nella parte destra della casella di testo Distribuisci per salvare il comando kubectl negli Appunti.

10. Incollare il comando nella finestra del terminale (o nel comando). Il comando presuppone che il file di ambiente scaricato sia presente nella directory corrente.

    kubectl apply -f <gateway-name>.yaml
    

11. Eseguire il comando. Il comando indica al cluster del servizio Azure Kubernetes di:

    • eseguire il contenitore usando l'immagine del gateway self-hosted scaricata dal Registro Container Microsoft.
    • Configurare il contenitore per esporre le porte HTTP (8080) e HTTPS (443).

12. Eseguire il comando seguente per verificare che il pod del gateway sia in esecuzione. Il nome del pod è un esempio.

    kubectl get pods
    NAME                                   READY     STATUS    RESTARTS   AGE
    contoso-apim-gateway-59f5fb94c-s9stz   1/1       Running   0          1m
    

13. Eseguire il comando seguente per verificare che il servizio gateway sia in esecuzione. Il nome del servizio e gli indirizzi IP sono esempi.

    kubectl get services
    NAME             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)                      AGE
    contosogateway   NodePort    10.110.230.87   <none>        80:32504/TCP,443:30043/TCP   1m
    

14. Tornare al portale di Azure e verificare che il nodo del gateway distribuito segnali lo stato di integrità.

Suggerimento

Usare il comando kubectl logs <gateway-pod-name> per visualizzare un'istantanea del log del gateway autogestito.

Contenuti correlati

• Per altre informazioni sul gateway self-hosted, vedere Panoramica del gateway self-hosted di Gestione API di Azure.
• Informazioni su come distribuire il gateway self-hosted di Gestione API nei cluster Kubernetes abilitati per Azure Arc.
• Altre informazioni sulle funzionalità di osservabilità dei gateway di Gestione API di Azure.
• Altre informazioni sulle linee guida per eseguire il gateway self-hosted in Kubernetes nell'ambiente di produzione.
• Altre informazioni sul servizio Azure Kubernetes.