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.

Note

L'implementazione di un gateway auto-ospitato in Docker è più adatta per i casi d'uso di valutazione e sviluppo. Kubernetes è consigliato per l'uso in produzione. Scopri come distribuire un gateway self-hosted in Kubernetes con Helm o utilizzando un file YAML di distribuzione.

Prerequisiti

• Completare il seguente quickstart: 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 di Azure.

Note

I gateway self-hosted vengono inseriti in un pacchetto come contenitori Docker basati su Linux x86-64.

Distribuire il gateway self-hosted in Docker

1. Selezionare Gateway self-hosted in Distribuzione e infrastruttura.

2. Selezionare la risorsa gateway da distribuire.

3. Selezionare Impostazioni>distribuzione.

4. Si noti che un token di accesso nella casella di testo Token viene 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 Copia nella 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. 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 di Microsoft e di eseguire il mapping delle porte HTTP (8080) e HTTPS (8081) 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, selezionare Panoramica e verificare che il contenitore del gateway self-hosted appena distribuito segnala uno stato integro.

    

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.

Contenuti correlati

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