Laravel Cloud CLI — usa Laravel Cloud dal terminale

Come gestire dal terminale app, ambienti, database, domini e altre risorse di Laravel Cloud usando laravel/cloud-cli.

​

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.

Categoria	Esempi principali	Uso
Auth / Config	cloud auth, cloud auth:token, cloud repo:config	Autenticazione e configurazione predefinita
Application	cloud application:list, cloud application:create	Gestione app
Environment	cloud environment:list, cloud environment:get, cloud environment:logs	Info ambiente e visualizzazione log
Deploy	cloud ship, cloud deploy, cloud deploy:monitor	Gestione dei deploy
Database	cloud database-cluster:*, cloud database:*, cloud database-snapshot:*	Gestione cluster DB, database e snapshot
Cache	cloud cache:list, cloud cache:create, cloud cache:types	Gestione della cache
Bucket	cloud bucket:*, cloud bucket-key:*	Gestione dell’object storage
Domain	cloud domain:list, cloud domain:create, cloud domain:verify	Configurazione e verifica dei domini
WebSocket	cloud 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>.