Guarde os dados do seu app no Railway Postgres
ResumindoO conector do Railway faz duas coisas independentes. Com um token de API, o ID do projeto e o ID do ambiente, ele permite publicar o app no Railway. Se você também informar a string de conexão pública do seu Railway Postgres, o MonstarX leva as tabelas e linhas do app para lá, confere tudo e reescreve o app para usar esse banco. Mover de volta traz os dados para casa.
O Railway é uma plataforma em nuvem para rodar apps e bancos de dados. O conector do Railway no MonstarX liga um dos seus apps ao seu projeto Railway para uma ou para as duas tarefas a seguir:
- Guardar os dados do app no Railway Postgres — o seu próprio banco Postgres no Railway, em vez do banco do MonstarX. É isso que esta página explica.
- Publicar o app no Railway — rodar o app no seu projeto Railway a partir do repositório dele no GitHub. Veja Publique em outras hospedagens.
As duas coisas são independentes: os dados podem ficar no Railway Postgres enquanto o app é publicado no MonstarX, e vice-versa.
Quando devo usar o Railway Postgres?
Seção intitulada “Quando devo usar o Railway Postgres?”Escolha essa opção quando você já roda coisas no Railway, quer os dados do app na sua própria conta ou quer acessá-los com as suas próprias ferramentas de banco de dados. Fora isso, o banco de dados do próprio MonstarX não exige nenhuma configuração — veja O banco de dados do seu app.
Um app guarda os dados em um lugar por vez. Ir para o Railway Postgres é uma mudança, não uma cópia.
Antes de começar
Seção intitulada “Antes de começar”No Railway:
- Abra (ou crie) um projeto no Railway e escolha o ambiente que vai usar, normalmente production.
- Adicione um serviço de banco de dados Postgres a ele e ative a public networking (rede pública) desse serviço, para que o MonstarX consiga acessá-lo.
- Crie um token de API de conta ou de espaço de trabalho em Account Settings → Tokens, no Railway. Um token de projeto não consegue criar serviços, então não funciona.
No MonstarX, os dados do app precisam estar no banco de dados do próprio MonstarX. Se estiverem no Supabase ou no Firestore, volte com eles antes.
Como levo os dados do meu app para o Railway Postgres?
Seção intitulada “Como levo os dados do meu app para o Railway Postgres?”-
Abra o seu projeto e clique em Backend na barra superior e depois em Nuvem.
-
Em Conectores, clique em Conectar ao lado do Railway — ou escolha Railway (Postgres) em Onde este app armazena seus dados.
-
Preencha o formulário:
- Token de API da conta ou espaço de trabalho — o token do Railway.
- ID do projeto — nas configurações do seu projeto no Railway.
- ID do ambiente — nas mesmas configurações.
- String de conexão pública do Postgres (opcional) — o
DATABASE_PUBLIC_URLdo seu serviço Postgres. É isso que dá início à migração; deixe em branco se você só quer publicar no Railway.
-
Clique em Conectar Railway. O MonstarX confere se o ambiente pertence ao projeto e se consegue criar tabelas no banco de dados.
-
Aparece um cartão no chat: Migrar os dados deste app para o Railway Postgres, com quantas tabelas e linhas ele encontrou. Clique em Migrar meu app.
-
O cartão mostra cada etapa — lendo os dados, criando as tabelas, copiando as linhas, verificando se tudo chegou, apontando o app para o Railway, reescrevendo o código do app — e termina com Seu app agora roda no Railway Postgres.
Em seguida, o cartão Banco de dados em BackendNuvem passa a mostrar No Railway.
O que acontece com os meus dados?
Seção intitulada “O que acontece com os meus dados?”- Todas as tabelas e linhas vão para o seu banco Railway Postgres, e o MonstarX conta os dois lados antes de fazer a troca. Se as contagens não baterem, a migração para e o app fica como estava.
- O MonstarX mantém a cópia anterior, intacta, para você poder voltar.
- O código do app é reescrito para Postgres em uma solicitação de criação que o próprio MonstarX envia.
- Enquanto a migração roda, as novas solicitações aguardam na fila, e Parar no cartão interrompe a migração.
Posso voltar?
Seção intitulada “Posso voltar?”Sim. Clique em Mover de volta no cartão Banco de dados em BackendNuvem e confirme. O MonstarX copia tudo de volta para o próprio banco de dados e reescreve o código de novo. O seu banco de dados no Railway fica como está.
É bom saber
Seção intitulada “É bom saber”- O token fica com o MonstarX. O token de API, o ID do projeto e o ID do ambiente são guardados de forma criptografada e usados só pelo MonstarX para gerenciar o Railway. Eles nunca vão para o app.
- A string de conexão vai só para o servidor do app, e só depois da troca. Ela nunca chega ao navegador.
- Não dá para desconectar o Railway, nem trocar o banco de dados dele, enquanto o app o usa. Volte antes para o MonstarX.
- Tirar do ar (no Railway) remove só o serviço que o MonstarX criou, nunca o seu banco Postgres.
- Apps importados mantêm o próprio código de banco de dados: o MonstarX entrega a eles a string de conexão como
RAILWAY_DATABASE_URL, mas não migra os dados. - Um endereço privado do Railway não funciona. O MonstarX precisa da string de conexão pública para acessar o banco de dados.
Perguntas frequentes
Seção intitulada “Perguntas frequentes”Preciso publicar no Railway para usar o Railway Postgres?
Não. As duas coisas são independentes. O app pode continuar sendo publicado no MonstarX enquanto os dados ficam no Railway Postgres.
Qual string de conexão eu colo?
O DATABASE_PUBLIC_URL do serviço Postgres, depois de ativar a rede pública dele. Um endereço de rede privada não pode ser acessado pelo MonstarX.
Por que o meu token foi recusado?
Os tokens de projeto do Railway não conseguem criar serviços. Crie um token de conta ou de espaço de trabalho em Account Settings → Tokens, no Railway.
Posso trocar do Supabase para o Railway?
Sim, em duas etapas: use Mover de volta para trazer os dados ao banco de dados do MonstarX e depois conecte o Railway Postgres.
Os meus usuários vão precisar se cadastrar de novo?
Não. As contas são linhas no banco de dados do app, então vão junto com o resto dos dados e continuam funcionando.