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

DOTYCZY: Developer | Premium

Ten artykuł zawiera kroki wdrażania składnika własnej bramy usługi Azure API Management w środowisku platformy Docker.

Ważne

Obsługa samoobsługowej bramy usługi Azure API Management w wersji 0 i wersji 1 obrazów kontenerów kończy się 1 października 2023 r. wraz z odpowiednim interfejsem API konfiguracji w wersji 1. Skorzystaj z naszego przewodnika migracji , aby użyć własnej bramy w wersji 2.0.0 lub nowszej z interfejsem API konfiguracji w wersji 2. Dowiedz się więcej w naszej dokumentacji dotyczącej wycofywania

Uwaga

Hostowanie własnej bramy na platformie Docker najlepiej nadaje się do przypadków użycia oceny i programowania. Rozwiązanie Kubernetes jest zalecane do użytku produkcyjnego. Dowiedz się, jak wdrożyć program Helm lub za pomocą pliku YAML wdrożenia, aby dowiedzieć się, jak wdrożyć 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.
• Aprowizuj 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 własnej bramy na platformie Docker

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 plik env.conf obok pozycji Ś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 do okna terminalu (lub 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 instruuje środowisko platformy Docker, aby uruchamiało kontener przy użyciu obrazu kontenera z Rejestr Artefaktów Microsoft oraz mapować 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 witryny Azure Portal, kliknij pozycję Przegląd i upewnij się, że wdrożony kontener bramy self-hosted zgłasza stan dobrej kondycji.

    

Napiwek

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

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

Następne kroki

• Aby dowiedzieć się więcej na temat własnej bramy, zobacz Omówienie własnej bramy usługi Azure API Management.
• Skonfiguruj niestandardową nazwę domeny dla własnej bramy.