🚀 Introduzione
- Prima di iniziare, assicurati che Node.js e npm siano installati sul tuo sistema. Se non li hai ancora, puoi scaricarli dal sito ufficiale di Node.js.
- Successivamente, dovrai creare un account su Square Cloud, operazione che può essere effettuata 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 consultare 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.
📄 File richiesti
- JavaScript
- TypeScript
- Se il campo
STARTnon è definito nel file di configurazione, Square Cloud eseguirà di defaultnodecon opzioni di ottimizzazione e parametri specifici. Se il campoSTARTè definito, verrà eseguito direttamente il valore in esso contenuto. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.
- Se la cartella
node_modulesnon esiste, Square Cloud eseguirànpm install --no-package-lock --no-audit --no-fundper installare le dipendenze e pulire la cartella.npm.
🖥️ Preparare il progetto
📁 File di configurazione essenziali
Quando prepari il tuo progetto Node.js 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.
🗑️ File da escludere prima del caricamento
node_modules: Questa cartella non deve essere caricata, poiché verrà ricreata durante l’installazione in produzione.package-lock.json: Questo file non è necessario, poiché l’ambiente di produzione installerà le dipendenze basandosi supackage.json.
🤔 Perché escludere questi file?
Esistono diverse ragioni per escluderenode_modules e package-lock.json prima di caricare il tuo progetto:
-
Coerenza dell’installazione: Non caricare
node_modulesgarantisce che le dipendenze vengano installate dall’ambiente di produzione, risultando in una build coerente e priva di discrepanze del sistema locale. -
Installazioni aggiornate: L’ambiente di produzione installerà le versioni compatibili più recenti delle dipendenze elencate in
package.json, offrendo un punto di partenza pulito per la tua applicazione. - Riduzione della dimensione del caricamento: Non includere queste cartelle riduce la dimensione del file caricato, velocizzando il processo di caricamento e rendendo il deploy più efficiente.
📄 File richiesti
Sono necessari tre file per ospitare il tuo progetto Node:- squarecloud.app/.config
- mainFile.js/.ts (Esempio di file principale)
- package.json (File delle dipendenze)
Square Cloud supporta
TypeScript in modo nativo, eseguendo il tuo progetto tramite
ts-node, ma è sempre consigliato compilare in JavaScript, poiché siamo
una piattaforma di produzione.💡 Risoluzione dei problemi
Il file principale non è valido o è corrotto
Il file principale non è valido o è corrotto
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.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 si arresti.
📤 Come ospitare il tuo progetto
Ora che hai preparato tutti i file per il tuo progetto Node.js, il passo successivo è caricarli su Square Cloud e mettere online la tua applicazione. Esistono diversi modi per effettuare il caricamento, ma ne tratteremo due: tramite Dashboard o tramite CLI.Tramite dashboard
Accedi alla pagina di upload
Accedi alla pagina di upload e carica il file zip del tuo progetto.
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.
Tramite CLI
Per utilizzare questo metodo, devi creare un file di configurazione chiamatosquarecloud.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.
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:Se la hai già, ti consigliamo di aggiornarla. Per farlo, esegui il seguente comando nel tuo terminale:
- Windows
- Linux, macOS e WSL
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: