Distribuire un gateway self-hosted di Gestione API di Azure in Docker

SI APPLICA A: Sviluppatore | Premium

Questo articolo illustra i passaggi per la distribuzione di un componente gateway self-hosted di Gestione API di Azure in un ambiente Docker.

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

L'hosting del gateway self-hosted in Docker è più adatto per i casi d'uso di valutazione e sviluppo. Kubernetes è consigliato per l'uso in produzione. Informazioni sulla distribuzione con Helm o con il file YAML di distribuzione per scoprire come distribuire un gateway self-hosted in Kubernetes.

Prerequisiti

• Completare la guida introduttiva seguente: Creare un'istanza di Gestione API di Azure
• Creare un ambiente Docker. Docker per Desktop è un'ottima opzione per scopi di sviluppo e valutazione. Vedere la documentazione di Docker per informazioni su tutte le edizioni Docker, le relative funzionalità e la documentazione completa su Docker.
• Effettuare il provisioning di una risorsa gateway nell'istanza di Gestione API.

Nota

Il gateway self-hosted viene incluso in un pacchetto come contenitore Docker basato su Linux x86-64.

Distribuire il gateway self-hosted in Docker

1. Selezionare Gateway in Distribuzione e infrastruttura.

2. Selezionare la risorsa gateway che si intende distribuire.

3. Selezionare Distribuzione.

4. Si noti che un token di accesso nella casella di testo Token è stato generato automaticamente usando i valori predefiniti Scadenza e Chiave privata. Se necessario, selezionare i valori desiderati in uno o entrambi i controlli per generare un nuovo token.

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

6. Selezionare il collegamento al file env.conf accanto all'ambiente per scaricare il file.

7. Selezionare l'icona Copianella parte destra della casella di testo Esegui per copiare il comando Docker negli appunti.

8. Incollare il comando nella finestra del terminale (o nel comando). Modificare i mapping delle porte e il nome del contenitore in base alle esigenze. Si noti che il comando presuppone che il file di ambiente scaricato sia presente nella directory corrente.

   docker run -d -p 80:8080 -p 443:8081 --name <gateway-name> --env-file env.conf mcr.microsoft.com/azure-api-management/gateway:<tag>
   

9. Eseguire il comando . Il comando indica all'ambiente Docker di eseguire il contenitore usando un'immagine del contenitore dal Registro artefatti Microsoft e di eseguire il mapping delle porte HTTP (8080) e HTTPS (8081) del contenitore alle porte 80 e 443 dell'host.

10. Eseguire il comando seguente per verificare se il contenitore del gateway è in esecuzione:

    docker ps
    CONTAINER ID        IMAGE                                                 COMMAND                  CREATED             STATUS              PORTS                                         NAMES
    895ef0ecf13b        mcr.microsoft.com/azure-api-management/gateway:latest   "/bin/sh -c 'dotnet …"   5 seconds ago       Up 3 seconds        0.0.0.0:80->8080/tcp, 0.0.0.0:443->8081/tcp   my-gateway
    

11. Tornare al portale di Azure, fare clic su Panoramica e verificare che il contenitore del gateway self-hosted appena distribuito segnali uno stato di integrità.

    

Suggerimento

Usare il comando console docker container logs <gateway-name> per visualizzare uno snapshot del log del gateway self-hosted.

Usare il comando docker container logs --help per visualizzare tutte le opzioni di visualizzazione dei log.

Passaggi successivi

• Per altre informazioni sul gateway self-hosted, vedere Panoramica del gateway self-hosted di Gestione API di Azure.
• Configurare il nome di dominio personalizzato per il gateway self-hosted.