Alternative Ansätze beim Selbsthosten eines Entwicklerportals
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: