Een zelf-hostende Gateway van Azure API Management implementeren in Docker

VAN TOEPASSING OP: Ontwikkelaar | Premium

Dit artikel bevat de stappen voor het implementeren van een zelf-hostend gatewayonderdeel van Azure API Management in een Docker-omgeving.

Belangrijk

Ondersteuning voor zelf-hostende gatewayversie 0 en versie 1 van Azure API Management eindigt op 1 oktober 2023, samen met de bijbehorende Configuratie-API v1. Gebruik onze migratiehandleiding voor het gebruik van zelf-hostende gateway v2.0.0 of hoger met configuration-API v2. Meer informatie vindt u in onze documentatie over afschaffing

Notitie

Het hosten van zelf-hostende gateway in Docker is het meest geschikt voor gebruiksscenario's voor evaluatie en ontwikkeling. Kubernetes wordt aanbevolen voor productiegebruik. Meer informatie over het implementeren met Helm of het gebruik van een YAML-implementatiebestand voor meer informatie over het implementeren van een zelf-hostende gateway naar Kubernetes.

Vereisten

• Lees de volgende snelstart: Een Azure API Management-exemplaar maken
• Maak een Docker-omgeving. Docker voor Desktop is een goede optie voor ontwikkelings- en evaluatiedoeleinden. Raadpleeg docker-documentatie voor informatie over alle Docker-edities, hun functies en uitgebreide documentatie over Docker zelf.
• Een gatewayresource inrichten in uw API Management-exemplaar

Notitie

Zelf-hostende gateway wordt verpakt als een x86-64 Op Linux gebaseerde Docker-container.

De zelf-hostende gateway implementeren in Docker

1. Selecteer Gateways onder Implementatie en infrastructuur.

2. Selecteer de gatewayresource die u wilt implementeren.

3. Selecteer Implementatie.

4. Houd er rekening mee dat een toegangstoken in het tekstvak Token automatisch voor u is gegenereerd met behulp van de standaardwaarden voor vervaldatum en geheime sleutel . Kies indien nodig gewenste waarden in een van beide besturingselementen om een nieuw token te genereren.

5. Zorg ervoor dat Docker is geselecteerd onder Implementatiescripts.

6. Selecteer de env.conf-bestandskoppeling naast de omgeving om het bestand te downloaden.

7. Selecteer het kopieerpictogram aan de rechterkant van het tekstvak Uitvoeren om de Docker-opdracht naar het Klembord te kopiëren.

8. Plak de opdracht in het terminalvenster (of opdrachtvenster). Pas de poorttoewijzingen en containernaam indien nodig aan. Houd er rekening mee dat de opdracht ervan uitgaat dat het gedownloade omgevingsbestand aanwezig is in de huidige map.

   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. Voer de opdracht uit. Met de opdracht wordt uw Docker-omgeving geïnstrueerd om de container uit te voeren met behulp van een containerinstallatiekopie uit de Microsoft-artefactregister en om de HTTP-poorten (8080) en HTTPS (8081) toe te wijzen aan poorten 80 en 443 op de host.

10. Voer de onderstaande opdracht uit om te controleren of de gatewaycontainer wordt uitgevoerd:

    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. Ga terug naar Azure Portal, klik op Overzicht en controleer of de zelf-hostende gatewaycontainer die u zojuist hebt geïmplementeerd, een goede status rapporteert.

    

Tip

Gebruik console docker container logs <gateway-name> de opdracht om een momentopname van zelf-hostend gatewaylogboek weer te geven.

Gebruik docker container logs --help de opdracht om alle weergaveopties voor logboeken weer te geven.

Volgende stappen

• Zie het overzicht van zelf-hostende gateways in Azure API Management voor meer informatie over de zelf-hostende gateway.
• Configureer de aangepaste domeinnaam voor de zelf-hostende gateway.