Condividi tramite

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

  • Articolo

SI APPLICA A: Sviluppatore | Premium

Questo articolo illustra i passaggi per la distribuzione di un componente gateway self-hosted di Gestione API di Azure nel Servizio Azure Kubernetes. 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.

Nota

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

Prerequisiti

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 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.
    • L'esempio seguente usa 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 sarà diverso.

    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 del gateway sia in esecuzione. Il nome del servizio e gli indirizzi IP saranno diversi.

    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 uno snapshot del log del gateway self-hosted.

Passaggi successivi