npx deno.
Prima di iniziare
- Deno sul tuo computer, dall’installer ufficiale di Deno, oppure il pacchetto npm (
npm install deno). - 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.deno alle dependencies del tuo progetto, così il comando npx deno è disponibile su Square Cloud. Non aggiungerlo alle devDependencies: in produzione non vengono installate.
RUNTIME=nodejs e avvia la tua app con Deno nel campo START, con i permessi di cui ha bisogno. Un file di configurazione completo per ogni tipo di app:
- Bot o worker
- Sito web o API
squarecloud.app
--allow-net, --allow-env, --allow-read e altri) a ciò che usa la tua app. Se usi i task definiti in deno.json, avvia con START=npx deno task start.
Cosa esegue Square Cloud
STARTviene eseguito direttamente. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.- Se l’app non ha una cartella
node_modules, Square Cloud eseguenpm install --no-audit --no-fundprima di avviarla, che installa anchedenoe tutti i moduli npm elencati inpackage.json. I pacchetti indevDependenciesnon vengono installati, perché il runtime impostaNODE_ENV=production. Quandonode_modulesesiste già, il passaggio di installazione viene saltato.
Porta e host per siti web e API
Deno.serve() ascolta sulla porta 8000 per impostazione predefinita e non legge la variabile d’ambiente PORT. Passa tu la porta e l’host: Square Cloud imposta PORT a 80, e 0.0.0.0 accetta connessioni dall’esterno del container.
main.ts
PORT richiede --allow-env, e servire richieste richiede --allow-net, come negli esempi di START qui sopra.
Preparare il progetto
File richiesti
squarecloud.app, nella radice dello ZIP.- Il tuo file di ingresso, per esempio
main.ts. package.json, che elencadenonelledependencies. Un upload senza di esso fallisce conINVALID_DEPENDENCY.- Facoltativamente, un
deno.jsonodeno.jsoncper task, import e altre impostazioni di Deno.
Cosa lasciare fuori
node_modules: Square Cloud rimuove questa cartella dal tuo upload e installa le dipendenze dapackage.jsonal primo avvio.deno_diro.cache/deno: la cartella della cache di Deno, che Deno riempie di nuovo sul server.- I lockfile: la CLI e l’estensione per VS Code escludono
package-lock.json,yarn.lockepnpm-lock.yamlper impostazione predefinita. Quando ti servono le versioni esatte del tuopackage-lock.json, includilo di nuovo con!package-lock.jsonnel tuosquarecloud.ignore.
Risoluzione dei problemi
PermissionDenied: Requires net or env access
PermissionDenied: Requires net or env access
Deno blocca l’accesso alla rete e all’ambiente a meno che tu non lo consenta. Aggiungi al tuo comando
START il flag indicato nell’errore, come --allow-net o --allow-env.Memoria insufficiente
Memoria insufficiente
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 vada in crash.
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.
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.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

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
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.
Tramite CLI
Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamatosquarecloud.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 Per caricare uno zip che hai creato tu, passalo con
squarecloud.ignore, e la carica:--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.
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.

