Fai il deploy e controlla le tue applicazioni dal terminale
Accedi con un codice nel browser, fai il deploy di qualsiasi cartella con un solo comando e raggiungi log, database e spazi di lavoro dallo stesso prompt, con un output che i tuoi script sanno leggere.
Installa con un solo comando
Lo script di installazione e il pacchetto npm scaricano la build per il tuo sistema dall’ultima release e ne verificano il checksum prima di installarla.
macOS, Linux e WSL
curl -fsSL https://cli.squarecloud.app/install | bashSi installa in /usr/local/bin, quindi potrebbe chiederti la password.
Windows
npm i -g @squarecloud/cliRichiede Node.js con npm. Lo stesso comando funziona anche su macOS e Linux.
- Verificata con i checksum SHA-256 della release
- Build per x86 e ARM, Apple silicon compreso
- Per aggiornare, esegui di nuovo lo stesso comando
Accedi senza copiare nessuna chiave
La CLI mostra un codice, lo approvi nel browser e il terminale riceve una chiave tutta sua, come si connette l’estensione per VS Code.
- 1
Il terminale mostra un codice
Esegui il comando di accesso e il browser si apre sulla pagina di approvazione, mentre il terminale mostra un codice di otto caratteri e un conto alla rovescia.
- 2
Lo approvi nel browser
Digita il codice nella pagina di Square Cloud e approva. Non inserire mai un codice che ti ha mandato qualcun altro.
- 3
La CLI è connessa
Il terminale conferma il tuo account e salva una chiave creata apposta, con solo i permessi che usano i suoi comandi.
- Ogni chiave dura 90 giorni, e
auth whoamimostra fino a quando - Chiede prima di sostituire un altro account su questa macchina
- Via SSH,
--no-browserstampa il link da aprire ovunque - Hai già una chiave? Usa
--tokeno--with-token
Fai il deploy da qualsiasi cartella
Carica la cartella in cui ti trovi come nuova applicazione, invia modifiche a una già esistente oppure collega un repository GitHub perché ogni push ne faccia il deploy.
Carica un’applicazione
La CLI comprime la cartella corrente con le tue regole di esclusione, crea l’applicazione e mostra il link alla sua pagina nella dashboard.
uploadupload --file- Oppure invia uno zip che hai già
- Scrive il nuovo ID in squarecloud.app, se il progetto ne ha uno
Commit delle modifiche
Invia la cartella, o uno zip, a un’applicazione già esistente. Mantiene ID, dominio e impostazioni.
commitcommit -rcommit --path- Riavvia l’applicazione dopo, se lo chiedi
- Può mettere i file in una cartella dell’applicazione
Deploy a ogni push
Collega un repository e un branch tramite la GitHub App di Square Cloud, oppure crea un webhook con un token GitHub, senza uscire dal terminale.
app deploy github linkapp deploy webhookapp deploy list- Elenca i deploy recenti con commit, stato e branch
- Oppure esegui la CLI in GitHub Actions
Un solo file di esclusione per la CLI e VS Code
upload, commit e zip lasciano fuori ciò che squarecloud.ignore elenca nella radice del progetto. L’estensione per VS Code legge lo stesso file, con le stesse regole.
La sintassi di .gitignore
#per i commenti,!per recuperare un percorso,dir/solo per le cartelle,/buildsolo nella radice, più*,?,[abc]e**. Vince l’ultima riga che corrisponde, senza distinzione tra maiuscole e minuscole.Esclusioni predefinite
node_modules,.git,.github,.vscodee i lockfile di npm, pnpm e Yarn restano fuori prima delle tue regole. Una riga come!yarn.lockne recupera uno.Controlla prima di inviare
squarecloud zipcrea lo stesso archivio nella tua cartella, così puoi aprirlo e vedere esattamente cosa verrebbe caricato.
Le variabili arrivano esattamente come le hai scritte
La tua applicazione carica le variabili tramite una shell. Dalla versione 3.1.1, la CLI invia tra virgolette i valori con spazi o caratteri come $, & o ;, così la shell non può troncarli né espanderli.
Dal terminale
Passa tutte le coppie KEY=VALUE che vuoi. La CLI prende l’applicazione da squarecloud.app o ti fa sceglierla da un elenco.
app env setapp env list- Virgolette singole, o doppie se il valore ne contiene una
- Un valore già tra virgolette viene inviato così com’è
Da un file .env
Legge le righe KEY=VALUE da un file e salta commenti e righe vuote. Funzionano anche le righe che iniziano con export e i valori tra virgolette.
--from-file .env- Funziona quando imposti o sostituisci variabili
- L’elenco le mostra di nuovo come KEY=VALUE
Modifiche in blocco
Sostituisci tutte le variabili in una volta o rimuovile tutte. Entrambe le azioni chiedono conferma prima di cambiare qualcosa, e la sostituzione richiede almeno una variabile nuova.
app env replaceapp env remove --all-y- Un flag conferma al posto tuo negli script
- Rispondi no e non cambia nulla
Pensata per script e CI
Output che un programma sa leggere, codici di uscita che dicono il vero e una chiave che funziona senza browser.
JSON su richiesta
I comandi che stampano dati possono rispondere in JSON, con solo il risultato su stdout. Gli altri rifiutano il flag con un errore invece di stampare testo su cui un parser inciamperebbe.
--jsonCodici di uscita
Ogni errore termina con 1. Quando una conferma non si può chiedere, senza terminale e senza un flag che risponda, il comando fallisce e non cambia nulla.
-yUno stdout pulito
Errori, domande e avvisi vanno su stderr, e con il JSON anche l’avanzamento, così una pipe trasporta solo il risultato.
stdoutstderrUna chiave per la CI
Imposta una chiave del tuo account come variabile d’ambiente e ogni comando la usa, senza login. Con CI impostato a true, il login dal browser non parte.
SQUARECLOUD_API_KEYCI=trueTrace senza segreti
Una variabile stampa su stderr metodo, percorso, stato e durata di ogni chiamata all’API, mai header, query string o body.
SQUARECLOUD_DEBUG=1GitHub Actions
La Action di Square Cloud installa la CLI sul runner, la verifica con i checksum della release ed esegue qualsiasi comando con la tua chiave.
squarecloudofc/github-action@v2
Anche il resto della piattaforma
Log, metriche, file, snapshot, domini, database e spazi di lavoro, ognuno a un comando di distanza.
Log e stream dal vivo
Stampa le ultime righe o segui l’output dal vivo insieme a ogni cambio di stato. Ciò che la tua applicazione scrive su stderr resta su stderr.
app logsapp realtimeStato e metriche
CPU, memoria, disco e uptime per un’applicazione o una riga per ciascuna, più le metriche delle ultime 24 ore.
app status --allapp metricsFile remoti
Elenca, leggi, scrivi, sposta ed elimina i file dell’applicazione. Scrivere da un file mantiene intatti i binari, e leggere in un file chiede prima di sovrascriverlo.
app file readapp file writeSnapshot
Crea uno snapshot e scaricalo, elencane le versioni e ripristinane una, per applicazioni e database.
app snapshot createdb snapshot restoreDomini e traffico
Imposta un dominio personalizzato, ottieni i record DNS da creare, leggi analytics, errori e prestazioni dall’edge e svuota la cache.
app network domainapp network analyticsDatabase
Crea database MongoDB, MySQL, PostgreSQL e Redis, avviali o arrestali, scarica il certificato TLS e ruota la password.
db createdb credentials reset
Attenta, aperta e nella tua lingua
In otto lingue
Messaggi, guida e tabelle seguono la lingua di visualizzazione del tuo sistema a ogni avvio. LC_ALL ne sceglie un’altra per un singolo comando.
Niente ID a memoria
La maggior parte dei comandi prende l’applicazione da squarecloud.app o elenca le tue per fartene scegliere una.
Chiede conferma
Eliminare, sostituire tutte le variabili, ripristinare uno snapshot o svuotare la cache chiede prima conferma, e gli script possono confermare con un flag.
Open source
Il codice è su GitHub, e ogni release pubblica le sue build con checksum SHA-256.
Un piano per ogni fase del tuo progetto
Inizia in piccolo e scala quando ne hai bisogno, senza contratti di permanenza.
Hobby
Per validare idee, bot e progetti personali
A partire da 12,49 BRL/mese ≈ 2,00 €
- 1 GB di RAM
- 1 vCPU
- Fino a 4 progetti
- Scala fino a 2 GB nello stesso piano
Standard
ConsigliatoPer la produzione, con database e dominio personalizzato
A partire da 44,99 BRL/mese ≈ 7,20 €
- 4 GB di RAM
- 4 vCPU
- Fino a 16 progetti
- Scala fino a 8 GB nello stesso piano
Pro
Per l'alta scala, con snapshot giornalieri delle applicazioni e analytics avanzati
A partire da 124,99 BRL/mese ≈ 20,00 €
- 12 GB di RAM
- 6 vCPU
- Fino a 48 progetti
- Scala fino a 24 GB nello stesso piano
4,9 su 5 · 402 recensioni su Google + TrustpilotTrustpilot