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

Najlepiej nadaje się do celów oceny i rozwojowych hostowanie własnej bramy na platformie Docker. Rozwiązanie Kubernetes jest zalecane do użytku produkcyjnego. Dowiedz się, jak wdrożyć za pomocą Helm lub przy użyciu pliku YAML wdrożeniowego, aby uruchomić własną bramę na platformie Kubernetes.

Wymagania wstępne

• Wykonaj procedury przedstawione w następującym przewodniku Szybki start: Tworzenie wystąpienia usługi Azure API Management
• Utwórz środowisko platformy Docker. Platforma Docker for Desktop to dobra opcja 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.
• Skonfiguruj zasób bramy w wystąpieniu usługi API Management

Uwaga

Brama hostowana samodzielnie jest spakowana jako kontener platformy Docker oparty na systemie Linux x86-64.

Wdrażanie samodzielnie hostowanej bramy w Dockerze

1. Wybierz pozycję Bramy z obszaru Wdrażanie i infrastruktura.

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

3. Wybierz pozycję Wdrożenie.

4. Pamiętaj, że token dostępu w polu tekstowym Token został automatycznie wygenerowany przy użyciu domyślnych wartości klucza wygasania i klucza tajnego. 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 do pliku env.conf obok Środowisko, aby pobrać plik.

7. Wybierz ikonę kopiowania 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. Należy pamiętać, że 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 wydaje instrukcję środowisku platformy Docker, aby uruchamiało kontener przy użyciu obrazu kontenera z Rejestru Artefaktów Microsoft oraz zmapować porty HTTP kontenera (8080) i HTTPS (8081) na porty 80 i 443 na hoście.

10. Uruchom poniższe 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 Azure Portal, kliknij pozycję Przegląd i upewnij się, że kontener bramy własnego hostingu, który właśnie wdrożyłeś, zgłasza, że jest w dobrym stanie.

    

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 bramy samodzielnie hostowanej, zapoznaj się z Omówieniem bramy samodzielnie hostowanej usługi Azure API Management.
• Skonfiguruj niestandardową nazwę domeny dla bramy hostowanej samodzielnie.