Guide al deploy dei framework
Deploy di Node.js
Esegui il deploy delle tue applicazioni Node.js.
La piattaforma rileva le applicazioni Node.js verificando la presenza di package.json.
Il Build Command predefinito è npm run build. Puoi sostituirlo nelle impostazioni con un comando personalizzato come yarn build o pnpm build.
Il Run Command predefinito è npm start. Puoi modificarlo con comandi come node server.js o pm2-runtime start app.js.
Imposta la versione desiderata di Node.js tramite la variabile d’ambiente NODE_VERSION, ad esempio 18 o 20.
L’applicazione deve ascoltare il traffico in ingresso sulla porta indicata dalla variabile d’ambiente PORT. In caso contrario, non sarà raggiungibile.
Deploy di Python
Esegui il deploy di applicazioni Python con framework come Django e FastAPI.
Le applicazioni Python vengono rilevate automaticamente tramite file standard delle dipendenze come requirements.txt, Pipfile o pyproject.toml.
Imposta PYTHON_VERSION per specificare la versione esatta di Python richiesta, ad esempio 3.11 o 3.12.
In Python, il Build Command viene spesso utilizzato per raccogliere i file statici con python manage.py collectstatic —noinput o applicare le migrazioni. Configuralo nella dashboard.
Per le applicazioni web Python, configura il Run Command con un server WSGI/ASGI standard, ad esempio gunicorn config.wsgi:application oppure uvicorn main:app —host 0.0.0.0 —port $PORT.
Per proteggere il codice, conserva valori sensibili come SECRET_KEY, dettagli di connessione al database e token esclusivamente nelle variabili d’ambiente della dashboard.
Deploy di Laravel
Configurazione consigliata per il deploy di progetti Laravel.
I progetti Laravel vengono riconosciuti ed elaborati tramite composer.json.
Durante il deploy, il sistema installa e compila automaticamente le dipendenze backend con composer install e quelle frontend con npm install e npm run build.
Aggiungi comandi come php artisan optimize o php artisan migrate —force a un Build Command personalizzato per eseguirli durante il deploy.
Imposta PHP_VERSION per specificare la versione esatta di PHP, ad esempio 8.2 o 8.3.
La directory public diventa la radice dei documenti. Inserisci le impostazioni d’ambiente essenziali, inclusi APP_KEY e i dati del database, prima del primo deploy.
Deploy di Go
Compila ed esegui servizi scritti in Golang.
I servizi Go sono adatti alla piattaforma cloud grazie alla loro velocità e al basso consumo di risorse.
La piattaforma identifica moduli e dipendenze tramite go.mod e compila l’applicazione con go build per impostazione predefinita.
Imposta GO_VERSION per specificare la versione esatta di Go, ad esempio 1.21 o 1.22.
Puoi personalizzare sia il Build Command sia il Run Command dalla dashboard.
Il file binario generato viene eseguito come processo principale. Assicurati che riceva le richieste sulla porta fornita tramite la variabile d’ambiente PORT.
Deploy di Ruby
Esegui il deploy di applicazioni Ruby on Rails e Sinatra.
La piattaforma identifica le applicazioni Ruby tramite Gemfile e installa automaticamente le dipendenze con bundle install.
Usa RUBY_VERSION per selezionare la versione di Ruby, ad esempio 3.2 o 3.3.
Per le applicazioni Rails, il sistema gestisce la compilazione degli asset. Modifica il Build Command se necessario per eseguire le migrazioni, ad esempio bundle exec rake db:migrate.
Le applicazioni web vengono solitamente eseguite tramite Puma o Unicorn e il relativo Run Command è configurabile. Ricorda di impostare RAILS_ENV su production.
Deploy di Rust
Compila servizi veloci e sicuri con Rust.
I progetti Rust vengono rilevati tramite Cargo.toml e preparati con cargo build —release.
Imposta la versione desiderata di Rust tramite RUST_VERSION.
Personalizza il Build Command per aggiungere flag o funzionalità e configura il Run Command del file binario risultante secondo necessità.
La compilazione Rust può richiedere tempo a causa delle ottimizzazioni del profilo release, ma produce un file binario veloce e compatto.
Il file binario risultante viene eseguito in un ambiente isolato e deve essere pronto a ricevere richieste HTTP sulla porta fornita tramite PORT.
Deploy di React
Esegui il deploy di applicazioni React lato client (SPA).
Le applicazioni React create con Create React App o Vite sono pienamente supportate.
La piattaforma compila l’applicazione con npm run build e ospita la directory di output, solitamente build o dist, come sito statico su un server web veloce.
Imposta la versione di Node.js necessaria per la compilazione tramite NODE_VERSION.
Se utilizzi un comando di compilazione diverso, come yarn build o pnpm build, configuralo in Build Command.
Poiché l’applicazione è una SPA, le richieste senza corrispondenza (404) restituiscono automaticamente index.html, così il routing lato client, ad esempio React Router, funziona correttamente. I siti statici non richiedono un Run Command.
Deploy di Vue
Esegui il deploy di applicazioni Vue.js lato client.
I progetti Vue.js creati con Vue CLI o Vite vengono compilati durante il deploy.
Il comando predefinito è npm run build. La directory di output, ad esempio dist, viene estratta e servita come sito statico senza un server Node.js.
Come per gli altri framework JavaScript, personalizza la versione di Node.js della compilazione con NODE_VERSION e il comando di compilazione nelle impostazioni.
Come per React, il supporto alla History API del browser per il routing lato client con Vue Router è già configurato.
Deploy di Next.js
Esegui il deploy di applicazioni ibride e con rendering lato server.
Le applicazioni Next.js vengono rilevate automaticamente e configurate in base al tipo di output: Static Export oppure SSR.
Imposta la versione di Node.js per il server e la compilazione con NODE_VERSION.
Per le applicazioni SSR, viene prima eseguito npm run build, poi il Run Command, che per impostazione predefinita è npm start, avvia un servizio Node.js sulla porta assegnata. Puoi modificare entrambi i comandi nella dashboard.
Le funzionalità di Next.js come API Routes e Image Optimization funzionano senza configurazioni aggiuntive.
Deploy di Astro
Crea siti veloci orientati ai contenuti con Astro.
Astro supporta sia l’output statico sia il rendering lato server (SSR). Il sistema rileva e configura automaticamente il progetto.
Imposta NODE_VERSION per modificare la versione di Node.js utilizzata per compilare ed eseguire l’applicazione.
Il Build Command predefinito è npm run build. In modalità statica, la directory dist viene servita dai nostri server web edge come sito statico, senza Run Command.
In modalità SSR, ad esempio con l’adattatore Node, il servizio viene avviato come applicazione dinamica dopo la compilazione. Configura il Run Command nella dashboard, ad esempio node dist/server/entry.mjs.
Deploy di Svelte
Esegui il deploy di applicazioni leggere con Svelte e SvelteKit.
I progetti Svelte standard e le applicazioni SvelteKit vengono rilevati nativamente.
Personalizza la versione di Node.js per compilazione ed esecuzione con NODE_VERSION. Puoi anche modificare il Build Command, ad esempio npm run build.
Per SvelteKit, usa l’adattatore appropriato: solitamente @sveltejs/adapter-node per applicazioni dinamiche oppure @sveltejs/adapter-static per siti completamente statici.
Con adapter-node, esegui l’applicazione come servizio dinamico. Il Run Command predefinito è solitamente node build/index.js e può essere modificato nella dashboard.
Deploy di siti statici
Ospita siti HTML/CSS/JS semplici.
Se nella radice del repository non viene trovato un file delle dipendenze come package.json, la piattaforma tratta l’applicazione come un sito statico semplice.
Per impostazione predefinita, in questa modalità non viene eseguita alcuna compilazione. Tutti i file del repository vengono collocati direttamente sul server web.
Puoi comunque configurare un Build Command personalizzato per eseguire script prima di servire il sito, come script shell o generatori di siti statici Python quali MkDocs.
Questo approccio è adatto a landing page, curriculum, documentazione e siti statici personalizzati senza un framework specifico. I siti statici non richiedono un Run Command.