Apps feitos com IA

Publicar um app do Replit na Zenifra

Você pode continuar criando o app no Replit e publicar na Zenifra. O código vai para um repositório no GitHub, e a Zenifra faz o build e publica a partir dele. Quase tudo o que o console da Zenifra pede já está no arquivo .replit do projeto.

1. Envie o código para o GitHub

No Replit, ligue a sua conta GitHub nos serviços conectados da conta. Depois, abra a ferramenta Git no projeto e conecte um repositório:

  • Para enviar as mudanças, faça commit e clique em Push no painel Git.
  • Para que o repositório acompanhe o Replit sem cliques, ative o auto-sync no painel Git. Ele sincroniza nos dois sentidos.
  • Se a sincronização parar, reconecte o GitHub nos serviços conectados. O Replit recomenda um token de acesso pessoal fine-grained para uma conexão mais estável.

Detalhes na documentação do Replit sobre Git.

2. Copie a configuração do arquivo .replit

O .replit fica na raiz do repositório. Um app Node.js criado pelo Agent costuma ter algo assim:

.replit
modules = ["nodejs-20", "web", "postgresql-16"]

[deployment]
deploymentTarget = "autoscale"
build = ["npm", "run", "build"]
run = ["npm", "run", "start"]

[[ports]]
localPort = 5000
externalPort = 80

[env]
PORT = "5000"

Cada parte vira um campo do console da Zenifra:

No .replitNo console da ZenifraNo exemplo
modules: nodejs-20, python-3.11 etc.Runtime e VersãoNode.js, versão 20
[deployment] › buildComando Build, com as partes unidas por espaçonpm run build
[deployment] › runComando Startnpm run start
[[ports]] › localPortPorta5000
[env]Variáveis de AmbientePORT=5000
modules: postgresql-16Um PostgreSQL gerenciado, na etapa 4DATABASE_URL

Se o [deployment] não tem build, deixe o Comando Build vazio. Se o run é ["sh", "-c", "cd main && python app.py"], use cd main && python app.py no Comando Start, ou preencha Diretório raiz com main e use python app.py.

A Zenifra oferece Node.js 20, 22, 24 e 26 e Python 3.11, 3.12, 3.13 e 3.14. Veja Runtimes.

Segredos do Replit

Os valores da ferramenta Secrets do Replit não vão para o GitHub. Abra Secrets no Replit e cadastre cada um em Variáveis de Ambiente na Zenifra. O DATABASE_URL do banco do Replit não aparece em Secrets; na Zenifra, ele vem do banco novo, na etapa 4.

3. Crie o projeto na Zenifra

No console, clique em + Criar projeto, escolha Aplicação HTTP e o plano. Em Origem e porta, escolha Repositório Git em Origem do Projeto, o Provedor Git GitHub, o repositório e a branch. Se for a primeira vez, conecte sua conta GitHub e instale o GitHub App da Zenifra no repositório.

Preencha os campos com a tabela da etapa 2. No runtime Node.js, a Zenifra instala as dependências com npm ci, que precisa de um package-lock.json no repositório. Os apps Node.js do Replit costumam já ter esse arquivo; veja Dependências Node.js.

A aplicação precisa escutar em 0.0.0.0 e na porta do projeto. Os apps do Agent já leem a variável PORT. Por isso, cadastre PORT com o mesmo valor da Porta.

4. Leve o banco de dados

Se o .replit tem um módulo postgresql-*, o app usa o PostgreSQL do Replit pela variável DATABASE_URL.

  1. Crie um PostgreSQL gerenciado na mesma organização.
  2. Copie a URI de conexão do banco e cadastre-a como DATABASE_URL no projeto da aplicação. Veja Conectar ao banco.
  3. Copie os dados do banco de produção do Replit com pg_dump e pg_restore, como em Migrar o banco de dados. Para a URI de origem, abra a ferramenta Database do Replit, escolha o banco de produção e copie o Connection string da aba Settings.

Confira o arquivo de conexão, normalmente server/db.ts. Apps mais antigos do Replit usam o driver @neondatabase/serverless, que conecta por WebSocket ao proxy da Neon e não funciona com um PostgreSQL comum. Troque pelo pg com o Drizzle:

server/db.ts
import pg from 'pg'
import { drizzle } from 'drizzle-orm/node-postgres'
import * as schema from '@shared/schema'

export const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL })
export const db = drizzle({ client: pool, schema })

Instale o driver com npm install pg e faça commit do package.json e do package-lock.json.

5. Publique e teste

Ao criar o projeto, a primeira build começa na hora. Acompanhe em Logs de build e, quando terminar, abra a URL do projeto. Teste uma tela que lê do banco e uma que grava. Depois disso, cada push no GitHub publica uma nova versão; veja Deploy automático.

Recursos do Replit

Alguns recursos usados por apps do Replit são serviços do próprio Replit:

  • Replit Auth: o login usa a conta Replit de quem acessa. Antes de trocar o domínio, confirme na documentação do Replit se o login do seu app funciona fora do Replit, ou troque por um login próprio.
  • App Storage: os arquivos ficam no armazenamento do Replit. Para guardar arquivos na Zenifra, use o Armazém, compatível com S3.
  • Tarefas agendadas: viram Jobs agendados.

Domínio próprio

Quando o app estiver funcionando pela URL da Zenifra, aponte o seu domínio para o projeto. Veja Domínios personalizados.

Problemas comuns

SintomaCausa provávelO que fazer
A build falha na instalação das dependênciasRepositório sem package-lock.json ou com o arquivo fora de sincroniaRode npm install localmente e faça commit do package-lock.json
A aplicação não passa na verificação de saúdeA Porta é diferente da porta em que o app escutaUse o localPort do .replit na Porta e em PORT
O app encerra com DATABASE_URL must be setFalta a variável do bancoCadastre DATABASE_URL com a URI do PostgreSQL gerenciado
Erro de WebSocket ao conectar no bancoDriver @neondatabase/serverlessTroque pelo pg, como na etapa 4

Última atualização em

Nessa página