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

Kommentar

Värdhanterad gateway i Docker passar bäst för utvärderings- och utvecklingsanvändningsfall. Kubernetes rekommenderas för produktionsanvändning. Lär dig hur du distribuerar med Helm eller använder YAML-distributionsfilen för att lära dig hur du distribuerar en lokalt installerad gateway till Kubernetes.

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.
• Etablera en gatewayresurs i din API Management-instans

Kommentar

En lokalt installerad gateway paketeras som en x86-64 Linux-baserad Docker-container.

Distribuera den lokalt installerade gatewayen till Docker

1. Välj Gatewayer från under Distribution och infrastruktur.

2. Välj den gatewayresurs som du tänker distribuera.

3. Välj Distribution.

4. Observera att en åtkomsttoken i textrutan Token automatiskt genererades för dig med standardvärdena Förfallodatum och Hemlig nyckel . 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änk bredvid miljö för att ladda ned filen.

7. Välj kopieringsikonen till höger i textrutan Kör för att kopiera Docker-kommandot till Urklipp.

8. Klistra in kommandot i terminalfönstret (eller kommandot). Justera portmappningarna och containernamnet efter behov. Observera att 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 Microsofts artefaktregister och mappa containerns HTTP-portar (8080) och HTTPS (8081) till portarna 80 och 443 på värden.

10. Kör kommandot nedan 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 för att Azure Portal klickar du på Översikt och bekräftar att den gatewaycontainer som du nyss distribuerade rapporterar en felfri status.

    

Dricks

Använd console docker container logs <gateway-name> kommandot för att visa en ögonblicksbild av gatewayloggen med egen värd.

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

Nästa steg

• Mer information om den lokalt installerade gatewayen finns i Översikt över självhanterad gateway i Azure API Management.
• Konfigurera anpassat domännamn för den lokalt installerade gatewayen.