Zeabur CLI

Zeabur CLI te permite gestionar todos los recursos de Zeabur desde tu terminal — despliega servicios, consulta logs, gestiona proyectos, sin abrir el Dashboard.

Iniciar sesión

Inicio de sesión por navegador

npx zeabur@latest auth login

Pulsa Enter para abrir la página de inicio de sesión en tu navegador, luego haz clic en Confirm. Serás redirigido de vuelta al terminal con un mensaje de inicio de sesión exitoso.

Inicio de sesión por token

Para entornos CI/CD o sin interfaz gráfica:

npx zeabur@latest auth login --token <your-token>

Desplegar un servicio

Ejecuta el siguiente comando en el directorio de tu proyecto:

npx zeabur@latest deploy

El CLI detecta automáticamente tu framework y te guía para seleccionar o crear un proyecto. Una vez desplegado, la URL del servicio se mostrará en el terminal.

Espacios de trabajo (Equipos)

Un espacio de trabajo es la cuenta bajo la que actúa el CLI: tu cuenta personal o uno de los equipos a los que perteneces. El espacio de trabajo es el ámbito exterior de tu contexto — al cambiarlo se borran el proyecto, el entorno y el servicio persistidos, porque los ID de los recursos no se comparten entre una cuenta personal y un equipo.

Listar espacios de trabajo

Muestra tu espacio de trabajo personal y todos los equipos a los que perteneces, con tu rol en cada uno. El espacio de trabajo actual aparece marcado.

npx zeabur@latest workspace list

Mostrar el espacio de trabajo actual

npx zeabur@latest workspace current

Cambiar a un equipo

El argumento es el nombre del equipo o su ID de 24 caracteres. Si un nombre coincide con más de un equipo, el CLI lista los candidatos para que puedas elegir por ID.

npx zeabur@latest workspace switch <team-name-or-id>

Volver a tu espacio de trabajo personal

npx zeabur@latest workspace clear

Anulación puntual

Usa el flag global --workspace para ejecutar un único comando en otro espacio de trabajo sin cambiar el que tienes persistido. Esto resulta práctico para CI y scripts:

npx zeabur@latest --workspace <team-name-or-id> project ls

Gestión de proyectos

Listar proyectos

npx zeabur@latest project ls

Establecer contexto de proyecto

npx zeabur@latest context set project

En modo interactivo, se listan todos tus proyectos para seleccionar. Los comandos posteriores se aplicarán automáticamente al proyecto seleccionado.

Gestión de servicios

Listar servicios

npx zeabur@latest service ls

Establecer contexto de servicio

npx zeabur@latest context set service

Reiniciar un servicio

npx zeabur@latest service restart

Información de despliegue y logs

Ver estado del despliegue

npx zeabur@latest deployment get

Ver logs de ejecución

npx zeabur@latest deployment log -t=runtime

Ver logs de compilación

npx zeabur@latest deployment log -t=build

Cambiar de entorno

npx zeabur@latest context set env

Cambia entre entornos de despliegue (por ejemplo, producción, staging).

Modo no interactivo

Para pipelines CI/CD o scripts de automatización, añade -i=false para deshabilitar los prompts interactivos y pasar parámetros directamente:

Especificar proyecto y servicio por nombre

npx zeabur@latest context set project --name <project-name>
npx zeabur@latest context set service --name <service-name>
npx zeabur@latest context set env --id <env-id>

Especificar por ID

npx zeabur@latest context set project --id <project-id>
npx zeabur@latest context set service --id <service-id>

Operaciones en una sola línea

Omite la configuración de contexto y pasa todos los parámetros en línea:

npx zeabur@latest service restart --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment get --env-id <env-id> --service-name <service-name>
npx zeabur@latest deployment log -t=runtime --env-id <env-id> --service-name <service-name>

Obtener ayuda

Añade --help a cualquier comando para ver su uso:

npx zeabur@latest --help
npx zeabur@latest deployment --help