Vai al contenuto principale

​
🚀 Introduzione

  • Prima di iniziare, puoi scegliere di utilizzare il runtime Deno nel tuo progetto. Se non hai ancora Deno installato localmente, hai due opzioni principali:
  • Installazione tramite npm (consigliata per la compatibilità con npx durante il deploy): 
npm install deno
  • Oppure installa Deno tramite l’installer ufficiale (consulta la documentazione di Deno per le istruzioni di installazione nativa).
  • Aggiungendo deno come dipendenza, puoi utilizzare npx deno nel campo START di squarecloud.app per avviare la tua applicazione con Deno. Vedi più avanti nella sezione “Avviare l’applicazione” per esempi di START.
  • Successivamente, dovrai creare un account su Square Cloud, cosa che puoi fare tramite la pagina di accesso. Puoi usare la tua email, GitHub o entrambi per creare l’account.
  • Infine, devi avere un piano a pagamento attivo sul tuo account. Puoi visualizzare i nostri piani e acquistarne uno in base alle tue esigenze qui.

​
⚙️ Configurazione del file squarecloud.app

Se stai caricando la tua applicazione tramite il sito web di Square Cloud, puoi ignorare questa sezione. Il sito crea automaticamente il file di configurazione squarecloud.app per te.

Scopri di più: come creare il file di configurazione per Square Cloud.

Il file squarecloud.app è un file di configurazione che verrà utilizzato per configurare la tua applicazione; servirà a definire il nome, la descrizione, la versione, il file principale, tra le altre cose.

​
▶️ Come avviare la tua applicazione

  • Per utilizzare il runtime Deno nell’ambiente Node.js di Square Cloud, aggiungi prima il pacchetto deno al tuo progetto (ad esempio npm install deno) in modo che il comando npx deno sia disponibile nell’ambiente di runtime.
  • Quindi, imposta il campo START nel tuo squarecloud.app con il comando che avvia la tua applicazione usando Deno. Esempi:
OR .config
START=npx deno run --allow-net --allow-env main.ts
Se utilizzi task definiti in deno.json, puoi avviare così: 
START=npx deno task start
  • Regola i permessi (--allow-net, --allow-env, --allow-read, ecc.) in base alle esigenze della tua applicazione.
  • Ricorda: se il campo START è definito, il valore in esso contenuto verrà eseguito direttamente. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.
  • Se utilizzi moduli npm con Deno e la cartella node_modules non esiste, Square Cloud eseguirà npm install --no-package-lock --no-audit --no-fund per installare le dipendenze e pulire la cartella .npm.
Se intendi utilizzare Deno come runtime, ti consigliamo di aggiungere deno come dipendenza (npm install deno) per garantire che npx deno sia disponibile nell’ambiente di runtime durante il deploy. Nei progetti in cui preferisci utilizzare l’installer nativo di Deno, verifica la compatibilità e i requisiti di build prima di optare per questo approccio.

​
🖥️ Preparare il progetto

​
📁 File di configurazione essenziali

Quando prepari il tuo progetto Deno per il deploy su Square Cloud, assicurati di includere il file di configurazione (squarecloud.app/.config) e i file essenziali della tua applicazione all’interno di un file zip.
Il file di configurazione (squarecloud.app/.config) deve trovarsi nella radice del file zip. Altrimenti, Square Cloud non sarà in grado di trovarlo durante il deploy.

​
🗑️ File da escludere prima del caricamento

  • node_modules: Necessaria solo se utilizzi moduli npm; altrimenti, non caricarla per ridurre la dimensione del caricamento.
  • package-lock.json: L’ambiente di produzione installerà le dipendenze in base a package.json quando viene rilevato l’uso di npm.
  • deno_dir o .cache/deno: Directory della cache di Deno; non necessaria per il deploy.

​
🤔 Perché escludere questi file?

Ci sono diverse ragioni per escludere node_modules, package-lock.json e la cache di Deno prima di caricare il tuo progetto:
  1. Coerenza dell’installazione: Non caricare node_modules garantisce che le dipendenze vengano installate dall’ambiente di produzione, con il risultato di una build coerente e priva di discrepanze del sistema locale.
  2. Installazioni aggiornate: L’ambiente di produzione installerà le versioni compatibili più recenti delle dipendenze elencate in package.json (quando applicabile) o utilizzerà gli import remoti definiti in deno.json.
  3. Riduzione delle dimensioni del caricamento: Non includere queste directory riduce la dimensione del file caricato, velocizzando il processo di caricamento e rendendo il deploy più efficiente.
Facendo questo, garantisci che la tua applicazione Deno sia preparata in modo ottimale per l’hosting su Square Cloud.

​
📄 File richiesti

Tre file sono necessari per ospitare il tuo progetto Deno:
  • squarecloud.app/.config
  • mainFile.ts/.js (Esempio di file principale)
  • deno.json o deno.jsonc (definizione di permessi e task). Se utilizzi moduli npm, includi anche package.json.

​
💡 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, oppure il percorso è sbagliato. Se il tuo file principale si trova all’interno di una cartella, ad esempio, devi indicare folder/file.ts o folder/file.js.
La quantità minima di RAM richiesta per ospitare un bot è 256MB e per un sito/API è 512MB. Tuttavia, a seconda delle dimensioni 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.

​
📤 Come ospitare il tuo progetto

Ora che hai preparato tutti i file per il tuo progetto Deno, il passo successivo è caricarli su Square Cloud e mettere online la tua applicazione. Esistono diversi modi per caricare, ma ne tratteremo due: tramite Dashboard o tramite CLI.

​
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

​
Tramite CLI

Per utilizzare questo metodo, devi creare un file di configurazione chiamato squarecloud.app nella directory principale del tuo progetto. Questo file conterrà la configurazione necessaria per il tuo progetto.

Scopri di più su: come creare il file di configurazione per Square Cloud.

Il file squarecloud.app è un file di configurazione che verrà utilizzato per configurare la tua applicazione; verrà usato per definire il tuo ambiente.
1

Installa la CLI

Per prima cosa, devi avere la CLI installata nel tuo ambiente. Se non la hai ancora, esegui il seguente comando nel tuo terminale:
npm install -g @squarecloud/cli
Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:
squarecloud update
2

Autenticati

Ora, per autenticarti e utilizzare gli altri comandi della CLI, troverai la tua chiave di autorizzazione qui cliccando su “Request API Key”. Dopo aver ottenuto la tua chiave di autorizzazione, esegui il seguente comando:
squarecloud auth login
3

Carica il tuo progetto

Infine, per eseguire il deploy della tua applicazione su Square Cloud tramite la CLI, devi eseguire il seguente comando:
squarecloud upload
Oppure, se hai creato lo zip manualmente, puoi usare:
squarecloud upload --file <path/to/zip>

​
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.