Skip to main content
Il runtime statico serve HTML, CSS, JavaScript, immagini e altri file direttamente dal tuo ZIP, con un web server gestito da Square Cloud. Non c’è nessun tuo processo da mantenere in esecuzione, quindi è il modo più leggero per pubblicare un sito web.

​
Prima di iniziare

  • Un editor di testo per i tuoi file HTML e CSS, come Visual Studio Code.
  • 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.

​
Siti statici e app renderizzate sul server

Un sito statico è un insieme di file uguale per ogni visitatore: semplici pagine HTML, o l’output della build di un framework come Vite, React, Vue, Angular, Astro o Gatsby. Il runtime statico serve quei file così come sono. Un’app renderizzata sul server genera le pagine a ogni richiesta, con codice lato server come Next.js, Nuxt, React Router o un’API. Ha bisogno di un processo sempre in esecuzione, quindi gira su un runtime di linguaggio, come il runtime Node.js, con un file MAIN o un comando START. Se il tuo framework può fare entrambe le cose, una build statica è la scelta più leggera. Ogni guida ai framework indica quali opzioni supporta.

​
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 MAIN che punta a un file HTML seleziona il runtime statico:
squarecloud.app
512 MB è la memoria minima per un sito web, e basta ampiamente per dei file statici.

​
Come il runtime statico serve i file

  • La radice dello ZIP è la radice del tuo sito: about.html viene servito su /about.html, e blog/index.html su /blog/.
  • / serve vite.html se esiste, altrimenti index.html.
  • Quando un percorso non corrisponde a nessun file, il runtime serve vite.html se esiste. Questo mantiene funzionanti al ricaricamento le route lato client delle app single-page, qualunque sia il framework: rinomina l’index.html della build in vite.html.
  • Senza vite.html, i percorsi sconosciuti restituiscono il tuo 404.html, o una pagina 404 predefinita se non ne hai uno.
  • I file vengono compressi al volo, e il tuo file squarecloud.app non viene mai servito.
Ogni file nello ZIP è pubblico. Non caricare codice sorgente, file .env o qualsiasi altra cosa che non vuoi far scaricare ai visitatori.

​
Preparare il progetto

Metti i tuoi file nella radice dello ZIP, accanto a squarecloud.app:
  • index.html, oppure vite.html per un’app single-page.
  • I tuoi CSS, JavaScript, immagini e font, con qualsiasi struttura di cartelle.
  • 404.html, facoltativo: la pagina per i percorsi che non esistono.
Per la build di un framework, comprimi il contenuto della cartella di output della build, non la cartella stessa.

​
Guide ai framework

Ogni guida mostra il comando di build, la cartella di output e come pubblicarla sul runtime statico.

Vite

React

Vue

Angular

Astro

Gatsby

Preact

Qwik

SolidJS

Nuxt

​
Risoluzione dei problemi

La pagina dice “Hi, I’m Square Shield”: il runtime non ha trovato index.html o vite.html nella radice dello ZIP. Probabilmente hai compresso la cartella della build invece del suo contenuto: comprimi i file che contiene.
La tua app single-page gestisce le route nel browser. Rinomina il suo index.html in vite.html così i percorsi sconosciuti caricano l’app, e aggiorna MAIN.
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.