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.

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.

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à.

    

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.