La respuesta corta
Un blueprint de Render es un archivo YAML que declara servicios, bases y grupos de variables interconectados. Por defecto el archivo se llama render.yaml y vive en la raíz del repositorio Git. El nombre se puede personalizar durante la configuración. No es portable. No es un formato de importación.
Úsalo como inventario. La guía de migración dice: “Render’s Blueprint specification can help you inventory repositories, commands, variable groups and disks. It is not an Unbroker import format.”
La fuente de los campos de Render en esta nota es la especificación del blueprint de Render, leída el 2026-11-16. Esta nota no copia precios de Render. Railway y Render es el lado a lado con Railway, en inglés. Un archivo de Railway está mapeado en railway.toml, campo por campo. Un Procfile de Heroku está mapeado en Procfile de Heroku, línea a línea. Si ya decidiste mover un servicio, empieza en llevar un servicio de Render a Unbroker. La comparación está en la página de Render, en inglés.
Qué declara un blueprint
Los campos de raíz son services, databases, envVarGroups y previews. Las bases Postgres se definen en la lista databases, no en services. No definas el mismo servicio, la misma base o el mismo grupo en más de un lugar.
El ejemplo de abajo muestra formas de campos de esa especificación. No es un blueprint completo y no es una aplicación. Los comandos del bloque son formas, no valores por defecto documentados.
services:
- type: web
runtime: node
buildCommand: npm run build
startCommand: npm start
healthCheckPath: /health
preDeployCommand: npm run db:migrate
- type: web
runtime: static
buildCommand: npm run build
staticPublishPath: ./dist
- type: cron
runtime: node
schedule: "0 * * * *"
buildCommand: npm ci
startCommand: npm run job
envVarGroups:
- name: shared
envVars: []
previews:
generation: off
databases es una lista de raíz. Este ejemplo no inventa los campos de una entrada de base. schedule es una expresión cron. La expresión del bloque es una forma.
Tipos de servicio y un destino por tipo
type es obligatorio. Uno de: web (servicio web, o sitio estático si además pones runtime: static), pserv (servicio privado), worker (background worker), cron (cron job), keyvalue (Render Key Value; redis es un alias deprecado), workflow. No puedes modificar type después de crearlo.
El glosario de la misma página: un servicio web aloja una aplicación dinámica en una URL pública. Un sitio estático aloja HTML, CSS y JS en una CDN global, en una URL pública. Un servicio privado aloja una aplicación dinámica que no es alcanzable desde internet, para apps internas a las que solo acceden tus otros servicios de Render. Un background worker corre código de forma continua que no recibe requests, y la página lo describe como ideal para procesar trabajos de una cola. Un cron ejecuta un comando o un script en un horario definido. Render Key Value es almacenamiento gestionado, compatible con Redis.
La guía de migración mapea cinco filas. Esta nota no agrega filas.
| Render | En qué dice la guía que se convierte |
|---|---|
| Servicio web | Servicio de repositorio con un preset que coincida, o un Dockerfile. |
| Sitio estático | Preset de build estático y el directorio de salida correcto. |
| Background worker | Categoría Worker con el comando de arranque del consumidor. |
| Disco persistente | Volumen del servicio, con una transferencia de archivos explícita. |
| Postgres | Clúster de base gestionada, o un nodo PostgreSQL de Apps. |
La misma guía dice: “Treat scheduled tasks and private-only services as separate design checks. Confirm the destination’s scheduling and connectivity behavior fits the workload before creating a public endpoint or substituting a long-running worker.”
keyvalue y workflow existen en el blueprint. Esa tabla no los lista. Esta nota no inventa un destino para ninguno de los dos, y no inventa un mapeo de Redis ni de workflow.
Usa Pro para workers, Dockerfiles, volúmenes persistentes y dominios de producción. Los workers, los builds de Dockerfile, los volúmenes persistentes y las bases gestionadas piden Pro.
Build y arranque
runtime es obligatorio salvo que type sea keyvalue o redis. Los runtimes nativos son node, python, ruby, go, elixir y rust. Los casos especiales son docker (construir una imagen desde un Dockerfile), image (traer una imagen ya construida de un registry) y static (sitios estáticos). Puedes cambiar el runtime de un servicio después de crearlo, excepto en los sitios estáticos. runtime reemplaza al campo deprecado env.
buildCommand es obligatorio en los servicios que no son Docker. Es el comando que Render corre para construir el servicio.
startCommand es el comando que Render corre para arrancar el servicio. Es obligatorio en la mayoría. No se admite en sitios estáticos, que usan staticPublishPath.
staticPublishPath es obligatorio en sitios estáticos. Es el directorio con los archivos estáticos a publicar, relativo a la raíz del repo. Los ejemplos habituales de la especificación son ./build y ./dist.
rootDir es el directorio raíz del servicio dentro del repo. Los cambios en archivos fuera de ese directorio no disparan un build. Si lo omites, Render usa la raíz del repo.
dockerCommand es el comando al arrancar un servicio basado en Docker. Si lo omites, Render usa el CMD del Dockerfile. No se admite en workflows.
dockerfilePath es la ruta al Dockerfile, relativa a la raíz del repo. Si lo omites, Render usa ./Dockerfile. No se admite en workflows.
Los builds de Dockerfile y las imágenes de contenedor ya construidas piden Pro. Un servicio web, en la tabla de la guía, pasa a ser un servicio de repositorio con un preset que coincida o un Dockerfile. Esta nota no documenta un mapeo más fino para runtime: image.
preDeployCommand y migraciones
preDeployCommand existe para servicios web de pago, servicios privados y background workers. Si lo defines, el comando corre después del buildCommand del servicio y antes de su startCommand. Render lo recomienda para migraciones de base de datos y otras tareas previas al deploy.
initialDeployHook es el otro comando. Render lo corre después del primer deploy exitoso del servicio, una vez por instancia de servicio, también en entornos de preview. Aplica a servicios web, privados y background workers. afterFirstDeployCommand es un alias deprecado. Para un comando que debe correr antes de cada deploy, usa preDeployCommand.
Esta nota no documenta una secuencia de comandos de Unbroker que reemplace a preDeployCommand. Los comandos de migración piden Pro. Cómo tiene que comportarse la migración cuando vuelves el código atrás está en Migraciones de base de datos en el deploy.
Health checks, instancias y escala
healthCheckPath es solo para servicios web. Es la ruta del endpoint de health check, y siempre empieza con /.
numInstances, en Scaling, es la cantidad de instancias de un servicio escalado a mano. Si lo omites, Render usa 1 en un servicio nuevo y conserva el valor actual en uno que ya existe. El valor no tiene efecto cuando el autoscaling está activo.
scaling es para un servicio con autoscaling. minInstances y maxInstances son obligatorios. targetMemoryPercent o targetCPUPercent es opcional. Cada uno es opcional si el otro está definido. Los valores válidos van de 1 a 90.
Existe un campo plan que fija los recursos de cómputo. Esta nota no lista SKUs ni precios de planes.
En Unbroker, Free corre una réplica, hasta 250m de CPU y 256 MiB de RAM. Los health checks avanzados piden Pro. Esta nota no documenta un equivalente de Unbroker para healthCheckPath, numInstances o el bloque scaling. La nota de réplicas está en Escalar réplicas.
Cron y workers
El horario del cron de Render es el campo schedule. Es obligatorio en los cron y se omite en el resto. El valor es una expresión cron. Un cron ejecuta un comando o un script en un horario definido. Un background worker corre de forma continua código que no recibe requests.
Las tareas programadas son una revisión de diseño aparte. Confirma el comportamiento de horarios del destino antes de crear un endpoint público o de sustituirlo por un worker que se queda vivo.
Esta nota no documenta un equivalente de Unbroker para esa expresión cron. Los jobs programados y los workers piden Pro. La diferencia entre un proceso que se queda vivo y un comando que sale está en Workers y tareas cron.
envVars y envVarGroups
Un blueprint puede crear variables de entorno nuevas o modificar el valor de las que ya existen. Render conserva las variables que ya existen aunque las omitas en el archivo. Render no admite interpolación de variables en los archivos de blueprint.
Una variable puede ser un value escrito a mano. generateValue: true significa que, si la variable todavía no existe, Render la agrega y le pone un valor aleatorio, en base64, de 256 bits.
sync: false se pide en el panel de Render solo durante el flujo inicial de creación del blueprint. Cuando actualizas un blueprint que ya existe, Render ignora las variables con sync: false. Los secretos nuevos se agregan a mano en los servicios que ya existen. Render no incluye las variables sync: false en los entornos de preview. No puedes aplicar sync: false a una variable definida en un grupo de entorno. Render lo ignora. Esos valores no se llevan. Cárgalos a mano.
fromDatabase lleva un nombre y una propiedad, por ejemplo connectionString, y referencia una base Postgres de Render. fromService lleva un nombre, un tipo y un property o envVarKey, y referencia otro servicio. Puedes referenciar un servicio que no está definido en el blueprint, pero tiene que existir en el workspace o el blueprint no sincroniza. Esas variables referenciadas se actualizan al valor actual de la propiedad en cada sync del blueprint. No se actualizan en el momento en que la propiedad cambia. No se llevan. Reemplázalas por referencias del destino.
fromGroup agrega todas las variables de un grupo de entorno.
Los envVarGroups de Render son los grupos de la raíz. Cada grupo tiene un name y una lista de cero o más envVars. Un grupo de entorno no puede referenciar valores de tus servicios ni de otros grupos. No puedes definir una variable con sync: false en un grupo de entorno.
previewValue puede pisar el valor de variables de entorno en servicios web y privados, dentro de los entornos de preview.
La guía dice: “Recreate variables in the proper environment; values that refer to Render resources must be replaced with destination references.” Cómo funciona el alcance cuando esos valores ya son variables de entorno comunes está en Variables de entorno y secretos.
Discos
disk adjunta un disco persistente a un servicio compatible. name y mountPath son obligatorios. sizeGB tiene default 10. Puedes modificar name y mountPath de un disco que ya existe. Puedes aumentar sizeGB de un disco que ya existe. No puedes reducirlo.
La guía mapea un disco persistente a un volumen del servicio, con una transferencia de archivos explícita. También dice: “File uploads on persistent disks require their own transfer; a database dump does not include them.” Los volúmenes persistentes piden Pro. La nota de volúmenes está en Volúmenes persistentes.
autoDeployTrigger, buildFilter y previews
autoDeployTrigger en un servicio basado en Git es commit (cada commit de la rama vinculada, equivalente al autoDeploy: true deprecado), checksPass (solo si pasan los checks de CI de la rama vinculada) u off (deploys automáticos apagados, equivalente al autoDeploy: false deprecado). Si están autoDeploy y autoDeployTrigger, gana autoDeployTrigger. El campo no tiene efecto en un servicio que despliega una imagen Docker ya construida. Si lo omites, Render usa commit en un servicio nuevo y conserva el valor actual en uno que ya existe.
buildFilter lista rutas de archivos, en sintaxis glob, para incluir o ignorar cambios al decidir si dispara un build automático. Las rutas son siempre relativas a la raíz del repo. Las claves de ejemplo son paths e ignoredPaths. Al sincronizar, el valor reemplaza por completo el filtro de build que el servicio ya tenía. Si omites el campo en un servicio que ya tiene filtro, Render reemplaza esos ajustes por listas vacías.
previews.generation es off, manual o automatic. Si lo omites, los entornos de preview quedan desactivados para los blueprints vinculados. Poner el campo deprecado previewsEnabled: true equivale a automatic. Este campo no afecta la configuración de los previews de un servicio individual.
initialDeployHook está con las migraciones, arriba. Corre una vez, después del primer deploy exitoso.
Esta nota no documenta un equivalente de Unbroker para autoDeployTrigger, buildFilter, initialDeployHook o previews.generation. Los previews de pull request piden Pro. Las notas para leer son Desplegar con git push y Entornos de preview por pull request.
render.yaml, campo por campo
| Campo de render.yaml | En qué se convierte |
|---|---|
services, databases, envVarGroups, previews | El inventario de raíz. Postgres está en databases, no en services. No definas dos veces el mismo servicio, base o grupo. |
type: web | Un servicio de repositorio con un preset que coincida, o un Dockerfile. |
type: web y runtime: static | Un preset de build estático y el directorio de salida correcto (staticPublishPath). |
type: pserv | Un servicio privado que no es alcanzable desde internet. Una revisión de diseño aparte. Esta nota no documenta un tipo de reemplazo. |
type: worker | Categoría Worker con el comando de arranque del consumidor. Los workers piden Pro. |
type: cron y schedule | Una expresión cron para un comando que corre en un horario. Una revisión de diseño aparte. Esta nota no documenta un equivalente de Unbroker para la expresión. Los jobs programados piden Pro. |
type: keyvalue (alias redis) y type: workflow | Tipos del blueprint. La tabla de migración no los lista. Esta nota no inventa un destino. |
runtime | node, python, ruby, go, elixir, rust, docker, image o static. Obligatorio salvo keyvalue y redis. Un sitio estático no puede cambiar el runtime después. |
buildCommand | El comando de build. Obligatorio en servicios que no son Docker. |
startCommand | El comando de arranque. Obligatorio en la mayoría. No se admite en sitios estáticos. |
staticPublishPath | El directorio de salida estático, relativo a la raíz del repo. |
rootDir | La raíz del servicio. Los cambios fuera de ella no disparan un build. Si se omite, es la raíz del repo. |
dockerfilePath y dockerCommand | Ruta del Dockerfile (default ./Dockerfile) y el comando de arranque Docker (default CMD del Dockerfile). No se admiten en workflows. Los builds de Dockerfile piden Pro. |
runtime: image | Traer una imagen ya construida. Las imágenes de contenedor ya construidas piden Pro. Esta nota no documenta un mapeo más fino. |
preDeployCommand | Después del build y antes del arranque, en web de pago, privados y workers. Recomendado para migraciones. Los comandos de migración piden Pro. |
initialDeployHook | Una vez, después del primer deploy exitoso, también en preview. Esta nota no documenta un equivalente de Unbroker. |
healthCheckPath | Solo servicios web. Una ruta que empieza con /. Esta nota no documenta un equivalente de Unbroker. Los health checks avanzados piden Pro. |
numInstances y scaling | Cantidad manual de instancias, o mínimo y máximo con un target opcional de CPU o memoria de 1 a 90. Esta nota no documenta un equivalente de Unbroker. Free corre una réplica. |
plan | Fija recursos de cómputo. Esta nota no lista SKUs ni precios. |
disk | Un volumen del servicio, con una transferencia de archivos explícita. sizeGB tiene default 10 y puede subir, no bajar. Los volúmenes persistentes piden Pro. |
autoDeployTrigger | commit, checksPass u off. Esta nota no documenta un equivalente de Unbroker. |
buildFilter | paths e ignoredPaths. El sync reemplaza el filtro existente. Omitirlo en un servicio que ya tiene filtro lo deja en listas vacías. Esta nota no documenta un equivalente de Unbroker. |
previews.generation | off, manual o automatic. Omitirlo desactiva los entornos de preview de los blueprints vinculados. Esta nota no documenta un equivalente de Unbroker. Los previews de pull request piden Pro. |
envVars value y generateValue | Un valor escrito, o un valor aleatorio de 256 bits si la variable todavía no existe. Recrea las variables en el entorno que corresponde. Las variables que ya existen se conservan si las omites en el archivo. |
sync: false | Se pide solo en la creación inicial. Se ignora en syncs posteriores, no entra en preview y se ignora dentro de un grupo. Carga el valor a mano. |
fromDatabase, fromService, fromGroup | Referencias de Render. No se llevan. Reemplázalas por referencias del destino. |
previewValue | Un override para servicios web y privados en entornos de preview. |
| Interpolación de variables | No se admite en los archivos de blueprint. |
Cómo funciona en Unbroker
La guía de migración dice: “A Render migration begins with the running configuration, including any settings represented in render.yaml. Recreate the service behavior on Unbroker before moving production users or deleting source resources.”
La traducción de esa guía es la tabla de cinco filas de arriba. También dice: “Once destination writes exist, returning DNS to the old database would lose those writes unless you reconcile them.”
Free es $0. Es un proyecto, dos servicios en total y tres pedidos de deploy por día UTC. Los deploys que no usas no se acumulan. Se reinician a las 00:00 UTC. Cada servicio Free corre una réplica, hasta 250m de CPU y 256 MiB de RAM, se duerme cuando está idle y despierta con el próximo request. Pro es $25 al mes, con $25 de crédito de uso por ciclo de facturación. El crédito se reinicia, no se acumula y no tiene valor en efectivo. Si el uso elegible queda debajo del crédito, el cargo mensual sigue siendo el precio del plan. Esos términos son la página de planes con vigencia el 23 de septiembre de 2026, en USD y sin impuestos, y están en precios y en Plans.
Los builds de Dockerfile, las imágenes de contenedor ya construidas, los workers, los volúmenes persistentes, los comandos de migración, los previews de pull request, los jobs programados, los comandos de una sola vez, los health checks avanzados, los dominios propios y el TLS gestionado, y las bases gestionadas no están en Free. Piden Pro.
Las notas de campo que ya existen, y que esta página no repite como reglas nuevas del producto, son Migraciones de base de datos en el deploy, Workers y tareas cron, Variables de entorno y secretos, Volúmenes persistentes, Escalar réplicas, Desplegar con git push, Entornos de preview por pull request y Docker Compose en producción.
Lista de control
- Trata
render.yamlcomo un inventario. No es un formato de importación. Lee la configuración que está corriendo, incluidos los ajustes que el archivo representa, antes de mover a los usuarios de producción o de borrar los recursos de origen. - Lista cada entrada de raíz:
services,databases,envVarGroupsypreviews. Postgres está endatabases. No cuentes dos veces el mismo servicio, base o grupo. - Anota
typeyruntime. No puedes cambiartypedespués. No puedes cambiar el runtime de un sitio estático después.keyvalueyworkflowno tienen destino en esta nota. - Anota
buildCommand,startCommand,staticPublishPath,rootDir,dockerfilePathydockerCommand. - Saca
preDeployCommandcomo paso de migración. Corre después del build y antes del arranque.initialDeployHookcorre una vez. Los comandos de migración piden Pro. - Copia
healthCheckPath,numInstances,scalingyplan. Esta nota no documenta equivalentes de Unbroker para la ruta del check, la cantidad de instancias o el bloque de escala, y no lista precios de planes. - Trata
scheduleypservcomo revisiones de diseño. Confirma horarios y conectividad antes de crear un endpoint público o de sustituirlo por un worker que se queda vivo. - Recrea las variables en el entorno que corresponde. Carga a mano los valores
sync: false. ReemplazafromDatabaseyfromServicepor referencias del destino. Los archivos de blueprint no interpolan variables. - Planea una transferencia de archivos por cada
disk. Un dump de la base no incluye esos archivos. Puedes aumentarsizeGB. No puedes reducirlo. - Anota
autoDeployTrigger,buildFilterypreviews.generation. Esta nota no documenta equivalentes de Unbroker para esos campos. - Revisa el plan. Workers, Dockerfiles, volúmenes persistentes, dominios de producción, comandos de migración, jobs programados, previews de pull request, comandos de una sola vez, health checks avanzados, imágenes ya construidas, dominios propios, TLS gestionado y bases gestionadas piden Pro.
- Cuando el destino ya tiene escrituras nuevas, devolver el DNS a la base anterior pierde esas escrituras salvo que las reconcilies.
Preguntas frecuentes
¿Para qué sirve render.yaml?
Todo blueprint de Render es un archivo YAML que define servicios, bases y grupos de variables interconectados. Por defecto se llama render.yaml y vive en la raíz del repositorio Git. El nombre se puede cambiar durante la configuración. Sirve como inventario de repositorios, comandos, grupos de variables y discos. La fuente es la especificación del blueprint de Render.
¿Puedo importar un render.yaml en otra plataforma?
No. Un blueprint de Render no es portable y no es un formato de importación de Unbroker. La guía de migración dice que la especificación sirve para inventariar repositorios, comandos, grupos de variables y discos. Recrea el comportamiento del servicio antes de mover a los usuarios de producción o de borrar los recursos de origen. railway.toml tampoco es un formato de importación.
¿Cómo se corren las migraciones de preDeployCommand en otro lado?
preDeployCommand existe para servicios web de pago, servicios privados y background workers. Corre después de buildCommand y antes de startCommand. Render lo recomienda para migraciones de base de datos y otras tareas previas al deploy. Para un comando que tiene que correr antes de cada deploy, usa preDeployCommand, no initialDeployHook. Esta nota no documenta una secuencia de comandos de Unbroker que lo reemplace. Los comandos de migración piden Pro. Cómo tiene que comportarse una migración en un rollback está en Migraciones de base de datos en el deploy.
¿Qué es un servicio privado de Render (pserv) y qué lo reemplaza?
El type pserv es un servicio privado. Aloja una aplicación dinámica que no es alcanzable desde internet, para apps internas a las que solo acceden tus otros servicios de Render. No puedes modificar type después de crearlo. Trata los servicios solo privados como una revisión de diseño aparte. Confirma que la conectividad del destino le sirve a la carga antes de crear un endpoint público. Esta nota no documenta un segundo tipo de Unbroker que reemplace a pserv.
¿Qué pasa con sync:false y fromDatabase al mudarte?
sync:false se pide en el panel de Render solo durante el flujo inicial de creación del blueprint. En una actualización, Render ignora esas variables, así que los secretos nuevos se agregan a mano en los servicios que ya existen. Render no incluye las variables sync:false en los entornos de preview, e ignora sync:false en una variable de un grupo de entorno. Esos valores se cargan a mano. fromDatabase (nombre más una propiedad, por ejemplo connectionString) y fromService (nombre, tipo, y property o envVarKey) apuntan a recursos de Render. Se actualizan en cada sync del blueprint, no en el momento en que cambia la propiedad. Reemplázalos por referencias del destino y recrea las variables en el entorno que corresponde.
¿Qué reemplaza el horario cron de Render?
schedule es obligatorio en un cron y se omite en el resto. El valor es una expresión cron. Un cron ejecuta un comando o un script en un horario definido. Trata las tareas programadas como una revisión de diseño aparte, y confirma el horario del destino antes de sustituirlo por un worker que se queda vivo. Esta nota no documenta un equivalente de Unbroker para esa expresión cron. Los jobs programados y los workers piden Pro. La diferencia entre un proceso que se queda vivo y un comando que sale está en Workers y tareas cron.