Você voltou àquele projeto que ficou parado.
Talvez seja um produto que decidiu retomar. Um protótipo que finalmente encontrou um cliente. Ou uma aplicação que precisa recuperar.
Ao abrir o Supabase, encontra uma limitação: o projeto já não pode ser reativado pelo painel. Ainda existem arquivos de backup para baixar — mas como transformar esses arquivos em um ambiente funcionando novamente?
O Smoonb possui um fluxo para importar backups do Dashboard e disponibilizá-los para restauração em outro projeto. Neste guia, vamos mostrar o caminho: baixar os arquivos disponíveis, importá-los, preparar o destino, restaurar e conferir o que foi recuperado.
O ponto de partida pode ser o próprio backup baixado do Dashboard do Supabase. Guarde uma cópia dos arquivos originais e trabalhe com um novo projeto de destino.
Por que o projeto Supabase não pode mais ser reativado?
Projetos do plano gratuito podem ser pausados após um período de baixa atividade. A documentação atual do Supabase informa uma janela de um ano, contada desde a pausa, para reativar o projeto pelo Dashboard.
Depois desse prazo, quando os arquivos ainda estão disponíveis, o caminho é baixar o backup do banco e os arquivos do Storage e recuperá-los em um novo projeto. O Supabase também documenta a recuperação manual; aqui vamos usar o fluxo de importação e restauração do Smoonb.
Se o projeto ainda permite reativação, use essa opção no Dashboard. Se ele já foi excluído e você não guardou os arquivos, este fluxo não consegue recuperar um backup que deixou de existir.
Confira a disponibilidade dos arquivos e as condições atuais no painel antes de começar. Os links oficiais estão ao final do artigo.
1. Baixe e preserve os arquivos disponíveis
No Dashboard do projeto pausado, baixe o backup do banco e, se disponível, o arquivo separado do Storage. Salve tudo em uma pasta local. Preserve também uma cópia original antes de iniciar a recuperação.
Dados e definições SQL incluídos no dump.
Os objetos enviados, quando disponíveis separadamente.
O backup do banco sozinho não contém os arquivos reais do Storage.
O importador do Smoonb aceita o backup do banco em .backup ou .backup.gz. Mantenha o nome original no padrão do Dashboard, como o exemplo abaixo. Não o renomeie para um nome genérico.
db_cluster-04-03-2024@14-16-59.backup.gzO arquivo opcional de Storage deve terminar em .storage.zip. Um dump do banco pode conter registros sobre os objetos, mas não substitui os arquivos de imagens, documentos e outros uploads.
2. Importe o backup para o Smoonb
Com o Smoonb instalado localmente, abra o terminal na pasta de trabalho. Informe o arquivo do banco e, quando existir, o arquivo do Storage. Substitua os nomes de exemplo pelos nomes dos seus arquivos.
npx smoonb import --file "db_cluster-04-03-2024@14-16-59.backup.gz" --storage "meu-projeto.storage.zip"Se você tem apenas o backup do banco, omita a opção --storage:
npx smoonb import --file "db_cluster-04-03-2024@14-16-59.backup.gz"A importação organiza os arquivos em uma pasta de backup do Smoonb para que apareçam no fluxo de restauração. Essa etapa usa os arquivos locais: ela não exige que o projeto de origem volte a funcionar.
A importação prepara os arquivos. A recuperação no destino acontece na etapa de restauração; é nela que você verifica a compatibilidade do conteúdo com o novo ambiente.
3. Prepare um novo projeto Supabase
Crie um novo projeto Supabase para receber a recuperação. Use um destino vazio e confira a referência do projeto antes de prosseguir: a restauração escreve dados no destino selecionado.
- Configure o Smoonb e sua chave de licença. O teste gratuito dura cinco dias desde a geração da primeira licença.
- Prepare as ferramentas exigidas pelo fluxo de restauração, incluindo Docker e Supabase CLI.
- Cadastre as credenciais e o mapeamento do projeto de destino conforme a configuração do Smoonb.
- Mantenha credenciais fora de capturas de tela, repositórios públicos e mensagens compartilhadas.
Se ainda não configurou o CLI, crie sua conta Smoonb e siga as instruções de configuração no painel.
4. Restaure o backup e confira o resultado
Na mesma pasta de trabalho, inicie o fluxo de restauração:
npx smoonb restoreSelecione o backup importado e confira o mapeamento para o novo projeto. Acompanhe as mensagens do processo e trate os avisos antes de reconectar sua aplicação.
A confirmação de uma etapa não substitui a conferência dos dados e dos arquivos. Use esta lista para revisar o destino:
Confira tabelas, registros importantes e políticas de acesso.
Abra arquivos e imagens reais; confira buckets e permissões.
Teste acesso, recuperação de senha e permissões com uma conta controlada.
Confira funções, integrações e configurações do novo projeto.
No Storage, confira os arquivos de verdade, além da presença dos buckets. Se algum objeto falhar no envio, verifique os avisos e resolva a pendência antes de considerar a recuperação concluída.
5. Reconecte a aplicação ao projeto recuperado
Um projeto novo tem uma nova identidade. Depois da recuperação, atualize a URL e as chaves usadas pela aplicação e revise as integrações que apontavam para o projeto antigo.
- Revise as configurações do Auth: provedores, URLs de retorno, SMTP e templates de e-mail.
- Confira Realtime, funções, secrets e extensões necessárias ao seu aplicativo.
- Atualize endpoints em hospedagem, webhooks e outros serviços externos.
O que pode ser recuperado depende do que está nos arquivos disponíveis. Configurações do painel, código de funções e segredos não devem ser presumidos como parte do backup do banco.
Para planejar a proteção do projeto daqui para frente, use também nosso checklist de backup Supabase.
Dúvidas sobre recuperar um projeto Supabase pausado
Preciso ter criado o backup com o Smoonb?
Não. O comando import aceita arquivos de backup baixados do Dashboard do Supabase, nos formatos e nomes compatíveis descritos neste guia.
Isso reativa o projeto antigo?
A recuperação é feita em um novo projeto. Você utiliza os arquivos preservados e depois reconecta sua aplicação ao novo destino.
O backup do banco recupera todos os arquivos do Storage?
Os objetos do Storage precisam do arquivo correspondente, quando disponível. O backup do banco sozinho não contém os arquivos enviados pelos usuários.
Posso começar sem cartão de crédito?
Sim. O Smoonb oferece cinco dias de teste gratuito, sem cartão, a partir da geração da sua primeira chave de licença.