Despliegues

Preview y live

Un despliegue es una instantánea guardada de la configuración. Un entorno es un nombre que apunta a un despliegue. preview es el objetivo de desarrollo por defecto; live es el objetivo de cara al cliente.

vatio push
vatio status
vatio diff --env live
vatio publish
vatio rollback

push valida y actualiza un preview; no puede apuntar a live. publish promueve un preview. rollback restaura la configuración live anterior. diff --env live compara tu directorio local con live, así que pushea las ediciones locales antes de publicarlas.

Los agentes, herramientas, configuración de auth, chats y contactos tienen alcance por entorno. Los secretos, el contenido de conocimiento, las conexiones de canal, los campos de negocio y la configuración del widget son de todo el workspace. Aplicar un manifiesto puede actualizar la configuración de negocio y de widget durante un push a preview. Una herramienta en preview también puede llamar al mismo backend externo que live. Usa un workspace aparte cuando estos recursos deban estar aislados.

El rollback restaura la configuración del despliegue, no el contenido de conocimiento, los valores de secretos ni las acciones que una herramienta ya ejecutó.

Previews con nombre

Crea un preview independiente para una rama o un pull request:

vatio push --env pr-42
vatio chat "What does Acme do?" --env pr-42
vatio tokens create --env pr-42
vatio publish --env pr-42

Los nombres usan minúsculas y dígitos separados por guiones o guiones bajos, hasta 40 caracteres. Los previews compartidos de WhatsApp e Instagram siempre usan el entorno literal preview.

La URL para compartir el preview que imprime push se abre sin login. Cualquiera con esa URL puede hablar con el preview, así que compártela solo con quienes deben probarlo.

Desplegar desde GitHub

Instala la GitHub App de Vatio y vincula un repositorio a tu workspace en la consola. El dueño del workspace elige ese vínculo; el valor workspace de un repositorio debe coincidir con él. Define el directorio del workspace si el repositorio contiene más de un vatio.yml.

Evento	Resultado
Pull request abierto, actualizado o reabierto	Un preview pr-N y un comentario con su URL cuando cambia el directorio del workspace
Pull request cerrado	Su preview se elimina
Push a la rama por defecto	Despliegue y publicación a live

La CLI sigue disponible para despliegue manual y para diagnóstico.

Secretos

vatio secrets set ACME_API https://api.acme.com
vatio secrets set ACME_API_KEY YOUR_BACKEND_KEY
vatio secrets list
vatio secrets rm ACME_API_KEY

Las claves usan mayúsculas, dígitos y guiones bajos, empezando por una letra. Las herramientas leen los valores con $env.KEY. El listado devuelve nombres, nunca valores. Los cambios aplican a las llamadas siguientes sin desplegar, y rigen en todos los entornos. El rollback no restaura valores antiguos.

Mantén las credenciales fuera de los manifiestos, el código de herramientas, el conocimiento y los resultados de herramienta. La subida del workspace incluye archivos comunes, así que guarda las claves privadas de firma fuera de ese directorio.