Referencia CLI
whatalo deploy
Compila y despliega una nueva versión de tu plugin en el marketplace de Whatalo.
Sintaxis
whatalo deploy [opciones]Opciones
| Flag | Tipo | Descripción |
|---|---|---|
--force | boolean | Omitir la confirmación (requerido en CI/CD) |
--no-build | boolean | Omitir el paso de compilación |
--message <msg> | string | Nota de cambios o release note para esta versión |
--set-version <ver> | string | Sobreescribir la versión (por defecto: lee de package.json) |
--json | boolean | Salida en formato JSON |
--portal-url <url> | string | URL del Portal del Desarrollador |
Flujo de despliegue
- Verificar auth — Verifica tu sesión. A diferencia de
whatalo dev, no hay auto-login; ejecutawhatalo loginsi tu sesión expiró. - Leer config — Carga
whatalo.app.tomldel directorio actual. - Compilar — Ejecuta el comando definido en
build.build_commanden tu config. Timeout: 120 segundos. El CLI verifica queoutput_direxista después de la compilación. - Determinar versión — Usa
--set-versionsi se proporcionó, de lo contrario lee el campoversiondepackage.json. - Confirmar — Muestra un resumen y pide confirmación (se omite con
--forceo--json). - Desplegar — Envía
POST /api/plugins/{plugin_id}/deploycon la versión, manifiesto y mensaje.
Reglas de versión
- Debe ser una cadena semver válida (ej:
1.0.0,1.2.0-beta.1) - No puede ser inferior a la versión actualmente desplegada
Estado después del despliegue
El despliegue no publica automáticamente tu plugin. La transición de estado depende del estado actual:
| Estado actual | Estado después del despliegue |
|---|---|
draft | draft (enviar via dashboard cuando estés listo) |
approved | pending_review (los cambios requieren nueva revisión) |
rejected | pending_review |
Uso en CI/CD
En entornos no interactivos (GitHub Actions, Railway, etc.), siempre usa --force:
whatalo deploy --force --message "Corrección de sincronización de pedidos"Sin --force, el CLI quedará esperando una confirmación que nunca llegará en un entorno CI.
Ejemplo de paso en GitHub Actions
- name: Deploy plugin
run: whatalo deploy --force --message "${{ github.event.head_commit.message }}"
env:
WHATALO_DEVELOPER_PORTAL_URL: ${{ secrets.PORTAL_URL }}Ejemplos
Desplegar con mensaje y omitir build (ya compilado):
whatalo deploy --no-build --message "Agregar exportación masiva de pedidos"Desplegar una versión específica:
whatalo deploy --set-version 2.0.0 --message "Reescritura mayor — nueva interfaz"Desplegar con salida JSON para scripting:
whatalo deploy --force --jsonComandos relacionados
whatalo validate— Validar antes de desplegarwhatalo dev— Probar localmente antes de desplegar