Alternative Ansätze beim Selbsthosten eines Entwicklerportals

  • Artikel

GILT FÜR: Entwickler | Basic | Basic v2 | Standard | Standard v2 | Premium

Es gibt mehrere alternative Ansätze, die ggf. für Sie in Frage kommen, wenn Sie ein Entwicklerportal selbst hosten:

  • Verwenden von Produktionsbuilds des Designers und des Herausgebers

  • Verwenden einer Azure-Funktions-App, um Ihr Portal zu veröffentlichen

  • Bereitstellen der Dateien Ihres Portals mit einem Content Delivery Network (CDN), um die Seitenladezeiten zu verringern

Dieser Artikel enthält Informationen zu jedem dieser Ansätze.

Richten Sie bei Bedarf eine lokale Umgebung für das neueste Release des Entwicklerportals ein.

Erstellen für die Produktion

Wenn Sie die Entwicklungsumgebung des Portals online hosten möchten, um Zusammenarbeit zu ermöglichen, verwenden Sie Produktionsbuilds des Designers und des Herausgebers. In Produktionsbuilds werden unter anderem die Dateien gebündelt und Sourcemaps ausgeschlossen.

Führen Sie den folgenden Befehl aus, um ein Paket im Verzeichnis ./dist/designer zu erstellen:

npm run build-designer

Das Ergebnis ist eine Single-Page-Webanwendung, die weiterhin für einen statischen Webhost wie etwa die statische Azure Blob Storage-Website bereitgestellt werden kann.

Platzieren Sie analog dazu einen kompilierten und optimierten Herausgeber im Ordner ./dist/publisher:

npm run build-publisher

Verwenden einer Funktions-App zum Veröffentlichen des Portals

Führen Sie alternativ zur lokalen Ausführung den Veröffentlichungsschritt in der Cloud aus.

Wenn Sie die Veröffentlichung mit einer Azure-Funktions-App implementieren möchten, ist Folgendes erforderlich:

  • Erstellen Sie eine Azure-Funktion. Bei der Funktion muss es sich um eine JavaScript-Sprachfunktion handeln.
  • Installieren Sie Azure Functions Core Tools: 
    npm install –g azure-function-core-tools

Schritt 1: Konfigurieren des Ausgabespeichers

Laden Sie den Inhalt direkt an die Hostingwebsite (Container „$web“ des Ausgabespeichers) hoch anstatt in den lokalen Ordner. Konfigurieren Sie diese Änderung in der Datei ./src/config.publish.json:

{
   ...
   "outputBlobStorageContainer": "$web",
   "outputBlobStorageConnectionString": "DefaultEndpointsProtocol=...",
   ...
}

Schritt 2: Erstellen und Bereitstellen der Funktions-App

Der Ordner ./examples enthält eine exemplarische HTTP-Triggerfunktion. Führen Sie den folgenden Befehl aus, um sie zu erstellen und in ./dist/function zu platzieren:

npm run build-function

Melden Sie sich dann bei der Azure CLI an, und stellen Sie die Funktion bereit:

az login
cd ./dist/function
func azure functionapp publish <function app name>

Nach der Bereitstellung können Sie sie mit einem HTTP-Aufruf aufrufen:

curl -X POST https://<function app name>.azurewebsites.net/api/publish

Hosting und CDN

Im Artikel Selbsthosten des API Management-Entwicklerportals wurde das Hosten Ihrer Website unter Verwendung eines Azure-Speicherkontos empfohlen. Die Dateien können jedoch über eine beliebige Lösung veröffentlicht werden. Dies schließt Dienste von Hostinganbietern mit ein.

Die Dateien können auch mit einem Content Delivery Network (CDN) bereitgestellt werden, um die Seitenladezeiten zu verringern. Wir empfehlen Azure CDN.

Nächste Schritte

Weitere Informationen zum Entwicklerportal: