Laravel Cloud CLI — Operar Laravel Cloud desde la terminal

Cómo gestionar apps, entornos, bases de datos, dominios y demás recursos de Laravel Cloud desde la terminal usando laravel/cloud-cli.

​

¿Qué es Laravel Cloud CLI?

laravel/cloud-cli es el CLI para operar Laravel Cloud desde la terminal. Esta herramienta está construida con Laravel Zero, y puedes ejecutar mediante el comando cloud las operaciones que se hacen en el dashboard.

Con este CLI puedes gestionar de forma unificada aplicaciones, entornos, bases de datos, cachés, buckets, dominios y WebSocket.

​

Requisitos

Antes de instalarlo, cumple los siguientes requisitos.

• PHP 8.2+
• Composer
• GitHub CLI (gh) (instalado y autenticado)
• Git

​

Instalación

Primero, prepara el CLI localmente.

1. Obtén el repositorio e instala las dependencias

   gh repo clone laravel/cloud-cli
   cd cloud-cli
   composer install
   
2. Configura el alias `cloud`

   zsh:

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.zshrc
   source ~/.zshrc
   

   bash:

   echo 'alias cloud="php '$(pwd)'/cloud"' >> ~/.bashrc
   source ~/.bashrc
   
3. Configuración manual con una ruta arbitraria

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

​

Autenticación

Antes de usar la mayoría de comandos, autentícate.

cloud auth

cloud auth abre el navegador y se autentica por OAuth. Si quieres gestionar un token para CI u otros usos, utiliza cloud auth:token.

cloud auth:token

​

Configuración del repositorio

Si no quieres elegir application o environment cada vez en tu proyecto, ejecuta cloud repo:config.

cloud repo:config

Esta configuración guarda valores por defecto en el repositorio Git y permite ejecutar cloud deploy y demás con comandos más cortos.

​

Despliegue

Es eficiente diferenciar entre el primer despliegue y los despliegues continuos.

# Primera vez: creación y despliegue guiado de la app
cloud ship

# A partir de la segunda vez: desplegar en una app existente
cloud deploy

# Abrir el dashboard
cloud dashboard

​

Principales categorías de comandos

Resumen de las categorías de uso diario, según la referencia de comandos del README.

Categoría	Ejemplos de comandos principales	Uso
Auth / Config	cloud auth, cloud auth:token, cloud repo:config	Autenticación y configuración por defecto
Application	cloud application:list, cloud application:create	Gestión de apps
Environment	cloud environment:list, cloud environment:get, cloud environment:logs	Información del entorno y logs
Deploy	cloud ship, cloud deploy, cloud deploy:monitor	Gestión de despliegues
Database	cloud database-cluster:*, cloud database:*, cloud database-snapshot:*	Gestión de clusters de BD, BDs y snapshots
Cache	cloud cache:list, cloud cache:create, cloud cache:types	Gestión de cachés
Bucket	cloud bucket:*, cloud bucket-key:*	Gestión de almacenamiento de objetos
Domain	cloud domain:list, cloud domain:create, cloud domain:verify	Configuración y verificación de dominios
WebSocket	cloud websocket-cluster:*, cloud websocket-application:*	Gestión de recursos relacionados con Reverb

​

Gestión de variables de entorno

Las variables de entorno se gestionan con cloud environment:variables. Este comando permite manejar de forma conjunta operaciones como append, set o replace.

cloud environment:variables

En CI o para la gestión de equipo, usa este comando para unificar el procedimiento de cambios de configuración.

​

Comprobación del uso

Puedes revisar la facturación y el uso de recursos con cloud usage.

# Uso del mes actual
cloud usage

# Vista detallada
cloud usage --detailed

# Uso del periodo anterior
cloud usage --period=previous

Si quieres filtrar por entorno, usa cloud usage --environment=<id>.