Vai al contenuto principale
Il runtime Node.js esegue bot, API e siti web renderizzati sul server in JavaScript e TypeScript. Square Cloud installa le tue dipendenze da package.json e avvia la tua app con Node.js.

​
Prima di iniziare

  • Node.js e npm sul tuo computer. Se non li hai, scaricali dal sito ufficiale di Node.js.
  • Un account Square Cloud: registrati con la tua email o con GitHub.
  • Un piano attivo. Consulta i piani e scegli quello adatto al tuo progetto.

​
Configurare Square Cloud

Se carichi la tua applicazione tramite la dashboard, puoi saltare questa sezione: la dashboard crea per te il file di configurazione squarecloud.app.

Riferimento del file di configurazione

Il file squarecloud.app indica a Square Cloud come eseguire la tua applicazione: file principale, memoria, versione del runtime, nome e, per un sito, il sottodominio.
Un file di configurazione completo per ogni tipo di app:
squarecloud.app
VERSION=recommended esegue l’attuale linea LTS di Node.js, e VERSION=latest la release più recente.

​
Cosa esegue Square Cloud

  • Se il campo START non è definito nel file di configurazione, Square Cloud esegue node MAIN. Quando l’app ha 1024 MB di memoria o più, aggiunge --max_old_space_size=<MEMORY> (il limite dell’heap di Node.js, in MB). Se il campo START è definito, verrà eseguito direttamente il valore in esso contenuto. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.
  • Se l’app non ha una cartella node_modules, Square Cloud esegue npm install --no-audit --no-fund prima di avviarla. I pacchetti in devDependencies non vengono installati, perché il runtime imposta NODE_ENV=production. Quando node_modules esiste già, il passaggio di installazione viene saltato.

​
Porta e host per siti web e API

Square Cloud imposta la variabile d’ambiente PORT a 80 e HOST a 0.0.0.0. Il tuo server deve ascoltare su quella porta e su tutte le interfacce di rete, per esempio con Express:
Next.js, Nuxt, React Router, Astro e SolidStart leggono PORT da soli: le loro guide ai framework indicano quando non c’è niente da cambiare.

​
Preparare il progetto

​
File richiesti

  • squarecloud.app, nella radice dello ZIP.
  • Il tuo file principale, per esempio index.js o src/index.ts.
  • package.json, con le tue dipendenze. Un upload senza di esso fallisce con INVALID_DEPENDENCY.
Il file di configurazione (squarecloud.app) deve trovarsi nella radice del file zip. Altrimenti, Square Cloud non riuscirà a trovarlo durante il deploy.
Square Cloud esegue TypeScript in modo nativo con tsx (npx tsx MAIN), ma per la produzione è comunque consigliato compilare in JavaScript: esegui la build sul tuo computer e punta MAIN al file compilato.

​
Cosa lasciare fuori

  • node_modules: Square Cloud rimuove questa cartella dal tuo upload e installa le dipendenze da package.json al primo avvio. Così l’upload resta piccolo e le dipendenze vengono compilate per il sistema del server.
  • I lockfile (package-lock.json, yarn.lock, pnpm-lock.yaml): la CLI e l’estensione per VS Code li escludono per impostazione predefinita, quindi npm installa le versioni più recenti consentite dagli intervalli in package.json. Quando ti servono le versioni esatte del tuo lockfile, includilo di nuovo con !package-lock.json nel tuo squarecloud.ignore.

​
Guide ai framework

Express

Fastify

NestJS

Next.js

Nuxt

React Router

Angular

Astro

SolidJS

Qwik

React

Vue

Le app single-page generate con Vite, React, Vue o Preact possono girare anche senza Node.js, sul runtime statico.

​
Risoluzione dei problemi

Questo errore si verifica quando il file definito come “main” per la tua applicazione nel file di configurazione non esiste, è scritto in modo errato o il percorso è sbagliato. Se il tuo file principale si trova all’interno di una cartella, ad esempio, devi specificare folder/file.js.
La quantità minima di RAM richiesta per ospitare un bot è 256MB e per un sito/API è 512MB. Tuttavia, a seconda della dimensione e della complessità della tua applicazione, potrebbe essere consigliabile allocare una quantità maggiore di RAM per evitare che la tua applicazione esaurisca la memoria e si arresti.
Per altri problemi, consulta Risoluzione dei problemi.

​
Deploy

​
Tramite dashboard

1

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.
2

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.
3

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.
Caricamento dell'applicazione su Square Cloud
4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.
La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​
Tramite CLI

Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamato squarecloud.app nella sua radice. Indica a Square Cloud come eseguire la tua applicazione.

Guida al file di configurazione

Scopri come creare il file di configurazione squarecloud.app che definisce l’ambiente della tua applicazione.
1

Installa la CLI

Installa la CLI di Square Cloud. Se ce l’hai già, esegui lo stesso comando per aggiornarla:
2

Accedi

Esegui il comando qui sotto. Apre il tuo browser: approva l’accesso lì e la CLI è pronta. Non c’è nessuna chiave API da copiare. Per script e CI, consulta Autenticazione della CLI.
3

Carica il tuo progetto

Dalla cartella del tuo progetto, esegui il comando qui sotto. La CLI comprime la cartella corrente, escludendo ciò che elenca squarecloud.ignore, e la carica:
Per caricare uno zip che hai creato tu, passalo con --file:
4

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.
La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

​
Prossimi passi

Variabili d'ambiente

Tieni segreti e impostazioni fuori dal codice e leggili in fase di esecuzione.

Dominio personalizzato

Pubblica la tua app sul tuo dominio, dal piano Standard in su.

Risoluzione dei problemi

Sistema un’app che non si avvia o un sito che non risponde.

​
Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.