Skip to main content
  • upload crea una nuova applicazione, con un nuovo ID.
  • commit invia file a un’applicazione che esiste già e ne mantiene ID, dominio e impostazioni.
  • zip crea lo stesso zip in locale, senza inviarlo, così puoi controllare cosa contiene.
upload e commit esistono anche sotto squarecloud app (squarecloud app upload, squarecloud app commit). Sei alle prime armi? Parti dalla Guida rapida.

​
Cosa finisce nello zip

upload, commit e zip comprimono la cartella corrente ed escludono ciò che elenca squarecloud.ignore, nella radice del progetto. Il file usa la sintassi di .gitignore ed è lo stesso che legge l’estensione per VS Code.
  • Sempre esclusi per primi: node_modules, .git, .github, .vscode, package-lock.json, pnpm-lock.yaml e yarn.lock. Le dipendenze vengono installate sulla piattaforma a partire dal tuo manifest. Per inviare un lockfile perché ti servono versioni bloccate, aggiungi una regola !, come !package-lock.json.
  • Link: un link simbolico a un file viene compresso come quel file; i link a cartelle e i link non validi vengono saltati con un avviso su stderr.
  • I vecchi nomi del file (.squareignore, .squarecloudignore, square.ignore) vengono ancora letti quando manca squarecloud.ignore, con un avviso che invita a rinominarlo.

​
squarecloud upload

Utilizzo
Comprime la cartella corrente e crea da essa una nuova applicazione. La cartella deve contenere un file squarecloud.app o squarecloud.config.
Output
Dopo un upload riuscito, la CLI scrive ID=<appID> nel file di configurazione della cartella corrente, così i comandi successivi sanno a quale app ti riferisci. Vedi dove viene salvato l’ID dell’app. Con --json, stdout contiene solo l’applicazione creata (ID, nome, descrizione, dominio, cluster, memoria, CPU e linguaggio) in formato JSON; i messaggi di avanzamento vanno su stderr.

​
squarecloud commit

Utilizzo
Alias: squarecloud push, squarecloud app commit, squarecloud app push Comprime la cartella corrente e la invia a un’applicazione esistente. L’ID viene preso dall’argomento o dalla riga ID= del file di configurazione. A differenza degli altri comandi, commit non apre mai un selettore: senza nessuno dei due, si ferma con exit code 1.
Output
I commit di grandi dimensioni non vengono interrotti da un timeout. commit non ha un output JSON.

​
squarecloud zip

Utilizzo
Comprime la cartella corrente nello stesso modo di upload e commit e la salva come <folder name>.zip dentro quella cartella, sostituendo un file esistente con lo stesso nome. Non richiede il login.
Output
Se lo zip non può essere scritto, la CLI stampa Couldn't zip your application. con il motivo; se un vecchio <folder name>.zip non può essere eliminato, lo segnala. In entrambi i casi termina con codice 1.

​
Correlati

Per effettuare invece il deploy a ogni push, vedi Deploy da GitHub.