Autres approches du portail des développeurs auto-hébergés

Article
04/08/2024

Il existe plusieurs autres approches que vous pouvez explorer lorsque vous auto-hébergez un portail des développeurs :

Utilisez des builds de production du concepteur et de l’éditeur.
Utilisez une application de fonction Azure pour publier votre portail.
Préfacez les fichiers de votre portail avec un réseau de distribution de contenu (CDN) pour réduire les temps de chargement des pages.

Cet article fournit des informations sur chacune de ces approches.

Si vous ne l’avez pas déjà fait, configurez un environnement local pour la dernière version du portail des développeurs.

Build pour la production

Si vous souhaitez héberger l’environnement de développement du portail en ligne à des fins de collaboration, utilisez les builds de production du concepteur et de l’éditeur. Les builds de production regroupent les fichiers, excluent les mappages de source, etc.

Créez un bundle dans le répertoire ./dist/designer en exécutant la commande :

npm run build-designer

Le résultat étant une application à page unique, vous pouvez toujours la déployer sur un hôte web statique, tel que le site web statique du stockage d’objets blob Azure.

De même, placez un serveur de publication compilé et optimisé dans le dossier ./dist/publisher :

npm run build-publisher

Utiliser une application de fonction pour publier le portail

Exécutez l’étape de publication dans le cloud plutôt que localement.

Pour implémenter la publication avec une application de fonction Azure, vous avez besoin des composants suivants :

Créez une fonction Azure. La fonction doit être une fonction de langage JavaScript.

Installez Azure Functions Core Tools :

npm install –g azure-function-core-tools

Étape 1 : Configurer le stockage de sortie

Chargement du contenu directement sur le site web d’hébergement (conteneur « $web » du stockage de sortie) au lieu d’un dossier local. Configurez cette modification dans le fichier ./src/config.publish.json :

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

Étape 2 : Générer et déployer l’application de fonction

Le dossier ./examples contient un exemple de fonction de déclencheur HTTP. Pour le générer et le placer dans ./dist/function, exécutez la commande suivante :

npm run build-function

Ensuite, connectez-vous à Azure CLI et déployez-le :

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

Une fois déployé, vous pouvez l’appeler avec un appel HTTP :

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

Hébergement et CDN

Dans Auto-héberger un portail des développeurs, nous avons suggéré d’utiliser un compte de stockage Azure pour héberger votre site web. Toutefois, vous pouvez publier les fichiers par le biais de n’importe quelle solution, y compris les services des fournisseurs d’hébergement.

Vous pouvez également initier les fichiers avec un réseau de distribution de contenu (CDN) pour réduire les temps de chargement des pages. Nous vous recommandons d’utiliser Azure CDN.

Étapes suivantes

Pour plus d’informations sur le portail des développeurs :

Vue d’ensemble du portail des développeurs Gestion des API Azure

Partage via