La respuesta corta

Desplegar con git push son tres decisiones: qué rama despliega, qué cuenta como un cambio de esa app, y qué tiene que pasar antes. Un push tiene que encolar un deployment solo cuando algo de esa app cambió y los checks de GitHub ya pasaron.

Esos ajustes están en un servicio conectado a GitHub. La referencia es Deploy from Git. Las notas del 5 y del 21 de octubre son Wait for CI y Watch paths.

Cómo funciona un deploy por push

Conectá un repositorio al crear el servicio. Unbroker guarda el repositorio, la rama y el commit que disparó cada deployment.

En un servicio conectado a GitHub, con deploys automáticos prendidos, un push a su rama configurada encola un deployment. La conexión de Unbroker con GitHub es la que recibe ese push. Eso es el deploy automático desde GitHub. Para desplegar un repo de GitHub en cada push de esa rama, los deploys automáticos tienen que estar prendidos. El deploy manual sigue disponible desde la consola y la CLI.

El deployment pasa por queued, building, deploying y live. Un health check fallido no se trata como live. El mapa está en el overview de deployments. El recorrido por CLI es Deploy an app from Git.

Elegí la rama que despliega

La rama que configurás es la que despliega un push. Apuntá el servicio de producción a la rama que publicás.

Las otras ramas van a un preview de pull request cuando esa función está prendida. Los previews requieren Pro. Si están habilitados en un servicio de producción, abrir o actualizar un pull request crea o actualiza el preview y despliega el head del pull request. GitHub manda esos eventos por la conexión del repositorio. Los previews heredan el Wait for CI del servicio. Cómo dejar un preview fuera de los datos de producción está en Entornos de preview por pull request.

Un servicio Node arranca en Desplegar Node.js. Una app Next.js arranca en Desplegar Next.js.

Watch paths en un monorepo

Watch paths es la forma de que un monorepo despliegue solo la app que cambió. Se configuran al crear un servicio de repositorio, en Build & deploy, o después en Source. Un patrón por línea, relativo a la raíz del repositorio, aunque Root directory esté definido. Un deploy por Watch paths corre cuando se agrega, modifica o borra un archivo que coincide.

apps/web/**
packages/sdk/**
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
.dockerignore

* coincide con cero o más caracteres dentro de un segmento. ? coincide con un carácter. Un segmento ** entero coincide con cero o más segmentos, como en apps/**/Dockerfile. Los archivos ocultos entran. Las exclusiones no están soportadas: la lista no puede sacar un path. Incluí paquetes compartidos, lockfiles y Dockerfiles que afecten el build. El ejemplo de arriba es el de la documentación de Git: apps/web, packages/sdk, los lockfiles y .dockerignore.

Los patrones configurados reemplazan el filtro de push del root directory. No cambian el contexto de build. Una lista vacía mantiene el comportamiento actual: mira el root directory si hay uno, y si no, todo el repositorio. El campo de la API es watchPaths. Mandá [] para limpiarlo. El cambio aplica a los pushes siguientes y no redeploya el servicio por sí solo.

El filtro corre antes de Wait for CI. Los deploys manuales, los deploy hooks y los previews de pull request no se ven afectados. Si el repositorio es un archivo de Compose y no un directorio por app, el mapa de ese archivo a servicios está en Docker Compose en producción.

Cuándo Unbroker despliega igual

El filtro de paths confía en la lista de archivos que manda GitHub. Si esa lista está incompleta, el push es un force push, o un push grande supera el presupuesto de trabajo del webhook, Unbroker despliega de forma conservadora. Un commit cuya lista está completa y vacía no dispara un servicio filtrado por paths.

Wait for CI

Wait for CI es el ajuste para desplegar solo si pasa el CI. Prendelo en la configuración del servicio y el push no despliega al instante. Unbroker espera a que termine cada check de GitHub del commit y despliega si todos pasaron. Así se espera a los checks de GitHub antes del deploy.

GitHub describe dos clases de status checks: checks creados por GitHub Apps, incluidas GitHub Actions, y commit statuses creados por servicios externos. El ajuste de Unbroker sigue los checks de GitHub de ese commit. No está documentado como un filtro que acepte solo Actions.

El ajuste trae tres tiempos:

  • Un push más nuevo, mientras un commit sigue esperando, reemplaza a ese commit.
  • Un commit que nunca recibe un check se despliega a los dos minutos.
  • Si el CI no termina, el commit se descarta a las dos horas.

Watch paths corre primero. Un push que no coincide con ningún patrón no llega a la espera. La nota de origen es Wait for CI before deploying. La descripción de GitHub de esos checks es About status checks.

Lo que un deploy en Live no prueba

Live quiere decir que el health check pasó y que el tráfico puede llegar a esa revisión. No prueba cada ruta. Cuando el deployment está live, pedí un endpoint que esperás y leé la respuesta. Un proceso sano no prueba cada función, ni una lectura de base ni un camino con sesión.

