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

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.

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

• Absolvieren Sie den folgende Schnellstart: Erstellen einer Azure API Management-Instanz
• Erstellen Sie eine Docker-Umgebung. Docker für Desktop ist eine gute Option für Entwicklungs- und Evaluierungszwecke. Weitere Informationen zu allen Docker-Editionen, ihren Features sowie eine umfassende Dokumentation zu Docker selbst finden Sie unter Docker-Dokumentation.
• Bereitstellen einer Gatewayressource in Ihrer API Management-Instanz

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.

    

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

• Weitere Informationen zum selbstgehosteten Gateway finden Sie unter Azure API Management: Übersicht über das selbstgehostete Gateway.
• Konfigurieren eines benutzerdefinierten Domänennamens für das selbstgehostete Gateway