Vai al contenuto principale

​
Cos’è Laravel Cloud CLI

laravel/cloud-cli è la CLI per usare Laravel Cloud dal terminale.
Lo strumento è realizzato con Laravel Zero e ti permette di eseguire con il comando cloud le operazioni che faresti dalla dashboard. Con questa CLI puoi gestire in un unico posto applicazioni, ambienti, database, cache, bucket, domini, WebSocket e altro.

​
Requisiti

Prima di installarla, assicurati di soddisfare i seguenti requisiti.
  • PHP 8.2+
  • Composer
  • GitHub CLI (gh) (installato e autenticato)
  • Git

​
Installazione

Per prima cosa, configura la CLI in locale.
1

Clona il repository e installa le dipendenze

gh repo clone laravel/cloud-cli
cd cloud-cli
composer install
2

Configura l'alias `cloud`

zsh:
echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
source ~/.zshrc
bash:
echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
source ~/.bashrc
3

Configurazione manuale con path arbitrario

alias cloud="php /path/to/cloud-cli/cloud"

​
Autenticazione

Autenticati prima di usare la maggior parte dei comandi. 
cloud auth
cloud auth apre il browser e ti autentica via OAuth.
Se vuoi gestire un token per usi CI, usa cloud auth:token. 
cloud auth:token

​
Configurazione del repository

Se non vuoi selezionare application o environment ogni volta nel tuo progetto, esegui cloud repo:config. 
cloud repo:config
Questa configurazione salva valori predefiniti nel repository Git e ti permette di eseguire cloud deploy e simili con comandi brevi.

​
Deploy

È efficiente distinguere il primo deploy dai deploy successivi. 
# Prima volta: creazione dell'app e deploy guidato
cloud ship

# Dalla seconda volta: deploy su un'app esistente
cloud deploy

# Apri la dashboard
cloud dashboard

​
Principali categorie di comandi

Dalla reference dei comandi del README, ecco un riassunto delle categorie di uso quotidiano.
CategoriaEsempi principaliUso
Auth / Configcloud auth, cloud auth:token, cloud repo:configAutenticazione e configurazione predefinita
Applicationcloud application:list, cloud application:createGestione app
Environmentcloud environment:list, cloud environment:get, cloud environment:logsInfo ambiente e visualizzazione log
Deploycloud ship, cloud deploy, cloud deploy:monitorGestione dei deploy
Databasecloud database-cluster:*, cloud database:*, cloud database-snapshot:*Gestione cluster DB, database e snapshot
Cachecloud cache:list, cloud cache:create, cloud cache:typesGestione della cache
Bucketcloud bucket:*, cloud bucket-key:*Gestione dell’object storage
Domaincloud domain:list, cloud domain:create, cloud domain:verifyConfigurazione e verifica dei domini
WebSocketcloud websocket-cluster:*, cloud websocket-application:*Gestione delle risorse Reverb

​
Gestione delle variabili d’ambiente

Le variabili d’ambiente si gestiscono con cloud environment:variables.
Questo comando raccoglie le operazioni di append / set / replace. 
cloud environment:variables
In CI e nell’operatività di team, usa questo comando per uniformare la procedura di modifica delle configurazioni.

​
Verifica dell’utilizzo

Puoi verificare fatturazione e utilizzo delle risorse con cloud usage. 
# Uso del mese corrente
cloud usage

# Visualizzazione dettagliata
cloud usage --detailed

# Uso del periodo precedente
cloud usage --period=previous
Per filtrare per ambiente, usa cloud usage --environment=<id>.
Ultima modifica il 13 luglio 2026

Argomenti correlati

Cloud SessionsLaravel Cloud — la panoramica completa del PaaS dedicato a Laravellaravel/symfony-on-cloud — eseguire app Symfony su Laravel CloudLaravel Cloud Hibernation (sospensione automatica)Laravel Cloud - GitHub Copilot SDK for Laravel