Distribuera en lokal Azure API Management-gateway till Docker

GÄLLER FÖR: Utvecklare | Premie

Den här artikeln innehåller stegen för att distribuera en lokalt installerad gatewaykomponent i Azure API Management till en Docker-miljö.

Anteckning

Värd för en självhostad gateway i Docker passar bäst för utvärderings- och utvecklingsscenarier. Kubernetes rekommenderas för produktionsanvändning. Lär dig hur du distribuerar en lokalt installerad gateway till Kubernetes med Helm eller med hjälp av en YAML-distributionsfil.

Förutsättningar

• Slutför följande snabbstart: Skapa en Azure API Management-instans.
• Skapa en Docker-miljö: Docker for Desktop är ett bra alternativ för utveckling och utvärdering. Se Docker-dokumentationen för information om alla Docker-utgåvor, deras funktioner och omfattande dokumentation om Själva Docker.
• Konfigurera en gatewayresurs i din Azure API Management-instans.

Anteckning

Gatewayer med egen värd paketeras som x86-64 Linux-baserade Docker-containrar.

Distribuera den lokalt installerade gatewayen till Docker

1. Välj gatewayer med egen värd under Distribution + infrastruktur.

2. Välj den gatewayresurs som du vill distribuera.

3. Välj Inställningar>Distribution.

4. Observera att en åtkomsttoken i textrutan Token genereras automatiskt med hjälp av standardvärdena Förfallodatum och Hemlighet . Om det behövs väljer du önskade värden i endera eller båda kontrollerna för att generera en ny token.

5. Kontrollera att Docker är markerat under Distributionsskript.

6. Välj env.conf-fillänken bredvid Miljön för att ladda ned filen.

7. Välj ikonen Kopiera vid den högra änden av textrutan Kör för att kopiera Docker-kommandot till urklipp.

8. Klistra in kommandot i terminalfönstret (eller kommandofönstret). Justera portmappningarna och containernamnet efter behov. Kommandot förutsätter att den nedladdade miljöfilen finns i den aktuella katalogen.

   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. Kör kommandot. Kommandot instruerar Docker-miljön att köra containern med hjälp av en containeravbildning från Microsoft Artifact Registry och mappa containerns HTTP-portar (8080) och HTTPS (8081) till portarna 80 och 443 på värden.

10. Kör följande kommando för att kontrollera om gatewaycontainern körs:

    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. Gå tillbaka till Azure-portalen, välj Översikt och bekräfta att den lokala gatewaycontainern som du just distribuerade rapporterar en felfri status.

    

Tips

Använd console docker container logs <gateway-name>-kommandot för att visa en kortsammanställning av loggar från en självhostad gateway.

Använd docker container logs --help kommandot för att se alla visningsalternativ för loggar.

Relaterat innehåll

• Mer information om den lokalt installerade gatewayen finns i Översikt över lokalt installerad gateway.
• Konfigurera ett anpassat domännamn för en gateway med egen värd.