Bereitstellen eines selbstgehosteten Azure API Management-Gateways für Docker

  • Artikel

GILT FÜR: Entwickler | Premium

In diesem Artikel werden die Schritte für die Bereitstellung einer selbstgehosteten Gatewaykomponente von Azure API Management für eine Docker-Umgebung beschrieben.

Wichtig

Support für die Version 0 und Version 1 der Containerimages des selbstgehosteten Gateways von Azure API Management endet am 1. Oktober 2023, zusammen mit der zugehörigen Konfigurations-API v1. Verwenden Sie unser Migrationshandbuch, um das selbstgehostete Gateway v2.0.0 oder höher mit der Konfigurations-API v2 zu verwenden. Weitere Informationen finden Sie in unserer Dokumentation zur Einstellung veralteter Versionen.

Hinweis

Das Hosten eines selbstgehosteten Gateways in Docker eignet sich am besten für Anwendungsfälle, die sich auf die Auswertung und Entwicklung beziehen. Kubernetes wird für den Einsatz in der Produktionsumgebung empfohlen. Erfahren Sie mehr über das Bereitstellen eines selbstgehosteten Gateways für Kubernetes mit Helm oder mithilfe einer YAML-Bereitstellungsdatei.

Voraussetzungen

Hinweis

Das selbstgehostete Gateway ist als x86-64 Linux-basierter Docker-Container gepackt.

Bereitstellen des selbstgehosteten Gateways für Docker

  1. Wählen Sie Gateways unter Bereitstellung und Infrastruktur aus.

  2. Wählen Sie die Gatewayressource aus, die Sie bereitstellen möchten.

  3. Wählen Sie Bereitstellung aus.

  4. Beachten Sie, dass im Textfeld Token automatisch für Sie ein Zugriffstoken mit den Standardwerten Ablauf und Geheimer Schlüssel generiert wurde. Wählen Sie bei Bedarf die gewünschten Werte in einem oder beiden Steuerelementen aus, um ein neues Token zu generieren.

  5. Stellen Sie sicher, dass Docker unter Bereitstellungsskripts ausgewählt ist.

  6. Wählen Sie den Link zur Datei env.conf neben Umgebung aus, um die Datei herunterzuladen.

  7. Wählen Sie das Symbol Kopieren rechts neben dem Textfeld Ausführen aus, um den Docker-Befehl in die Zwischenablage zu kopieren.

  8. Fügen Sie den Befehl in das Terminalfenster (oder Befehlsfenster) ein. Passen Sie die Portzuordnungen und den Containernamen nach Bedarf an. Beachten Sie, dass der Befehl annimmt, dass die heruntergeladene Umgebungsdatei im aktuellen Verzeichnis vorhanden ist.

    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. Führen Sie den Befehl aus. Der Befehl weist Ihre Docker-Umgebung an, den Container mit einem Containerimage aus der Microsoft-Artefaktregistrierung auszuführen und den HTTP-Port (8080) und den HTTPS-Ports (8081) des Containers den Ports 80 und 443 auf dem Host zuzuordnen.

  10. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob der Gatewaycontainer ausgeführt wird:

    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. Kehren Sie zum Azure-Portal zurück, klicken Sie auf Übersicht und bestätigen Sie, dass der selbstgehostete Gatewaycontainer, den Sie gerade bereitgestellt haben, einen fehlerfreien Status meldet.

    Gatewaystatus

Tipp

Verwenden Sie den Befehl console docker container logs <gateway-name>, um eine Momentaufnahme des Protokolls des selbstgehosteten Gateways anzuzeigen.

Verwenden Sie den Befehl docker container logs --help, um alle Optionen für die Protokollanzeige anzuzeigen.

Nächste Schritte