Una migración es un paso de release aparte. Migraciones de base de datos en el deploy es ese paso: corre una vez, antes de que la versión nueva reciba tráfico, y un rollback de código no deshace el schema. Los comandos de migración requieren Pro. Un rollback promueve un deployment conocido y no reconstruye el commit de origen. Se salta el comando de pre-deploy, y no restaura una base ni un volumen, así que la migración tiene que seguir siendo segura después de esa promoción. La frase del rollback está en la CLI de deployments. Los límites de pre-deploy y de la base están en Dejar que un agente despliegue con cuidado. Las filas del plan están en Plans.

GitLab y Bitbucket

La regla de push de arriba es para un servicio conectado a GitHub. Los merge requests de GitLab y Bitbucket usan el deploy hook del servicio. Los deploy hooks genéricos requieren Pro. Los previews de pull request también requieren Pro. Las credenciales de repositorios privados requieren Pro.

Pro es un compromiso mensual de $25 con $25 de crédito de uso en cada ciclo. El crédito no se acumula. Si el uso elegible queda por debajo de $25, el cargo sigue siendo $25. Las cifras actuales están en precios.

Desde la terminal

Crear un servicio con la CLI pide una organización Pro y un token de API. Las apps Free que califican se pueden crear en Cloud. El comando documentado es:

ubctl apps services create <projectId> \
  --name api \
  --repo https://github.com/acme/api \
  --framework node

Después, una espera. --wait devuelve un código de salida distinto de cero si el deployment falla:

ubctl apps deploy <serviceId> --wait

Un agente de código puede correr los mismos comandos. Qué puede hacer está en Desplegar con Claude Code. Qué no tiene que ver el token, y qué se salta un rollback, está en Dejar que un agente despliegue con cuidado.

Lista de control

  1. Conectá el repositorio de GitHub y dejá prendidos los deploys automáticos.
  2. Configurá la rama que tiene que desplegar. Para las otras, usá un preview de pull request, en Pro.
  3. En un monorepo, configurá Watch paths desde la raíz. Incluí la app, los paquetes compartidos, los lockfiles y el Dockerfile.
  4. Dejá la lista vacía solo cuando tiene que desplegar el root directory, o todo el repositorio.
  5. Prendé Wait for CI cuando un push tiene que esperar a que pase cada check de GitHub.
  6. Cuando el deployment esté live, pedí un endpoint real.
  7. Tratá las migraciones como un paso propio. Un rollback no reconstruye el commit y no restaura una base.

Preguntas frecuentes

¿Unbroker hace deploy automático desde GitHub en cada push?

Un servicio conectado a GitHub, con deploys automáticos prendidos, encola un deployment cuando el push cae en su rama configurada. Las otras ramas no siguen ese camino. Watch paths puede limitar la cola a los archivos que coinciden. El deploy manual sigue disponible desde la consola y la CLI. La regla está en Deploy from Git.

¿Se puede desplegar solo si pasa el CI de GitHub Actions?

Wait for CI espera a que termine cada check de GitHub del commit y despliega si todos pasaron. GitHub Actions es una forma de crear esos checks. El ajuste no está documentado como exclusivo de Actions. Un push más nuevo reemplaza al commit que está esperando. Si el CI no termina, ese commit se descarta a las dos horas.

¿Qué pasa si el repositorio no tiene checks de CI?

Un commit que nunca recibe un check se despliega a los dos minutos. La nota de Wait for CI lo dice para que un repositorio sin CI no quede esperando.

¿Cómo se evita que un monorepo despliegue cada app?

Configurá Watch paths, un patrón por línea, relativo a la raíz del repositorio. Incluí esa app, los paquetes compartidos, los lockfiles y el Dockerfile. Una lista vacía mantiene el comportamiento anterior: el root directory si hay uno, y si no, todo el repositorio.

¿Watch paths afecta los deploys manuales o los previews?

No. Los deploys manuales, los deploy hooks y los previews de pull request ignoran Watch paths. El filtro aplica a los deploys automáticos por push, y corre antes de Wait for CI.

¿Se puede desplegar desde GitLab o Bitbucket?

Los merge requests de GitLab y Bitbucket usan el deploy hook del servicio. Los deploy hooks genéricos requieren Pro. La regla de push en Deploy from Git está escrita para un servicio conectado a GitHub.

¿El push-to-deploy está en Free?

La tabla de planes no tiene una fila llamada push-to-deploy. Free incluye Node.js gestionado y 3 deploy requests por día UTC. Los deploys que no se usan no se acumulan. Los previews de pull request, los deploy hooks genéricos y las credenciales de repositorios privados no están en Free. Pro no tiene un tope de requests por plan.