Fai il deploy di un'app o di un bot Bun

​

Prima di iniziare

• Bun sul tuo computer, dall’installer ufficiale di Bun, oppure il pacchetto npm (npm install bun).
• 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

npm install bun

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Cosa esegue Square Cloud

• START viene 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 esegue npm install --no-audit --no-fund prima di avviarla, che installa anche bun. 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

Bun.serve({
  fetch() {
    return new Response("Hello, World!");
  },
});

​

Preparare il progetto

​

File richiesti

• squarecloud.app, nella radice dello ZIP.
• Il tuo file di ingresso, per esempio index.ts.
• package.json, che elenca bun nelle dependencies. Un upload senza di esso fallisce con INVALID_DEPENDENCY.

​

Cosa lasciare fuori

• node_modules: Square Cloud rimuove questa cartella dal tuo upload e installa le dipendenze da package.json al primo avvio.
• I lockfile: le dipendenze vengono installate con npm, quindi bun.lock non viene usato. La CLI e l’estensione per VS Code escludono anche package-lock.json, yarn.lock e pnpm-lock.yaml per impostazione predefinita; quando ti servono le versioni esatte del tuo package-lock.json, includilo di nuovo con !package-lock.json nel tuo squarecloud.ignore.

​

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.

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

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Prossimi passi

​

Contattaci