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 selbst gehosteten Gateways in Docker eignet sich am besten für Evaluierungs- und Entwicklungsanwendungsfälle. Kubernetes wird für den Einsatz in der Produktionsumgebung empfohlen. Erfahren Sie, wie Sie ein selbst gehostetes Gateway mit Helm oder mithilfe einer YAML-Bereitstellungsdatei für Kubernetes bereitstellen.

Voraussetzungen

• Bearbeiten Sie den folgenden Schnellstart: Erstellen einer neuen Azure API Management-Dienstinstanz
• 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.
• Stellen Sie eine Gatewayressource in Ihrer Azure API-Verwaltungsinstanz bereit.

Hinweis

Selbst gehostete Gateways werden als x86-64 Linux-basierte Docker-Container verpackt.

Bereitstellen des selbstgehosteten Gateways für Docker

1. Wählen Sie selbst gehostete Gateways unter Bereitstellung + Infrastruktur aus.

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

3. Wählen Sie Einstellungen>Bereitstellung aus.

4. Beachten Sie, dass ein Zugriffstoken im Textfeld "Token " automatisch generiert wird, indem die standardmäßigen Schlüsselwerte "Ablaufdatum " und "Geheimer Schlüssel " verwendet werden. 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 Dateilink "env.conf " neben der Umgebung aus, um die Datei herunterzuladen.

7. Wählen Sie das Symbol "Kopieren " am rechten Ende des Textfelds "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. Der Befehl setzt voraus, 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 mithilfe eines Containerimages aus der Microsoft Artifact Registry auszuführen und die HTTP-Ports (8080) und HTTPS (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. Wechseln Sie zurück zum Azure-Portal, wählen Sie "Übersicht" aus, und vergewissern Sie sich, dass der selbst gehostete 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.

Verwandte Inhalte

• Weitere Informationen zum selbst gehosteten Gateway finden Sie in der Übersicht über das selbst gehostete Gateway.
• Konfigurieren Sie einen benutzerdefinierten Domänennamen für ein selbst gehostetes Gateway.