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

  • Articolo

SI APPLICA A: Sviluppatore | Premium

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

Importante

Il supporto per le immagini del contenitore del gateway self-hosted di Gestione API di Azure versione 0 e versione 1 termina il 1° ottobre 2023, insieme all'API di configurazione corrispondente v1. Consultare la guida alla migrazione per usare il gateway self-hosted v2.0.0 o versione successiva con l'API di configurazione v2. Altre informazioni nella documentazione di deprecazione

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 nel servizio Azure Kubernetes

  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 <gateway-name>.yml collegamento file accanto a Distribuzione per scaricare il file.

  7. Modificare i config.service.endpointmapping 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 il 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 di copia nella parte destra della casella di testo Distribuisci per salvare il kubectl comando negli Appunti.

  10. Incollare il comando nella finestra del terminale (o nel comando). Il comando prevede 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 Azure Container.
    • 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 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