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.

RenderEn qué dice la guía que se convierte
Servicio webServicio de repositorio con un preset que coincida, o un Dockerfile.
Sitio estáticoPreset de build estático y el directorio de salida correcto.
Background workerCategoría Worker con el comando de arranque del consumidor.
Disco persistenteVolumen del servicio, con una transferencia de archivos explícita.
PostgresClú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.yamlEn qué se convierte
services, databases, envVarGroups, previewsEl inventario de raíz. Postgres está en databases, no en services. No definas dos veces el mismo servicio, base o grupo.
type: webUn servicio de repositorio con un preset que coincida, o un Dockerfile.
type: web y runtime: staticUn preset de build estático y el directorio de salida correcto (staticPublishPath).
type: pservUn servicio privado que no es alcanzable desde internet. Una revisión de diseño aparte. Esta nota no documenta un tipo de reemplazo.
type: workerCategoría Worker con el comando de arranque del consumidor. Los workers piden Pro.
type: cron y scheduleUna 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: workflowTipos del blueprint. La tabla de migración no los lista. Esta nota no inventa un destino.
runtimenode, 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.
buildCommandEl comando de build. Obligatorio en servicios que no son Docker.
startCommandEl comando de arranque. Obligatorio en la mayoría. No se admite en sitios estáticos.
staticPublishPathEl directorio de salida estático, relativo a la raíz del repo.
rootDirLa raíz del servicio. Los cambios fuera de ella no disparan un build. Si se omite, es la raíz del repo.
dockerfilePath y dockerCommandRuta 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: imageTraer una imagen ya construida. Las imágenes de contenedor ya construidas piden Pro. Esta nota no documenta un mapeo más fino.
preDeployCommandDespués del build y antes del arranque, en web de pago, privados y workers. Recomendado para migraciones. Los comandos de migración piden Pro.
initialDeployHookUna vez, después del primer deploy exitoso, también en preview. Esta nota no documenta un equivalente de Unbroker.
healthCheckPathSolo servicios web. Una ruta que empieza con /. Esta nota no documenta un equivalente de Unbroker. Los health checks avanzados piden Pro.
numInstances y scalingCantidad 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.
planFija recursos de cómputo. Esta nota no lista SKUs ni precios.
diskUn 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.
autoDeployTriggercommit, checksPass u off. Esta nota no documenta un equivalente de Unbroker.
buildFilterpaths 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.generationoff, 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 generateValueUn 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: falseSe 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, fromGroupReferencias de Render. No se llevan. Reemplázalas por referencias del destino.
previewValueUn override para servicios web y privados en entornos de preview.
Interpolación de variablesNo 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

  1. Trata render.yaml como 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.
  2. Lista cada entrada de raíz: services, databases, envVarGroups y previews. Postgres está en databases. No cuentes dos veces el mismo servicio, base o grupo.
  3. Anota type y runtime. No puedes cambiar type después. No puedes cambiar el runtime de un sitio estático después. keyvalue y workflow no tienen destino en esta nota.
  4. Anota buildCommand, startCommand, staticPublishPath, rootDir, dockerfilePath y dockerCommand.
  5. Saca preDeployCommand como paso de migración. Corre después del build y antes del arranque. initialDeployHook corre una vez. Los comandos de migración piden Pro.
  6. Copia healthCheckPath, numInstances, scaling y plan. 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.
  7. Trata schedule y pserv como 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.
  8. Recrea las variables en el entorno que corresponde. Carga a mano los valores sync: false. Reemplaza fromDatabase y fromService por referencias del destino. Los archivos de blueprint no interpolan variables.
  9. Planea una transferencia de archivos por cada disk. Un dump de la base no incluye esos archivos. Puedes aumentar sizeGB. No puedes reducirlo.
  10. Anota autoDeployTrigger, buildFilter y previews.generation. Esta nota no documenta equivalentes de Unbroker para esos campos.
  11. 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.
  12. 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.