Wdrażanie własnej bramy usługi Azure API Management na platformie Docker

DOTYCZY: Developer | Premium

Ten artykuł zawiera etapy wdrażania składnika bramy hostowanej lokalnie usługi Azure API Management w środowisku Docker.

Uwaga

Hostowanie własnej bramy na platformie Docker najlepiej nadaje się do oceny i przypadków użycia programowania. Rozwiązanie Kubernetes jest zalecane do użytku produkcyjnego. Dowiedz się, jak wdrożyć bramę samoobsługową do Kubernetes z programem Helm lub przy użyciu pliku YAML wdrożenia.

Wymagania wstępne

• Wykonaj kroki opisane w szybkim starcie: Tworzenie wystąpienia usługi Azure API Management.
• Tworzenie środowiska platformy Docker: platforma Docker for Desktop jest dobrą opcją do celów programistycznych i ewaluacyjnych. Zapoznaj się z dokumentacją platformy Docker, aby uzyskać informacje na temat wszystkich wersji platformy Docker, ich funkcji i kompleksowej dokumentacji dotyczącej samej platformy Docker.
• Aprowizuj zasób gateway w wystąpieniu usługi Azure API Management.

Uwaga

Bramy hostowane samodzielnie są pakowane jako kontenery platformy Docker oparte na systemie Linux x86-64.

Wdrażanie samodzielnie hostowanej bramy w Dockerze

1. Wybierz pozycję Bramy hostowane samodzielnie w obszarze Wdrażanie i infrastruktura.

2. Wybierz zasób bramy, który chcesz wdrożyć.

3. Wybierz Ustawienia>Wdrożenie.

4. Należy pamiętać, że token dostępu w polu tekstowym Token jest automatycznie generowany przy użyciu domyślnych wartości Okres wygaśnięcia i Klucz tajny. W razie potrzeby wybierz żądane wartości w obu kontrolkach, aby wygenerować nowy token.

5. Upewnij się, że w obszarze Skrypty wdrażania wybrano pozycję Docker.

6. Wybierz link pliku env.conf obok pozycji Środowisko , aby pobrać plik.

7. Wybierz ikonę Kopiuj znajdującą się po prawej stronie pola tekstowego Uruchom , aby skopiować polecenie platformy Docker do schowka.

8. Wklej polecenie w terminalu (lub w oknie polecenia). Dostosuj mapowania portów i nazwę kontenera zgodnie z potrzebami. Polecenie zakłada, że pobrany plik środowiska znajduje się w bieżącym katalogu.

   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. Wykonaj polecenie . Polecenie poleca środowisko Docker, aby uruchomiło kontener przy użyciu obrazu kontenera z Rejestru Artifaktów firmy Microsoft i aby mapować porty HTTP kontenera (8080) oraz HTTPS (8081) na porty 80 i 443 na hoście.

10. Uruchom następujące polecenie, aby sprawdzić, czy kontener bramy jest uruchomiony:

    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. Wróć do portalu Azure, wybierz pozycję Przegląd i upewnij się, że właśnie wdrożony kontener bramy samohostujący zgłasza prawidłowy stan.

    

Napiwek

Użyj polecenia console docker container logs <gateway-name>, aby wyświetlić migawkę dziennika lokalnie hostowanej bramy.

Użyj docker container logs --help polecenia , aby wyświetlić wszystkie opcje wyświetlania dziennika.

Powiązana zawartość

• Aby dowiedzieć się więcej na temat samodzielnie hostowanej bramy, zobacz Omówienie samodzielnie hostowanej bramy.
• Skonfiguruj niestandardową nazwę domeny dla bramy hostowanej samodzielnie.