Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
VAN TOEPASSING OP: Ontwikkelaar | Premie
Dit artikel bevat de stappen voor het implementeren van een zelf-hostend gatewayonderdeel van Azure API Management in een Docker-omgeving.
Notitie
Het hosten van een 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 van een zelf-hostende gateway naar Kubernetes met Helm of met behulp van een YAML-implementatiebestand.
Vereisten
- Voltooi de volgende snelstart: Een Azure API Management-exemplaar maken.
- Een Docker-omgeving maken: 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.
- Richt een gatewayresource in uw Azure API Management-exemplaar in.
Notitie
Zelfgehoste gateways worden verpakt als x86-64 Linux-gebaseerde Docker-containers.
De zelf-hostende gateway implementeren in Docker
Selecteer zelf-hostende gateways onder Implementatie en infrastructuur.
Selecteer de gatewayresource die u wilt implementeren.
Selecteer Implementatie van instellingen>.
Houd er rekening mee dat een toegangstoken in het tekstvak Token automatisch voor u wordt gegenereerd met behulp van de standaardwaarden voor vervaldatum en geheime sleutel . Kies indien nodig gewenste waarden in een van of beide bedieningselementen om een nieuw token te genereren.
Zorg ervoor dat Docker is geselecteerd onder Implementatiescripts.
Selecteer de env.conf-bestandskoppeling naast de omgeving om het bestand te downloaden.
Selecteer het pictogram Kopiëren aan de rechterkant van het tekstvak Uitvoeren om de Docker-opdracht naar het Klembord te kopiëren.
Plak de opdracht in het terminalvenster (of opdrachtvenster). Pas de poorttoewijzingen en containernaam indien nodig aan. Bij de opdracht wordt ervan uitgegaan 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>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 het Microsoft Artifact Registry en om de HTTP-poorten (8080) en HTTPS (8081) toe te wijzen aan poorten 80 en 443 op de host.
Voer de volgende opdracht uit om te controleren of de gatewaycontainer draait.
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-gatewayGa terug naar De Azure-portal, selecteer Overzicht en controleer of de zelf-hostende gatewaycontainer die u zojuist hebt geïmplementeerd, een goede status rapporteert.
Tip
Gebruik de console docker container logs <gateway-name> opdracht om een momentopname van het zelf gehoste gatewaylogboek weer te geven.
Gebruik docker container logs --help de opdracht om alle weergaveopties voor logboeken weer te geven.