Approcci alternativi al portale per sviluppatori self-host

Articolo
04/04/2024

Esistono diversi approcci alternativi che è possibile esplorare quando si opta per il self-hosting di un portale per sviluppatori:

Usare le build di produzione della finestra di progettazione e del server di pubblicazione.
Usare un'app per le funzioni di Azure per pubblicare il portale.
Per ridurre i tempi di caricamento delle pagine, anticipare i file del portale con una rete per la distribuzione di contenuti (CDN).

Questo articolo fornisce informazioni su ognuno di questi approcci.

Se non è già stato fatto, configurare un ambiente locale per la versione più recente del portale per sviluppatori.

Build per la produzione

Se si vuole ospitare online l'ambiente di sviluppo del portale a scopo di collaborazione, usare le build di produzione della finestra di progettazione e del server di pubblicazione. Le build di produzione aggregano i file, escludono il mapping di origine e così via.

Creare un bundle nella directory ./dist/designer eseguendo il comando:

npm run build-designer

Il risultato è un'applicazione a pagina singola, perciò è comunque possibile distribuirla in un host Web statico, ad esempio il sito Web statico di Archiviazione BLOB di Azure.

Analogamente, inserire un server di pubblicazione compilato e ottimizzato nella cartella ./dist/publisher:

npm run build-publisher

Usare l'app per le funzioni per pubblicare il portale

Eseguire il passaggio di pubblicazione nel cloud come alternativa all'esecuzione locale.

Per implementare la pubblicazione con un'app per le funzioni di Azure, sono necessari i prerequisiti seguenti:

Creare una funzione di Azure. La funzione deve essere una funzione del linguaggio JavaScript.

Installare Azure Functions Core Tools:

npm install –g azure-function-core-tools

Passaggio 1: Configurare l'archiviazione di output

Caricamento del contenuto direttamente nel sito Web di hosting (contenitore "$web" di archiviazione di output), anziché in una cartella locale. Configurare questa modifica nel file ./src/config.publish.json:

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

Passaggio 2: Compilare e distribuire l'app per le funzioni

Nella cartella ./examples è presente una funzione di trigger HTTP di esempio. Per compilarla e inserirla in ./dist/function, eseguire il comando seguente:

npm run build-function

Accedere quindi all'interfaccia della riga di comando di Azure e distribuirla:

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

Una volta distribuita, è possibile richiamarla con una chiamata HTTP:

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

Hosting e rete CDN

In self-hosting di un portale per sviluppatori è stato suggerito di usare un account di archiviazione di Azure per ospitare il sito Web. Tuttavia, è possibile pubblicare i file tramite qualsiasi soluzione, inclusi i servizi di provider di hosting.

È inoltre possibile anticipare i file con una rete per la distribuzione dei contenuti (CDN), per ridurre i tempi di caricamento delle pagine. È consigliabile usare la rete CDN di Azure.

Passaggi successivi

Altre informazioni sul portale per sviluppatori:

Panoramica del portale per sviluppatori di Gestione API

Condividi tramite