A resposta curta
Um blueprint do Render é um arquivo YAML que declara serviços, bancos e grupos de variáveis interligados. Por padrão o arquivo se chama render.yaml e fica na raiz do repositório Git. O nome pode ser personalizado na configuração. Ele não é portátil. Não é um formato de importação.
Use o arquivo como inventário. O guia de migração diz: “Render’s Blueprint specification can help you inventory repositories, commands, variable groups and disks. It is not an Unbroker import format.”
A fonte dos campos do Render neste texto é a especificação do blueprint do Render, lida em 2026-11-16. Este texto não copia preços do Render. Railway e Render é o lado a lado com o Railway, em inglês. Um arquivo do Railway está mapeado em railway.toml, campo a campo. Um Procfile do Heroku está mapeado em Procfile do Heroku, linha a linha. Se você já decidiu mover um serviço, comece em levar um serviço do Render para a Unbroker. A comparação está na página do Render, em inglês.
O que um blueprint declara
Os campos de raiz são services, databases, envVarGroups e previews. Bancos Postgres ficam na lista databases, não em services. Não defina o mesmo serviço, o mesmo banco ou o mesmo grupo em mais de um lugar.
O exemplo abaixo mostra formatos de campo dessa especificação. Não é um blueprint completo e não é uma aplicação. Os comandos do bloco são formatos, não padrões 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 é uma lista de raiz. Este exemplo não inventa os campos de uma entrada de banco. schedule é uma expressão cron. A expressão do bloco é um formato.
Tipos de serviço e um destino por tipo
type é obrigatório. Um de: web (serviço web, ou site estático se você também definir runtime: static), pserv (serviço privado), worker (background worker), cron (cron job), keyvalue (Render Key Value; redis é um alias deprecated), workflow. Você não pode modificar type depois da criação.
O glossário da mesma página: um serviço web hospeda uma aplicação dinâmica numa URL pública. Um site estático hospeda HTML, CSS e JS numa CDN global, numa URL pública. Um serviço privado hospeda uma aplicação dinâmica que não é alcançável pela internet, para apps internas que só os seus outros serviços no Render acessam. Um background worker roda código de forma contínua que não recebe requests, e a página o descreve como ideal para processar jobs de uma fila. Um cron executa um comando ou um script num horário definido. Render Key Value é armazenamento gerenciado, compatível com Redis.
O guia de migração mapeia cinco linhas. Este texto não acrescenta linhas.
| Render | No que o guia diz que se transforma |
|---|---|
| Serviço web | Serviço de repositório com um preset compatível, ou um Dockerfile. |
| Site estático | Preset de build estático e o diretório de saída correto. |
| Background worker | Categoria Worker com o comando de start do consumidor. |
| Disco persistente | Volume do serviço, com uma transferência de arquivos explícita. |
| Postgres | Cluster de banco gerenciado, ou um nó PostgreSQL do Apps. |
O mesmo guia diz: “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 e workflow existem no blueprint. Essa tabela não os lista. Este texto não inventa um destino para nenhum dos dois, e não inventa um mapeamento de Redis nem de workflow.
Use o Pro para workers, Dockerfiles, volumes persistentes e domínios de produção. Workers, builds de Dockerfile, volumes persistentes e bancos gerenciados exigem Pro.
Build e start
runtime é obrigatório, salvo quando type é keyvalue ou redis. Os runtimes nativos são node, python, ruby, go, elixir e rust. Os casos especiais são docker (construir uma imagem a partir de um Dockerfile), image (puxar uma imagem já construída de um registry) e static (sites estáticos). Você pode mudar o runtime de um serviço depois da criação, exceto em sites estáticos. runtime substitui o campo deprecated env.
buildCommand é obrigatório em serviços que não são Docker. É o comando que o Render roda para construir o serviço.
startCommand é o comando que o Render roda para iniciar o serviço. É obrigatório na maioria. Não é suportado em sites estáticos, que usam staticPublishPath.
staticPublishPath é obrigatório em sites estáticos. É o diretório com os arquivos estáticos a publicar, relativo à raiz do repositório. Os exemplos comuns da especificação são ./build e ./dist.
rootDir é o diretório raiz do serviço dentro do repositório. Mudanças em arquivos fora desse diretório não disparam um build. Se você omitir, o Render usa a raiz do repositório.
dockerCommand é o comando ao iniciar um serviço baseado em Docker. Se você omitir, o Render usa o CMD definido no Dockerfile. Não é suportado em workflows.
dockerfilePath é o caminho do Dockerfile, relativo à raiz do repositório. Se você omitir, o Render usa ./Dockerfile. Não é suportado em workflows.
Builds de Dockerfile e imagens de contêiner já construídas exigem Pro. Um serviço web, na tabela do guia, vira um serviço de repositório com um preset compatível ou um Dockerfile. Este texto não documenta um mapeamento mais fino para runtime: image.
preDeployCommand e migrações
preDeployCommand existe para serviços web pagos, serviços privados e background workers. Se você definir, o comando roda depois do buildCommand do serviço e antes do startCommand. O Render recomenda o comando para migrações de banco e outras tarefas antes do deploy.
initialDeployHook é o outro comando. O Render o executa depois do primeiro deploy bem-sucedido do serviço, uma vez por instância de serviço, inclusive em ambientes de preview. Vale para serviços web, privados e background workers. afterFirstDeployCommand é um alias deprecated. Para um comando que deve rodar antes de cada deploy, use preDeployCommand.
Este texto não documenta uma sequência de comandos da Unbroker que substitua preDeployCommand. Comandos de migração exigem Pro. Como a migração precisa se comportar quando o código volta está em Migrações de banco de dados no deploy.
Health checks, instâncias e escala
healthCheckPath é só para serviços web. É o caminho do endpoint de health check, e sempre começa com /.
numInstances, em Scaling, é a quantidade de instâncias de um serviço escalado na mão. Se você omitir, o Render usa 1 num serviço novo e mantém o valor atual num serviço que já existe. O valor não tem efeito quando o autoscaling está ligado.
scaling é para um serviço com autoscaling. minInstances e maxInstances são obrigatórios. targetMemoryPercent ou targetCPUPercent é opcional. Cada um é opcional se o outro estiver definido. Os valores válidos vão de 1 a 90.
Existe um campo plan que define os recursos de compute. Este texto não lista SKUs nem preços de planos.
Na Unbroker, o Free roda uma réplica, até 250m de CPU e 256 MiB de RAM. Health checks avançados exigem Pro. Este texto não documenta um equivalente da Unbroker para healthCheckPath, numInstances ou o bloco scaling. A nota de réplicas está em Escalar réplicas.
Cron e workers
O horário do cron do Render é o campo schedule. É obrigatório em crons e fica de fora nos outros tipos. O valor é uma expressão cron. Um cron executa um comando ou um script num horário definido. Um background worker roda de forma contínua código que não recebe requests.
Tarefas agendadas são uma checagem de desenho à parte. Confirme o comportamento de horário do destino antes de criar um endpoint público ou de trocar por um worker que fica no ar.
Este texto não documenta um equivalente da Unbroker para essa expressão cron. Jobs agendados e workers exigem Pro. A diferença entre um processo que fica no ar e um comando que sai está em Workers e tarefas cron.
envVars e envVarGroups
Um blueprint pode criar variáveis de ambiente novas ou modificar o valor das que já existem. O Render preserva as variáveis que já existem mesmo quando você as omite no arquivo. O Render não suporta interpolação de variáveis em arquivos de blueprint.
Uma variável pode ser um value fixo. generateValue: true significa que, se a variável ainda não existe, o Render a adiciona e define um valor aleatório, em base64, de 256 bits.
sync: false é pedido no painel do Render só no fluxo inicial de criação do blueprint. Quando você atualiza um blueprint que já existe, o Render ignora variáveis com sync: false. Credenciais secretas novas entram na mão nos serviços que já existem. O Render não inclui variáveis sync: false em ambientes de preview. Você não pode aplicar sync: false a uma variável definida num grupo de ambiente. O Render ignora. Esses valores não vêm junto. Carregue-os na mão.
fromDatabase leva um nome e uma propriedade, por exemplo connectionString, e referencia um Postgres do Render. fromService leva um nome, um tipo e um property ou envVarKey, e referencia outro serviço. Você pode referenciar um serviço que não está definido no blueprint, mas ele precisa existir no workspace ou o blueprint falha ao sincronizar. Essas variáveis referenciadas atualizam para o valor atual da propriedade em cada sync do blueprint. Elas não atualizam no instante em que a propriedade muda. Elas não vêm junto. Troque-as por referências do destino.
fromGroup adiciona todas as variáveis de um grupo de ambiente.
Os envVarGroups do Render são os grupos da raiz. Cada grupo tem um name e uma lista de zero ou mais envVars. Um grupo de ambiente não pode referenciar valores dos seus serviços nem de outros grupos. Você não pode definir uma variável com sync: false num grupo de ambiente.
previewValue pode substituir valores de variáveis de ambiente em serviços web e privados, nos ambientes de preview.
O guia diz: “Recreate variables in the proper environment; values that refer to Render resources must be replaced with destination references.” Como o escopo funciona quando esses valores já são variáveis de ambiente comuns está em Variáveis de ambiente e segredos.
Discos
disk anexa um disco persistente a um serviço compatível. name e mountPath são obrigatórios. sizeGB tem padrão 10. Você pode modificar name e mountPath de um disco que já existe. Você pode aumentar o sizeGB de um disco que já existe. Não pode reduzir.
O guia mapeia um disco persistente para um volume do serviço, com uma transferência de arquivos explícita. Também diz: “File uploads on persistent disks require their own transfer; a database dump does not include them.” Volumes persistentes exigem Pro. A nota de volumes está em Volumes persistentes.
autoDeployTrigger, buildFilter e previews
autoDeployTrigger num serviço baseado em Git é commit (cada commit do branch vinculado, equivalente ao autoDeploy: true deprecated), checksPass (só se os checks de CI do branch vinculado passarem) ou off (deploys automáticos desligados, equivalente ao autoDeploy: false deprecated). Se autoDeploy e autoDeployTrigger estiverem presentes, autoDeployTrigger prevalece. O campo não tem efeito num serviço que faz deploy de uma imagem Docker já construída. Se você omitir, o Render usa commit num serviço novo e mantém o valor atual num serviço que já existe.
buildFilter lista caminhos de arquivo, em sintaxe glob, para incluir ou ignorar mudanças ao decidir se dispara um build automático. Os caminhos são sempre relativos à raiz do repositório. As chaves de exemplo são paths e ignoredPaths. No sync, o valor substitui por completo o filtro de build que o serviço já tinha. Se você omitir o campo num serviço que já tem filtro, o Render substitui esses ajustes por listas vazias.
previews.generation é off, manual ou automatic. Se você omitir, os ambientes de preview ficam desligados para os blueprints vinculados. Definir o campo deprecated previewsEnabled: true equivale a automatic. Este campo não afeta a configuração dos previews de um serviço individual.
initialDeployHook está com as migrações, acima. Ele roda uma vez, depois do primeiro deploy bem-sucedido.
Este texto não documenta um equivalente da Unbroker para autoDeployTrigger, buildFilter, initialDeployHook ou previews.generation. Previews de pull request exigem Pro. As notas para ler são Deploy com git push e Ambientes de preview de pull request.
render.yaml, campo a campo
| Campo do render.yaml | No que se transforma |
|---|---|
services, databases, envVarGroups, previews | O inventário de raiz. O Postgres está em databases, não em services. Não defina duas vezes o mesmo serviço, banco ou grupo. |
type: web | Um serviço de repositório com um preset compatível, ou um Dockerfile. |
type: web e runtime: static | Um preset de build estático e o diretório de saída correto (staticPublishPath). |
type: pserv | Um serviço privado que não é alcançável pela internet. Uma checagem de desenho à parte. Este texto não documenta um tipo de substituição. |
type: worker | Categoria Worker com o comando de start do consumidor. Workers exigem Pro. |
type: cron e schedule | Uma expressão cron para um comando que roda num horário. Uma checagem de desenho à parte. Este texto não documenta um equivalente da Unbroker para a expressão. Jobs agendados exigem Pro. |
type: keyvalue (alias redis) e type: workflow | Tipos do blueprint. A tabela de migração não os lista. Este texto não inventa um destino. |
runtime | node, python, ruby, go, elixir, rust, docker, image ou static. Obrigatório, salvo keyvalue e redis. Um site estático não pode mudar o runtime depois. |
buildCommand | O comando de build. Obrigatório em serviços que não são Docker. |
startCommand | O comando de start. Obrigatório na maioria. Não é suportado em sites estáticos. |
staticPublishPath | O diretório de saída estático, relativo à raiz do repositório. |
rootDir | A raiz do serviço. Mudanças fora dela não disparam um build. Omitido significa a raiz do repositório. |
dockerfilePath e dockerCommand | Caminho do Dockerfile (padrão ./Dockerfile) e o comando de start Docker (padrão CMD do Dockerfile). Não são suportados em workflows. Builds de Dockerfile exigem Pro. |
runtime: image | Puxar uma imagem já construída. Imagens de contêiner já construídas exigem Pro. Este texto não documenta um mapeamento mais fino. |
preDeployCommand | Depois do build e antes do start, em web pago, privados e workers. Recomendado para migrações. Comandos de migração exigem Pro. |
initialDeployHook | Uma vez, depois do primeiro deploy bem-sucedido, inclusive em preview. Este texto não documenta um equivalente da Unbroker. |
healthCheckPath | Só serviços web. Um caminho que começa com /. Este texto não documenta um equivalente da Unbroker. Health checks avançados exigem Pro. |
numInstances e scaling | Quantidade manual de instâncias, ou mínimo e máximo com um alvo opcional de CPU ou memória de 1 a 90. Este texto não documenta um equivalente da Unbroker. O Free roda uma réplica. |
plan | Define recursos de compute. Este texto não lista SKUs nem preços. |
disk | Um volume do serviço, com uma transferência de arquivos explícita. sizeGB tem padrão 10 e pode subir, não descer. Volumes persistentes exigem Pro. |
autoDeployTrigger | commit, checksPass ou off. Este texto não documenta um equivalente da Unbroker. |
buildFilter | paths e ignoredPaths. O sync substitui o filtro existente. Omitir num serviço que já tem filtro deixa listas vazias. Este texto não documenta um equivalente da Unbroker. |
previews.generation | off, manual ou automatic. Omitir desliga os ambientes de preview dos blueprints vinculados. Este texto não documenta um equivalente da Unbroker. Previews de pull request exigem Pro. |
envVars value e generateValue | Um valor fixo, ou um valor aleatório de 256 bits se a variável ainda não existe. Recrie as variáveis no ambiente certo. Variáveis que já existem são mantidas se você as omitir no arquivo. |
sync: false | Pedido só na criação inicial. Ignorado em syncs posteriores, fora dos previews e ignorado dentro de um grupo. Carregue o valor na mão. |
fromDatabase, fromService, fromGroup | Referências do Render. Não vêm junto. Troque-as por referências do destino. |
previewValue | Um override para serviços web e privados em ambientes de preview. |
| Interpolação de variáveis | Não é suportada em arquivos de blueprint. |
Como isso funciona na Unbroker
O guia de migração diz: “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.”
A tradução desse guia é a tabela de cinco linhas acima. Ele também diz: “Once destination writes exist, returning DNS to the old database would lose those writes unless you reconcile them.”
O Free é $0. É um projeto, dois serviços no total e três pedidos de deploy por dia UTC. Deploys não usados não acumulam. Eles zeram às 00:00 UTC. Cada serviço Free roda uma réplica, até 250m de CPU e 256 MiB de RAM, dorme quando está idle e acorda no próximo request. O Pro é $25 por mês, com $25 de crédito de uso por ciclo de cobrança. O crédito zera, não acumula e não tem valor em dinheiro. Se o uso elegível ficar abaixo do crédito, a cobrança mensal continua sendo o preço do plano. Esses termos são a página de planos vigente em 23 de setembro de 2026, em USD e sem impostos, e estão em preços e em Plans.
Builds de Dockerfile, imagens de contêiner já construídas, workers, volumes persistentes, comandos de migração, previews de pull request, jobs agendados, comandos avulsos, health checks avançados, domínios próprios e TLS gerenciado, e bancos gerenciados não estão no Free. Exigem Pro.
As notas de campo que já existem, e que esta página não repete como regras novas do produto, são Migrações de banco de dados no deploy, Workers e tarefas cron, Variáveis de ambiente e segredos, Volumes persistentes, Escalar réplicas, Deploy com git push, Ambientes de preview de pull request e Docker Compose em produção.
Lista de verificação
- Trate o
render.yamlcomo inventário. Não é um formato de importação. Leia a configuração que está rodando, inclusive os ajustes que o arquivo representa, antes de mover usuários de produção ou apagar os recursos de origem. - Liste cada entrada de raiz:
services,databases,envVarGroupsepreviews. O Postgres está emdatabases. Não conte duas vezes o mesmo serviço, banco ou grupo. - Anote
typeeruntime. Você não pode mudartypedepois. Você não pode mudar o runtime de um site estático depois.keyvalueeworkflownão têm destino neste texto. - Anote
buildCommand,startCommand,staticPublishPath,rootDir,dockerfilePathedockerCommand. - Tire o
preDeployCommandcomo passo de migração. Ele roda depois do build e antes do start.initialDeployHookroda uma vez. Comandos de migração exigem Pro. - Copie
healthCheckPath,numInstances,scalingeplan. Este texto não documenta equivalentes da Unbroker para o caminho do check, a quantidade de instâncias ou o bloco de escala, e não lista preços de planos. - Trate
scheduleepservcomo checagens de desenho. Confirme horário e conectividade antes de criar um endpoint público ou de trocar por um worker que fica no ar. - Recrie as variáveis no ambiente certo. Carregue na mão os valores
sync: false. TroquefromDatabaseefromServicepor referências do destino. Arquivos de blueprint não interpolam variáveis. - Planeje uma transferência de arquivos para cada
disk. Um dump do banco não inclui esses arquivos. Você pode aumentarsizeGB. Não pode reduzir. - Anote
autoDeployTrigger,buildFilterepreviews.generation. Este texto não documenta equivalentes da Unbroker para esses campos. - Confira o plano. Workers, Dockerfiles, volumes persistentes, domínios de produção, comandos de migração, jobs agendados, previews de pull request, comandos avulsos, health checks avançados, imagens já construídas, domínios próprios, TLS gerenciado e bancos gerenciados exigem Pro.
- Quando o destino já tem escritas novas, devolver o DNS ao banco antigo perde essas escritas, a menos que você as reconcilie.
Perguntas frequentes
Para que serve o render.yaml?
Todo blueprint do Render é um arquivo YAML que define serviços, bancos e grupos de variáveis interligados. Por padrão o arquivo se chama render.yaml e fica na raiz do repositório Git. O nome pode ser personalizado na configuração. Use-o como inventário de repositórios, comandos, grupos de variáveis e discos. A fonte é a especificação do blueprint do Render.
Dá para importar um render.yaml em outra plataforma?
Não. Um blueprint do Render não é portátil e não é um formato de importação da Unbroker. O guia de migração diz que a especificação ajuda a inventariar repositórios, comandos, grupos de variáveis e discos. Recrie o comportamento do serviço antes de mover usuários de produção ou apagar os recursos de origem. railway.toml também não é um formato de importação.
Como o preDeployCommand roda migrações em outro lugar?
preDeployCommand existe para serviços web pagos, serviços privados e background workers. Ele roda depois de buildCommand e antes de startCommand. O Render recomenda o comando para migrações de banco e outras tarefas antes do deploy. Para um comando que precisa rodar antes de cada deploy, use preDeployCommand, não initialDeployHook. Este texto não documenta uma sequência de comandos da Unbroker que o substitua. Comandos de migração exigem Pro. Como uma migração precisa se comportar num rollback está em Migrações de banco de dados no deploy.
O que é um serviço privado do Render (pserv) e o que o substitui?
O type pserv é um serviço privado. Ele hospeda uma aplicação dinâmica que não é alcançável pela internet, para apps internas que só os seus outros serviços no Render acessam. Você não pode modificar type depois da criação. Trate serviços só privados como uma checagem de desenho à parte. Confirme que a conectividade do destino serve à carga antes de criar um endpoint público. Este texto não documenta um segundo tipo da Unbroker que substitua o pserv.
O que acontece com sync:false e fromDatabase na mudança?
sync:false é pedido no painel do Render só no fluxo inicial de criação do blueprint. Numa atualização, o Render ignora essas variáveis, então credenciais secretas novas entram na mão nos serviços que já existem. O Render não inclui variáveis sync:false em ambientes de preview, e ignora sync:false numa variável de um grupo de ambiente. Esses valores são carregados na mão. fromDatabase (nome mais uma propriedade, por exemplo connectionString) e fromService (nome, tipo e property ou envVarKey) apontam para recursos do Render. Eles atualizam em cada sync do blueprint, não no instante em que a propriedade muda. Troque-os por referências do destino e recrie as variáveis no ambiente certo.
O que substitui o horário cron do Render?
schedule é obrigatório num cron e fica de fora nos outros tipos. O valor é uma expressão cron. Um cron executa um comando ou um script num horário definido. Trate tarefas agendadas como uma checagem de desenho à parte, e confirme o horário do destino antes de trocar por um worker que fica no ar. Este texto não documenta um equivalente da Unbroker para essa expressão cron. Jobs agendados e workers exigem Pro. A diferença entre um processo que fica no ar e um comando que sai está em Workers e tarefas cron.