Publicado em
Vale a pena migrar do Heroku para uma cloud no Brasil? Passo a passo
Vale a pena migrar do Heroku para a Zenifra quando os seus usuários estão no Brasil e você quer pagar em real, com PIX, boleto ou cartão e sem IOF: um app Basic com Heroku Postgres Essential-0 custa US$ 12, que viram R$ 67,84 no cartão com a PTAX de 05/11/2026 e o IOF de 3,5%, contra R$ 42,00 por um cenário equivalente na Zenifra. Não vale se você depende de add-ons do marketplace do Heroku sem equivalente, de Private Spaces ou de usuários concentrados nos Estados Unidos e na Europa; este guia mostra a conta em três tamanhos e o passo a passo das docs da Zenifra, do inventário ao rollback.
Quando vale a pena migrar do Heroku, e quando não vale
O Heroku é um PaaS maduro, com mais de uma década de aplicações em produção e um marketplace grande de add-ons. Para quem atende usuários no Brasil, porém, três pontos pesam todo mês. O primeiro é a região: o comando heroku regions lista o Common Runtime só nos Estados Unidos e na Europa, e os Private Spaces em Dublin, Frankfurt, Londres, Montreal, Mumbai, Oregon, Singapura, Sydney, Tóquio e Virgínia, nenhum na América do Sul. O segundo é a cobrança: segundo a central de ajuda do Heroku, a fatura é cobrada automaticamente no cartão de crédito, todo mês, em dólar, sem PayPal, ACH ou transferência. O terceiro é o preço de entrada: não existe plano grátis, e o dyno Eco, de US$ 5, é só para contas pessoais e hiberna depois de 30 minutos sem acesso.
A migração para a Zenifra faz sentido quando a aplicação já segue o desenho clássico do Heroku: um processo web, talvez um worker, um Heroku Postgres, um Key-Value Store (o antigo Heroku Redis) e algumas tarefas no Heroku Scheduler. Cada uma dessas peças tem equivalente direto na Zenifra, e o código costuma ir sem mudança, porque o deploy sai do mesmo repositório do GitHub. A aplicação passa a rodar em infraestrutura no Brasil, e a cobrança vem em real, por PIX, boleto ou cartão, sem câmbio e sem IOF.
Ela não faz sentido em alguns casos, e é melhor saber antes de começar. Se o seu produto depende de add-ons do marketplace do Heroku que não têm equivalente, você vai precisar manter a conta nesses provedores ou trocar de ferramenta. Se a empresa exige Private Spaces, rede isolada e regiões em vários países por compliance, o Heroku entrega isso e a Zenifra não tem uma oferta equivalente. Se a maior parte dos usuários está nos Estados Unidos ou na Europa, uma região perto deles vale mais do que a economia no câmbio. E se a sua receita é em dólar, a variação cambial deixa de ser risco, porque receita e custo se movem juntos.
Há ainda um ponto operacional: o roteiro das docs da Zenifra copia o banco com pg_dump e pg_restore, o que exige congelar as escritas no Heroku durante a cópia final. Para a maioria das aplicações isso significa alguns minutos de modo de manutenção, medidos em um ensaio. Se o seu negócio não aceita nenhuma janela de escrita congelada, converse com o suporte antes de marcar a data.
- Vale migrar: usuários no Brasil, aplicação em Node.js, Python, Bun, Go, Java ou PHP (ou em imagem Docker), PostgreSQL e Redis como bancos, vontade de pagar em real com PIX ou boleto.
- Pense duas vezes: dependência forte de add-ons sem equivalente, exigência de Private Spaces, usuários fora do Brasil ou receita em dólar.
Quanto custa antes e depois, em três tamanhos de aplicação
Para comparar, montamos três cenários típicos de quem roda no Heroku e escolhemos o plano mais próximo em memória na Zenifra. Os preços do Heroku foram lidos na página oficial em 06/11/2026. A conversão usa a PTAX de venda de 05/11/2026 publicada pelo Banco Central, R$ 5,4621 por dólar, e sobre o valor convertido entra o IOF de 3,5% das compras internacionais com cartão (Decreto 6.306/2007, art. 15-B, inciso VII, na redação do Decreto 12.499/2025). Os preços da Zenifra vêm do catálogo público de planos, o mesmo da calculadora do site, no mesmo dia.
Para a comparação ser justa, a coluna da Zenifra já inclui o disco do PostgreSQL no mesmo tamanho do plano do Heroku. Na Zenifra, o disco do PostgreSQL é cobrado à parte, a R$ 0,20 por GB ao mês, enquanto os planos do Heroku Postgres trazem o disco incluído: 1 GB no Essential-0, 10 GB no Essential-1 e 64 GB no Standard-0.
| Cenário | No Heroku | Preço em dólar | Pela PTAX de 05/11/2026 | Com IOF de 3,5% | Na Zenifra, em real |
|---|---|---|---|---|---|
| App pequeno | Basic (0,5 GB) + Postgres Essential-0 (1 GB de disco) | US$ 12,00 | R$ 65,55 | R$ 67,84 | Basic (0,5 vCPU, 512 MB) R$ 29,90 + DB-Starter R$ 11,90 + 1 GB de disco R$ 0,20 = R$ 42,00 |
| App com worker e Redis | 2 × Basic (web e worker) + Postgres Essential-1 (10 GB) + Key-Value Mini (25 MB) | US$ 26,00 | R$ 142,01 | R$ 146,99 | 2 × Basic R$ 59,80 + DB-Starter R$ 11,90 + 10 GB de disco R$ 2,00 + Valkey Chave-Valor DB-Starter R$ 11,90 + 1 GB de disco R$ 0,20 = R$ 85,80 |
| SaaS com duas instâncias | 2 × Standard-2X (1 GB) + Postgres Standard-0 (4 GB de RAM, 64 GB de disco) | US$ 150,00 | R$ 819,32 | R$ 847,99 | 2 × Premium (1 vCPU, 1 GB) R$ 125,80 + DB-Premium (2 GB) R$ 129,90 + 64 GB de disco R$ 12,80 = R$ 268,50 |
No segundo cenário, um Valkey Chave-Valor no DB-Starter (0,3 vCPU, 256 MB, com AOF) substitui o Key-Value Mini e serve tanto para cache e sessões quanto para filas do Sidekiq ou do Celery, com persistência. Se o Redis guarda só cache e você prefere um perfil só em memória, o cache-starter custa R$ 34,90 e leva o total a R$ 108,60, ainda abaixo dos R$ 146,99 do Heroku com IOF.
No terceiro cenário há um cuidado: a Zenifra não tem plano de PostgreSQL com 4 GB de memória. O DB-Premium tem 2 GB e o próximo, DB-Enterprise, tem 8 GB por R$ 489,00. Se o seu banco precisa de mais de 2 GB de memória, o total com DB-Enterprise e 64 GB de disco fica em R$ 627,60, ainda abaixo dos R$ 847,99 do Heroku com IOF. O limite de conexões também muda: o Standard-0 aceita 120 conexões, o DB-Premium 147 e o DB-Enterprise 598.
Duas observações de honestidade. O banco do cartão aplica o próprio spread sobre a cotação, então a fatura real em dólar tende a ficar acima do que aparece na tabela. E para ensaiar a migração, a cobrança por hora cobra só as horas em que os projetos ficam ligados.
Como os conceitos do Heroku viram conceitos da Zenifra
A maior parte do trabalho de migração é tradução de vocabulário. Um app do Heroku vira um projeto HTTP na Zenifra, e cada linha do Procfile vira um campo do projeto ou um projeto separado. A tabela abaixo reproduz o mapeamento do guia oficial de migração do Heroku nas docs da Zenifra, com dois acréscimos que o mesmo guia explica no texto: os outros add-ons e os arquivos gravados no disco do dyno.
Dois pontos merecem atenção desde já. A Zenifra não tem uma etapa equivalente à release phase, então a linha release: do Procfile vira o começo do Comando Start ou um passo manual, e isso muda a forma de rodar migrations. E cada processo além do web, como worker ou clock, vira outro projeto com o mesmo repositório, com Exposição Privado, porque um projeto da Zenifra roda um comando de start por vez.
| No Heroku | Na Zenifra |
|---|---|
| App | Projeto HTTP |
Processo web do Procfile | Comando Start do projeto |
Processo worker (ou outro nome) | Outro projeto com o mesmo repositório, Exposição Privado e o comando do worker |
Release phase (release:) | Início do Comando Start ou um passo manual |
| Buildpack | Runtime e Versão (Node.js, Python, Bun, Go ou Java) ou Imagem OCI |
| Config Vars | Variáveis de Ambiente |
Quantidade de dynos web | Instâncias Desejadas ou auto-scaling |
| Heroku Scheduler | Jobs agendados |
| Heroku Postgres | PostgreSQL gerenciado |
| Heroku Key-Value Store (Heroku Redis) | Cache gerenciado ou Chave-Valor |
| Review Apps | Ambientes de Preview |
heroku maintenance:on | Use no Heroku durante a cópia final dos dados |
| Outros add-ons (e-mail, monitoramento) | Continuam valendo se você mantiver a conta no provedor do add-on |
| Arquivos gravados no disco do dyno | Armazenamento persistente ou Armazém, compatível com S3 |
O PHP também roda como runtime na Zenifra: o guia lista o comando frankenphp php-server --listen :$PORT --root public/ para ele. Ruby, .NET e outras linguagens fora dos runtimes vão como Imagem Docker, construída a partir de um Dockerfile e enviada para um registry, e a GitHub Action da Zenifra automatiza a build e o deploy a cada push.
Passo 1: faça o inventário do app no Heroku
Antes de criar qualquer coisa na Zenifra, liste tudo o que o app usa: processos, bancos, cache, variáveis, domínios, tarefas agendadas e integrações externas. O roteiro geral das docs começa por aqui porque cada item vira uma decisão: um processo vira um projeto, uma tarefa agendada vira um Job, e uma variável que aponta para um add-on precisa de um valor novo. Os comandos abaixo usam a CLI do Heroku; troque meu-app pelo nome do app.
As Config Vars saem todas de uma vez com heroku config --shell. O arquivo gerado tem segredos: não versione e apague depois da migração. Ao revisar, separe três grupos. DATABASE_URL e REDIS_URL foram criadas pelos add-ons e apontam para os bancos do Heroku, então vão ganhar valores novos. Variáveis com prefixo HEROKU_ são da plataforma e só devem ser copiadas se o seu código usa alguma delas, com um valor equivalente. E variáveis de outros add-ons, como e-mail ou monitoramento, continuam valendo se você mantiver a conta no provedor do add-on.
Do Procfile, anote o comando de cada tipo de processo (release, web, worker e outros). Sem Procfile, o Heroku usa o padrão do buildpack, como o script start do package.json no Node.js. Anote também quantos dynos de cada tipo estão ligados, os buildpacks, os domínios e o destino DNS de cada um, se a aba Deploy está com Automatic deploys ligado e qual branch é publicada, e a lista de tarefas do Scheduler, com comando e frequência. Se o repositório tem um app.json, ele lista variáveis, add-ons e scripts usados pelos Review Apps.
A versão da linguagem vem do próprio repositório, e você vai precisar dela para escolher a mesma Versão principal no Console: engines.node no package.json (Node.js), .python-version ou runtime.txt (Python), a linha go do go.mod (Go), java.runtime.version no system.properties (Java), require.php no composer.json (PHP) e a entrada ruby no Gemfile (Ruby).
# Exporta as Config Vars (use --json se preferir JSON)
heroku config --shell -a meu-app > heroku.env
# Quantos dynos de cada tipo estão ligados
heroku ps -a meu-app
# Buildpacks, que indicam o Runtime na Zenifra
heroku buildpacks -a meu-app
# Domínios e o destino DNS de cada um
heroku domains -a meu-app
# Lista de tarefas agendadas
heroku addons:open scheduler -a meu-appPasso 2: crie os bancos e o projeto pelo GitHub
Crie primeiro o PostgreSQL gerenciado e, se o app usa Redis, o cache ou o banco Chave-Valor. Assim as URLs de conexão já existem quando você cadastrar as variáveis do projeto. Escolha a mesma versão principal do PostgreSQL do Heroku ou uma mais nova: a Zenifra oferece as versões 15, 16, 17 e 18, com a 18 como padrão. A senha completa do banco aparece só na criação ou depois de uma rotação, então guarde a URI de conexão nesse momento.
Depois, no Console, clique em + Criar projeto, escolha Aplicação HTTP e o plano. Em Configurações Avançadas, escolha Repositório Git em Origem do Projeto, o Provedor Git GitHub (ou Forgejo), o mesmo repositório e a branch publicada no Heroku. O buildpack da linguagem vira o campo Runtime, a versão do repositório vira Versão, a pasta do app vira Diretório raiz (use . para a raiz), a linha web: vira Comando Start, e o Automatic deploys ligado vira o modo de deploy Automático por branch. Com ele desligado, use o modo Manual.
O Heroku roda alguns passos de build sozinho; na Zenifra cada passo fica explícito no Comando Build. A tabela abaixo é a do guia oficial. No Node.js, os scripts heroku-prebuild, heroku-build e heroku-postbuild não rodam: coloque o que eles faziam no Comando Pré-build ou no Comando Build. A instalação usa npm ci e exige um package-lock.json versionado, então apps com Yarn ou pnpm precisam gerar e versionar esse arquivo antes. A variável NPM_CONFIG_PRODUCTION não é necessária, porque as devDependencies ficam disponíveis na build.
No Python, a Zenifra instala dependências a partir do requirements.txt. Se o Heroku usava poetry.lock, uv.lock ou Pipfile.lock, exporte um requirements.txt com poetry export -f requirements.txt --output requirements.txt ou uv export --format requirements-txt > requirements.txt e versione o resultado.
| Linguagem | Comando Build | Comando Start |
|---|---|---|
| Node.js | npm run build se o package.json tem script build; vazio se não tem | Linha web: do Procfile ou npm start |
| Python (Django) | python manage.py collectstatic --noinput | gunicorn projeto.wsgi --bind 0.0.0.0:8000 |
| Python (Flask, FastAPI) | vazio | Linha web: com --bind 0.0.0.0:8000 ou --host 0.0.0.0 --port 8000 |
| Go | go build -o app ./cmd/server (pasta do pacote main) | ./app |
| Java (Maven) | ./mvnw -B -DskipTests package ou mvn -B -DskipTests package | java -jar target/*.jar |
| PHP | vazio | frankenphp php-server --listen :$PORT --root public/ |
Passo 3: variáveis, porta, release phase, workers e Scheduler
Cadastre as Config Vars em Variáveis de Ambiente, trocando DATABASE_URL e REDIS_URL pelas URIs dos bancos novos. A DATABASE_URL não é injetada automaticamente na Zenifra: copie a URI do banco no Console e crie a variável no projeto. Cada projeto aceita até 50 variáveis, com valores de até 32.760 caracteres, e salvar uma alteração reinicia as instâncias. Variáveis usadas na build, como NEXT_PUBLIC_* ou VITE_*, ficam gravadas no resultado: para aplicar um valor novo, escolha Novo build em Logs de build ou publique um novo commit.
A porta é a diferença mais comum entre as plataformas. No Heroku, o processo web escuta na porta da variável PORT, escolhida pela plataforma. Na Zenifra, a porta é o campo Porta do projeto. Como o código já lê PORT, defina os dois com o mesmo valor, por exemplo Porta 3000 e a variável PORT=3000, e garanta que a aplicação escuta em 0.0.0.0, não em localhost. Como no Heroku, a Zenifra encerra o HTTPS antes de encaminhar a requisição, então mantenha as configurações de proxy confiável do framework, como trust proxy no Express, config.force_ssl no Rails ou --proxy-headers no uvicorn.
A release phase não tem etapa equivalente, e as docs dão duas saídas. A primeira é rodar a migration junto do start, como npx prisma migrate deploy && npm start ou python manage.py migrate && gunicorn .... O comando roda toda vez que uma instância inicia, então precisa ser idempotente, e com várias instâncias todas executam o comando, por isso prefira ferramentas que travam o banco durante a migration. A segunda é manual: rodar a migration da sua máquina, apontando para o banco da Zenifra, antes de publicar a versão que depende dela, que é o mais seguro para migrations longas.
Cada processo além do web vira um projeto: crie outro projeto HTTP com o mesmo repositório e a mesma branch, escolha Privado - sem rota pública em Exposição, use o comando do worker no Comando Start (por exemplo bundle exec sidekiq ou celery -A app worker) e cadastre as mesmas variáveis do projeto web. O processo clock pode virar um projeto privado do mesmo jeito ou ser trocado por Jobs agendados. Cada tarefa do Heroku Scheduler vira um Job agendado com Origem da tarefa Repositório GitHub, o mesmo Runtime, o comando em Comando da tarefa e as variáveis de que ela precisa.
| Frequência no Heroku Scheduler | Expressão cron na Zenifra |
|---|---|
| A cada 10 minutos | */10 * * * * |
| A cada hora, no minuto 30 | 30 * * * * |
| Todo dia às 06:00 UTC | 0 6 * * * |
| Dias úteis às 09:00 UTC (sem equivalente no Scheduler) | 0 9 * * 1-5 |
As duas plataformas usam UTC. Os Jobs da Zenifra são cobrados por minuto de execução, em real (o plano job-starter custa R$ 0,0001666666 por minuto), rodam no máximo uma execução por vez, encerram uma execução que passa de 60 minutos e não tentam de novo quando falham. No Heroku, o Scheduler é um add-on grátis, mas executa as tarefas em dynos avulsos que entram no consumo do mês, e a própria documentação do Heroku diz que a execução é esperada, mas não garantida.
Arquivos enviados por usuários merecem uma linha no inventário: no Heroku, o que é gravado no disco do dyno some quando ele reinicia. Na Zenifra, guarde arquivos no armazenamento persistente ou no Armazém, compatível com S3 e disponível para todas as organizações no Console. Se o app já usa um bucket S3, ele continua funcionando com as mesmas variáveis.
Passo 4: copie o Heroku Postgres e o Key-Value Store
O caminho mais simples para bancos pequenos é o backup do próprio Heroku. heroku pg:backups:capture gera o backup, heroku pg:backups:download baixa o arquivo latest.dump, e pg_restore --list confirma que o arquivo está íntegro antes de você restaurar. A documentação do Heroku recomenda o PGBackups para bancos com carga moderada de até 20 GB; acima disso, ou com muitos schemas e objetos grandes, o backup pode estourar o tempo.
Para bancos maiores, ou para copiar direto, pegue a URL do banco do Heroku com heroku pg:credentials:url DATABASE -a meu-app e use pg_dump em formato customizado. Use um pg_dump da mesma versão principal do banco ou mais nova. A restauração na Zenifra usa a URI do Console, que já liga o TLS com sslmode=require, e as opções --no-owner --no-acl evitam erros de permissão com usuários que não existem no banco novo. O --jobs=4 restaura em paralelo e encurta a janela de corte.
Depois de restaurar, valide. Compare a contagem de linhas das tabelas principais nos dois bancos com SELECT count(*) e rode os testes de fumaça da aplicação apontando para o banco novo. Faça um ensaio completo antes do dia da troca, cronometrando captura, download e restauração: esse tempo é a sua janela de manutenção. Lembre-se também de que o usuário do banco na Zenifra não tem acesso de superuser, mas tem acesso elevado suficiente para operar o banco normalmente.
Para o Key-Value Store, crie um cache gerenciado ou um banco Chave-Valor na Zenifra e troque a REDIS_URL. Dados de cache e de sessões costumam ser recriados pela aplicação, então não precisam de cópia. Se o Key-Value Store guarda filas, como as do Sidekiq ou do Celery, deixe os workers do Heroku esvaziarem a fila antes da troca, para que nenhum job fique para trás.
# Backup pelo próprio Heroku
heroku pg:backups:capture -a meu-app
heroku pg:backups:download -a meu-app # gera latest.dump
# Confere se o arquivo está íntegro
pg_restore --list latest.dump > /dev/null && echo "dump ok"
# Restaura no PostgreSQL da Zenifra
pg_restore --no-owner --no-acl --jobs=4 \
--dbname="postgresql://usuario:senha@host:porta/banco?sslmode=require" \
latest.dump# Banco maior que 20 GB: cópia direta com pg_dump
heroku pg:credentials:url DATABASE -a meu-app
pg_dump --format=custom --no-owner --no-acl "URL_DO_HEROKU?sslmode=require" > dump.pgdumpA URI do Console termina com ?sslmode=require e funciona em qualquer versão do psql, do pg_dump e do pg_restore, sem arquivo de certificado.
Passo 5: janela de corte, domínio, DNS e rollback
Antes de mexer no DNS, valide tudo pela URL *.clients.zenifra.com que o projeto recebe: login, fluxos principais, envio de e-mails, workers e webhooks. Confira em Logs de build e nos logs da aplicação se não há erros. Um dia antes da troca, reduza o TTL do registro DNS para 300 segundos, para que a mudança se propague rápido e um eventual retorno também.
No horário combinado, ligue o modo de manutenção do Heroku com heroku maintenance:on -a meu-app para congelar as escritas, faça a cópia final do banco como no passo anterior e adicione o domínio na Zenifra: abra o projeto, clique em Editar, vá em Domínios Personalizados, clique em Adicionar, informe o domínio e clique em Salvar Domínios Personalizados. A janela Configurar DNS dos domínios personalizados mostra os registros a criar no seu provedor DNS e os que precisam ser apagados.
Para um subdomínio, como www ou app, a tabela traz um CNAME e os registros TXT de validação. Para o domínio raiz, traz um único registro A no @, sem TXT; se o DNS está na Cloudflare, crie o A com o proxy desligado (Somente DNS). Não deixe AAAA nem um segundo A no @, e não remova e adicione o mesmo domínio para ver os registros de novo, porque os valores TXT mudam a cada cadastro: use Ver configuração DNS. O certificado HTTPS é emitido automaticamente depois que o DNS fica certo, e cada projeto aceita até 20 domínios personalizados.
Mantenha o app do Heroku ligado por alguns dias. Esse é o seu rollback de plataforma: se algo grave aparecer, volte o DNS para os destinos que heroku domains mostrou e desligue o modo de manutenção. Dados gravados na Zenifra depois da troca precisam voltar para o Heroku com o mesmo pg_dump e pg_restore, no sentido inverso. Já o rollback de versão dentro da Zenifra não é automático: em projetos no modo Automático por branch, faça um commit de revert ou publique um commit estável com zenifra deploy --project <project-id> --commit-sha <sha> ou com Novo build em Logs de build. Lembre que voltar o código não desfaz migrations no banco.
Checklist final e erros comuns depois da migração
O checklist abaixo junta o checklist do dia da troca das docs com os pontos específicos do Heroku. Passe por ele no ensaio e de novo no dia da troca; quase todos os problemas de migração aparecem no ensaio, quando ainda não custam nada.
A tabela de erros comuns reúne os sintomas listados no guia de migração do Heroku e dois que aparecem com frequência em quem vem de outras plataformas: o limite de conexões do PostgreSQL e a URI antiga do banco, copiada antes da mudança para sslmode=require.
- TTL do DNS reduzido para 300 segundos com um dia de antecedência.
- Aplicação validada na URL
*.clients.zenifra.com, incluindo workers, e-mails e webhooks. - Variáveis revisadas, sem URLs do Heroku, e
PORTigual ao campo Porta. - Migrations rodadas no início do Comando Start ou manualmente, antes da versão que depende delas.
- Um projeto privado para cada processo além do
web, e um Job agendado para cada tarefa do Scheduler. - Webhooks externos (pagamentos, GitHub, e-mail) atualizados para o novo domínio.
- Cópia final dos dados concluída e validada com contagem de linhas.
- Domínio configurado e HTTPS ativo.
- App do Heroku mantido ligado por alguns dias; depois, dynos desligados e add-ons removidos para parar a cobrança.
| Sintoma | Causa provável | Correção |
|---|---|---|
npm ci falha | App usa Yarn ou pnpm, sem package-lock.json | Gere e versione um package-lock.json |
| Build Python não instala dependências | Projeto usa Poetry, uv ou Pipenv | Exporte um requirements.txt |
| URL pública não responde | App escuta em localhost ou em outra porta | Escute em 0.0.0.0, na porta do campo Porta, e defina PORT |
| Tabelas não existem | A release phase não roda na Zenifra | Rode as migrations no Comando Start ou manualmente |
| Tarefas em segundo plano paradas | Worker não foi criado | Crie um projeto privado para cada processo além do web |
assets ou staticfiles faltando | O buildpack fazia esse passo sozinho | Coloque collectstatic ou assets:precompile no Comando Build |
remaining connection slots are reserved | Pool de conexões acima do limite do plano (15 no DB-Starter, 72 no DB-Basic, 147 no DB-Premium) | Limite o pool, somando todas as instâncias da aplicação |
Erro ENOENT system com pg no Node.js | URI antiga, com sslrootcert=system | Copie a URI de novo no Console; ela termina com ?sslmode=require |
Preciso mudar meu código para sair do Heroku?
Em geral, não. A Zenifra faz deploy do mesmo repositório do GitHub (ou Forgejo) ou de uma imagem Docker, e as mudanças costumam ficar na configuração do projeto, não no código. O que mais aparece é escutar em 0.0.0.0 na porta definida em Porta, ler a DATABASE_URL nova e mover a migration da release phase para o Comando Start.
Em Node.js, versione um package-lock.json se o app usa Yarn ou pnpm, e passe para o Comando Build o que os scripts heroku-postbuild faziam. Em Python, exporte um requirements.txt se o projeto usa Poetry, uv ou Pipenv. Em Ruby e .NET, o caminho é uma imagem Docker. Se a sua aplicação usa pg no Node.js, a URI do Console funciona sem ajuste.
Como fica a release phase do Heroku na Zenifra?
Não existe uma etapa equivalente, então a linha release: do Procfile vira uma de duas coisas: o começo do Comando Start, como npx prisma migrate deploy && npm start, ou um passo manual que você roda da sua máquina contra o banco da Zenifra antes de publicar a versão que depende da migration.
No Comando Start, o comando roda sempre que uma instância inicia, então precisa ser idempotente, e com várias instâncias todas o executam: prefira ferramentas de migration que travam o banco. Para migrations longas ou destrutivas, o passo manual é o mais seguro, e vale seguir a recomendação das docs de rollback: migrations compatíveis com duas versões da aplicação, testadas antes em um ambiente separado.
O Heroku Scheduler tem equivalente na Zenifra?
Sim: cada tarefa do Scheduler vira um Job agendado, criado com Origem da tarefa Repositório GitHub, o mesmo Runtime do app, o comando em Comando da tarefa e uma Expressão cron de cinco campos em UTC. Como as duas plataformas usam UTC, "todo dia às 06:00" vira 0 6 * * * sem conversão de fuso.
A diferença é que o Job aceita qualquer expressão cron, como 0 9 * * 1-5 para dias úteis, enquanto o Scheduler oferece frequências fixas. O Job é cobrado por minuto de execução, em real, e tem regras claras: uma execução por vez, limite de 60 minutos e nenhuma nova tentativa automática quando falha. Se a tarefa precisa de retentativa, trate isso no próprio código ou em uma fila.
Quanto tempo a aplicação fica fora do ar na troca?
Só o tempo da cópia final do banco, porque a aplicação já está publicada e validada na Zenifra antes da troca. Durante esse intervalo, o modo de manutenção do Heroku congela as escritas, e o domínio continua respondendo com a página de manutenção.
Esse tempo depende do tamanho do banco e de quanto o pg_restore --jobs=4 consegue paralelizar, e a única forma confiável de saber é o ensaio completo que o roteiro das docs recomenda. Com o TTL do DNS em 300 segundos, a propagação da troca também fica curta. Se o resultado do ensaio for uma janela grande demais para o seu negócio, fale com o suporte antes de marcar a data.
Dá para ensaiar a migração antes e pagar com PIX?
Sim. Com a cobrança por hora, o ensaio custa só as horas em que os projetos ficam ligados: o Basic custa R$ 0,05 por hora e o DB-Starter R$ 0,018 por hora, mais R$ 0,20 por GB de disco ao mês. O crédito entra por PIX, a partir de R$ 5, ou boleto, a partir de R$ 30. O cadastro pede CPF ou CNPJ, celular e endereço no Brasil. Dá para subir o app pelo GitHub, restaurar uma cópia do banco do Heroku e validar os fluxos principais antes de mudar o domínio.
Um ensaio de 8 horas com o Basic e o DB-Starter custa R$ 0,544, mais o disco, e a cobrança vem em real, por PIX, boleto ou cartão, sem IOF.