La respuesta corta
Son tres ejecuciones, y ninguna reemplaza a las otras.
Un worker es un proceso sin HTTP de entrada. Se queda vivo y consume una cola durable. Un job programado es un comando con cron: nombre, cron, comando y timezone, y cada corrida queda en Executions. Un comando de una vez corre una sola vez, con la imagen y las variables de ese servicio.
La cola no es el worker. Un script que procesa un ítem y sale es un job programado o un comando de una vez, no un worker. Los servicios Worker, los comandos de una vez y los jobs programados requieren Pro. La landing es workers en segundo plano. Las filas están en Plans.
Tres formas de correr trabajo que no es un request HTTP
| Worker | Job programado | Comando de una vez | |
|---|---|---|---|
| Qué es | Un proceso largo, sin HTTP de entrada | Un comando con una expresión cron | Un comando, una vez |
| Cuándo encaja | Emails, uploads, indexación, un consumidor que espera | Un script que arranca, hace el trabajo y sale en un horario | Mantenimiento que corrés una vez |
| Qué queda vivo | El proceso, mientras espera trabajo | Nada entre corridas | Nada después de la corrida |
| Qué lo arranca | El comando de start del servicio | El horario, o una corrida manual desde Jobs | Vos, desde la pestaña Jobs o la API |
| Plan | Pro. No está en Free | Pro. No está en Free | Pro. No está en Free |
La guía del worker marca el corte: un comando de start como node worker.mjs tiene que quedarse vivo mientras espera. Un script que procesa un ítem y sale usa un flujo programado o de una vez. La guía es Deploy a background worker.
Cuándo necesitás un worker en segundo plano
Elegí un worker cuando el proceso consume trabajos y no atiende HTTP. Mandar email, procesar uploads e indexar son los ejemplos de esa guía.
En Cloud, agregá un servicio y elegí la categoría Worker. Conectá el repositorio, revisá el comando de build y definí el comando de start. Poné las credenciales de la cola y las variables de la base en la configuración de runtime. Cómo se agrupan esas variables está en Variables de entorno y secretos.
No armes un servicio web público solo para que un proceso sin listener pase un health check HTTP. Ese modo de fallo está en Depurar un deploy fallido. Cómo un archivo Compose se reparte en un worker está en Docker Compose en producción.
Para un build de contenedor, elegí Dockerfile en Build & deploy y poné una ruta relativa al directorio raíz. ENTRYPOINT o CMD lanza el worker. Dejá el directorio raíz vacío cuando el Dockerfile necesita todo el repositorio como contexto de build. Los workers con Dockerfile igual corren sin URL pública, sin servicio de entrada y sin sonda de readiness HTTP.
Desplegá y leé el log de runtime. Encolá un trabajo de prueba que no sea de producción y seguilo hasta un resultado durable. Un proceso en marcha no prueba que pudo autenticarse contra la cola o terminar el trabajo.
En el shutdown, dejá de tomar trabajos nuevos, terminá o soltá el que está en curso, y cerrá las conexiones a la cola y a la base. Usá una idempotency key cuando una segunda corrida cobraría, enviaría o escribiría dos veces. Mandá los fallos repetidos al dead-letter de la cola, o a otro registro durable de fallos. Logueá IDs de trabajo y categorías de error, no payloads con datos privados.
Seguí la edad de la cola, el backlog y los trabajos terminados, junto con CPU y memoria. Una CPU quieta puede ser que no hay trabajo, o que el worker perdió la conexión con la cola. Los workers corren una réplica, así que la concurrencia está adentro del consumidor, dentro de su memoria y de los límites de los sistemas que llama. Los logs de la plataforma y los gráficos de recursos están en Logs, métricas y alertas.
La API HTTP que encola el trabajo puede vivir en el mismo proyecto. Esa forma está en API con PostgreSQL. Un trabajo que tiene que sobrevivir un reinicio no va en el proceso web. En una app FastAPI, el corte entre BackgroundTasks y un worker está en FastAPI en producción.
La cola no es el worker
Unbroker corre el consumidor. El acknowledgement, el retry y el visibility timeout son de la librería de colas que corrés. Un loop sobre un array en memoria no es entrega durable.
El chequeo local de la guía es concreto. Encolá un trabajo con un ID de la aplicación. Confirmalo recién después del éxito. Interrumpí el procesamiento y verificá que la cola puede reentregar el trabajo que no se confirmó. Repetí el mismo trabajo y verificá que no duplica un pago, un email u otro efecto sensible.
Redis puede ser esa cola. Caché, sesiones y colas son otra decisión: Redis gestionado.
Beacon es mensajería en tiempo real. Entrega como máximo una vez. Los mensajes publicados mientras un cliente está desconectado no se reenvían. Para un trabajo que tiene que correr exactamente una vez, usá una cola durable. Beacon puede avisarle a un cliente después de guardar ese resultado. La nota es Beacon reliability.
Cuándo conviene un cron
Usá un job programado cuando el programa arranca, hace el trabajo y sale. Un rebuild nocturno, un reporte o una limpieza que no está esperando una cola encajan acá. El horario no reemplaza una cola durable, y el worker no reemplaza el horario.
Cada servicio tiene una pestaña Jobs. Un job programado tiene un nombre, una expresión cron, un comando y una timezone. La salida de cada corrida está en Executions. La pestaña puede disparar un job guardado. La nota de release es el changelog del 1 de agosto.
Los comandos piden que el servicio esté corriendo. La pestaña Jobs dice que arranques el servicio antes de ejecutar comandos. La página de migración desde Heroku dice la misma regla para los jobs programados, y dice que las entradas de Scheduler no se importan. El mapa de una línea worker del Procfile, del proceso release y de una entrada de Scheduler está en Procfile de Heroku, línea a línea.
La API HTTP documentada, en Infrastructure API:
GETyPOST /apps/services/:id/jobslistan o crean jobs.PUTyDELETE /apps/services/:id/jobs/:jobIdactualizan o borran uno.POST /apps/services/:id/jobs/:jobId/runcorre un job ahora.
Las páginas publicadas de ubctl no documentan un comando de jobs. ubctl apps backups schedule acepta --cron para un backup de volumen. Ese horario no es la pestaña Jobs. La referencia es Storage commands.
La documentación no dice cuánto puede durar una corrida programada, ni qué pasa si dos corridas se pisan. Esta página no agrega ninguna de las dos reglas.
Comandos de una vez para mantenimiento
Un comando de una vez corre una sola vez, con la imagen y las variables del servicio. En la pestaña Jobs el panel se llama One-off command, con un campo de comando y un botón Run. La API es POST /apps/services/:id/commands. Vale la misma regla del servicio corriendo.
El 8 de octubre de 2026 se eliminó la terminal interactiva del navegador. Quedaron los comandos de una vez y los jobs programados. Una corrida manual crea un evento de activity con la persona que la lanzó y el servicio. El texto del comando queda en el registro de la ejecución. No se copia al feed de activity de toda la organización. La nota es comandos auditados.
Usá un comando de una vez para un mantenimiento que querés una sola vez. Usá un job programado cuando ese comando tiene que repetirse. Usá el comando pre-deploy cuando una migración tiene que terminar antes de que la versión nueva quede live. Ese paso de release está en Migraciones de base en el deploy.
Qué no mezclar con esto
Un comando pre-deploy corre una vez desde la imagen nueva, antes de que esa versión quede live. Los rollbacks no lo vuelven a correr. El ejemplo del changelog es npm run db:migrate. Los comandos de migración requieren Pro. La documentación no dice qué le hace un pre-deploy fallido a la versión que ya está live.
Un comando post-deploy es otro gancho. Corre después de que el deployment está live, en una copia one-off de la imagen nueva, con las variables de ese servicio, durante como máximo 10 minutos. La salida se agrega al log del deployment. Si el comando falla, el deployment queda live y no se revierte nada. El comando no corre si el deploy mismo falla. No monta un volumen persistente. Los secretos van en variables, no en el texto del comando. El changelog del 26 de octubre dice que los comandos post-deploy requieren un plan pago y no están disponibles para servicios de imagen.
Ese límite de 10 minutos es el comando post-deploy. La documentación no lo dice para un job programado ni para un comando de una vez en la pestaña Jobs. Las fuentes son Deployments y el changelog del 26 de octubre.
Beacon no es la cola. Serverless no es una forma de correr un worker. Serverless baja a cero un contenedor HTTP que está idle y lo despierta con el próximo request. Soporta servicios HTTP de repositorio público y de upload estático, con una réplica fija. No soporta imágenes, workers, builds con Dockerfile, volúmenes persistentes, red privada ni autoscaling. La sección es Service types.
Cómo funciona en Unbroker
Tipos de servicio describe un worker como un proceso sin tráfico HTTP de entrada, útil para colas, procesamiento programado, indexación y trabajos async. La guía del worker igual traza el límite: un script que procesa un ítem y sale es un job programado o de una vez, no ese proceso largo. Un worker ya no tiene Service ni URL pública, así que no se puede marcar como privado.
Los servicios de imagen, los workers y cualquier servicio con volumen persistente corren siempre una réplica. Los servicios de repositorio y de upload son los que pueden correr varias réplicas, incluido el autoscaling. Ese control está en Autoscaling de réplicas. No le suma una segunda réplica a un worker.
Pro sale $25 por mes, con $25 de crédito de uso. El crédito se reinicia en cada ciclo de facturación, no se acumula y no tiene valor en efectivo. Si el uso elegible queda por debajo del crédito, el cargo del mes sigue siendo el precio del plan. El runtime del worker, y la cola o la base, aportan cada uno al uso. La página de planes no publica un precio aparte para un worker. En Pro, los límites de CPU y memoria son configurables. Las filas actuales están en precios y en Plans. Las mismas filas de capacidad figuran como Contract en Enterprise, que es un acuerdo aparte.
No hay un comando ubctl documentado para estos jobs. Las rutas HTTP de arriba son la automatización documentada. Crear un token de API requiere Pro. Qué puede hacer un token arranca en Agentes de código.
Lista de control
- Usá un worker cuando el proceso tiene que quedarse vivo y consumir una cola durable.
- Usá un job programado cuando el script arranca, hace el trabajo y sale.
- Usá un comando de una vez para un mantenimiento, con la imagen y las variables del servicio.
- Dejá la cola fuera del worker. Usá el acknowledgement, el retry y el dead-letter de esa librería.
- Poné las credenciales de la cola en variables de runtime, no en el texto del comando.
- No armes un servicio web público solo para que un worker pase un health check HTTP.
- En el shutdown, dejá de tomar trabajos, terminá o soltá el que está en curso, y cerrá las conexiones.
- Logueá IDs y categorías de error. Dejá los payloads privados fuera del log.
- Usá Pro para workers, comandos de una vez y jobs programados. Dejá Serverless fuera del worker.
Preguntas frecuentes
¿Cómo corro un worker en segundo plano en un PaaS?
En Unbroker, agregá un servicio y elegí la categoría Worker. Conectá el repositorio, revisá el comando de build y poné un comando de start que se quede vivo, por ejemplo `node worker.mjs`. Las credenciales de la cola van en la configuración de runtime. Desplegá y seguí un trabajo de prueba en el log de runtime. Un worker es un proceso sin HTTP de entrada; se queda vivo y consume una cola durable. Los servicios Worker requieren Pro y corren una réplica. Un script que procesa un ítem y sale es un job programado o un comando de una vez, no un worker. La fuente es la guía del worker.
¿Qué diferencia hay entre un worker en segundo plano y un cron job?
Un worker es un proceso largo, sin HTTP de entrada. El comando de start se queda vivo y consume una cola, por ejemplo node worker.mjs. Un job programado es un comando con nombre, una expresión cron y una timezone, en la pestaña Jobs. La salida de cada corrida está en Executions. Un script que procesa un ítem y sale es un job programado o un comando de una vez, no un worker. La fuente es la guía del worker.
¿Unbroker tiene un equivalente de Heroku Scheduler?
La página de migración desde Heroku llama a los scheduled jobs el equivalente más cercano a Heroku Scheduler: un comando con nombre, una expresión cron y una timezone, en un servicio que está corriendo. Las entradas de Scheduler no se importan. Los comandos de una vez van aparte, y no son una agenda. Esta página no compara precios.
¿Los servicios Worker requieren Pro?
Sí. La tabla de planes lista los servicios Worker como no disponibles en Free y disponibles en Pro. Pro sale $25 por mes, con $25 de crédito de uso. El crédito se reinicia en cada ciclo y no se acumula. Si el uso elegible queda por debajo del crédito, el cargo del mes sigue siendo el precio del plan.
¿Cuántas réplicas puede correr un worker?
Una. Tipos de servicio dice que los servicios de imagen, los workers y cualquier servicio con volumen persistente corren siempre una réplica. La concurrencia va adentro del consumidor, dentro de su memoria y de los límites de lo que llama.
¿Puedo darle a un worker una URL pública o un health check HTTP?
No. Un worker no se puede marcar como privado, porque ya no tiene Service ni URL pública. Los workers con Dockerfile corren sin URL pública, sin servicio de entrada y sin sonda de readiness HTTP. No armes un servicio web público solo para que un proceso sin listener pase un health check HTTP.
¿La cola va dentro del proceso del worker?
No. El worker y la cola durable son piezas distintas. El acknowledgement, el retry, el visibility timeout y el dead-letter son de la librería de colas que corrés. Un loop sobre un array en memoria no es entrega durable. Redis puede ser la cola. Beacon no.
¿Cómo corro un job programado en Unbroker?
Abrí la pestaña Jobs del servicio. Un job programado tiene un nombre, una expresión cron, un comando y una timezone. La salida queda en Executions. La pestaña puede disparar un job guardado mientras el servicio está corriendo. La API HTTP lista y crea jobs en GET y POST /apps/services/:id/jobs, actualiza o borra uno en PUT y DELETE /apps/services/:id/jobs/:jobId, y lo corre ahora en POST /apps/services/:id/jobs/:jobId/run. Las páginas publicadas de ubctl no documentan un comando de jobs.
¿Qué pasó con la terminal interactiva del navegador?
Se eliminó el 8 de octubre de 2026. Siguen los comandos de una vez y los jobs programados. Una corrida manual crea un evento de activity con la persona que la lanzó y el servicio. El texto del comando queda en el registro de la ejecución. No se copia al feed de activity de toda la organización.
¿Los comandos de una vez y los jobs programados están en Free?
No. La tabla de planes lista los comandos de una vez y los jobs programados como no disponibles en Free y disponibles en Pro. La misma tabla lista los servicios Worker como no disponibles en Free.
¿Beacon es una cola de trabajos?
No. Beacon entrega mensajes en tiempo real como máximo una vez. Los mensajes publicados mientras un cliente está desconectado no se reenvían. Para un trabajo que tiene que correr exactamente una vez, usá una cola durable. Beacon puede avisarle a un cliente después de guardar ese resultado.
¿Conviene correr el cron dentro del proceso web?
Un comando que arranca, hace el trabajo y sale va en la pestaña Jobs, como job programado o como comando de una vez. Un proceso que se queda vivo y consume una cola va en un worker. Un timer adentro del proceso HTTP no es ninguna de esas ejecuciones documentadas. La documentación no dice qué pasa si dos corridas programadas se pisan, así que esta página tampoco.