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.

RenderNo que o guia diz que se transforma
Serviço webServiço de repositório com um preset compatível, ou um Dockerfile.
Site estáticoPreset de build estático e o diretório de saída correto.
Background workerCategoria Worker com o comando de start do consumidor.
Disco persistenteVolume do serviço, com uma transferência de arquivos explícita.
PostgresCluster 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.yamlNo que se transforma
services, databases, envVarGroups, previewsO 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: webUm serviço de repositório com um preset compatível, ou um Dockerfile.
type: web e runtime: staticUm preset de build estático e o diretório de saída correto (staticPublishPath).
type: pservUm 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: workerCategoria Worker com o comando de start do consumidor. Workers exigem Pro.
type: cron e scheduleUma 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: workflowTipos do blueprint. A tabela de migração não os lista. Este texto não inventa um destino.
runtimenode, 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.
buildCommandO comando de build. Obrigatório em serviços que não são Docker.
startCommandO comando de start. Obrigatório na maioria. Não é suportado em sites estáticos.
staticPublishPathO diretório de saída estático, relativo à raiz do repositório.
rootDirA raiz do serviço. Mudanças fora dela não disparam um build. Omitido significa a raiz do repositório.
dockerfilePath e dockerCommandCaminho 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: imagePuxar uma imagem já construída. Imagens de contêiner já construídas exigem Pro. Este texto não documenta um mapeamento mais fino.
preDeployCommandDepois do build e antes do start, em web pago, privados e workers. Recomendado para migrações. Comandos de migração exigem Pro.
initialDeployHookUma vez, depois do primeiro deploy bem-sucedido, inclusive em preview. Este texto não documenta um equivalente da Unbroker.
healthCheckPathSó 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 scalingQuantidade 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.
planDefine recursos de compute. Este texto não lista SKUs nem preços.
diskUm 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.
autoDeployTriggercommit, checksPass ou off. Este texto não documenta um equivalente da Unbroker.
buildFilterpaths 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.generationoff, 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 generateValueUm 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: falsePedido 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, fromGroupReferências do Render. Não vêm junto. Troque-as por referências do destino.
previewValueUm override para serviços web e privados em ambientes de preview.
Interpolação de variáveisNã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

  1. Trate o render.yaml como 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.
  2. Liste cada entrada de raiz: services, databases, envVarGroups e previews. O Postgres está em databases. Não conte duas vezes o mesmo serviço, banco ou grupo.
  3. Anote type e runtime. Você não pode mudar type depois. Você não pode mudar o runtime de um site estático depois. keyvalue e workflow não têm destino neste texto.
  4. Anote buildCommand, startCommand, staticPublishPath, rootDir, dockerfilePath e dockerCommand.
  5. Tire o preDeployCommand como passo de migração. Ele roda depois do build e antes do start. initialDeployHook roda uma vez. Comandos de migração exigem Pro.
  6. Copie healthCheckPath, numInstances, scaling e plan. 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.
  7. Trate schedule e pserv como 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.
  8. Recrie as variáveis no ambiente certo. Carregue na mão os valores sync: false. Troque fromDatabase e fromService por referências do destino. Arquivos de blueprint não interpolam variáveis.
  9. Planeje uma transferência de arquivos para cada disk. Um dump do banco não inclui esses arquivos. Você pode aumentar sizeGB. Não pode reduzir.
  10. Anote autoDeployTrigger, buildFilter e previews.generation. Este texto não documenta equivalentes da Unbroker para esses campos.
  11. 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.
  12. 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.