Antes de fazer a alteração, confira de onde virão as exportações do banco, os arquivos enviados, o código das funções e as configurações do projeto se precisar deles novamente.
Este checklist ajuda a identificar essas partes e preparar um backup que você pode inspecionar antes da próxima migração.
Comece pelo que seu backup atual cobre
O Supabase oferece opções de backup de banco de dados, incluindo Point-in-Time Recovery para configurações elegíveis. Confira o que está disponível e habilitado no seu projeto.
Backups de banco de dados contêm os metadados do Storage, mas não incluem os arquivos armazenados pela API do Storage. Restaurar o banco não recupera um objeto que foi excluído do Storage.
Fonte: backups de banco de dados do Supabase ↗Por isso, vale conferir os componentes antes de começar.
Seu checklist de backup antes da migração
Revise estas cinco áreas antes de fazer a alteração. Registre o que está coberto e as etapas adicionais necessárias ao seu projeto.
01 Estrutura do banco de dados, dados e regras de acesso
Identifique as alterações que você vai fazer no banco e as informações necessárias para recuperar o ambiente.
Seu checklist deve contemplar:
- Tabelas e seus dados.
- Funções, triggers e índices usados pela aplicação.
- Papéis, permissões e políticas de segurança em nível de linha.
- Extensões das quais sua aplicação depende.
Registre o projeto de origem e a data do backup. Confira se as exportações esperadas foram geradas e revise os erros antes de continuar.
02 Arquivos do Storage
Liste os buckets usados pela aplicação e confirme como seus objetos serão copiados.
Confira alguns arquivos representativos após o backup, inclusive de buckets privados aos quais você tenha acesso autorizado. Registre também as configurações e políticas de acesso dos buckets.
Uma exportação do banco que contém referências aos arquivos não comprova que os arquivos em si foram copiados.
03 Edge Functions
Guarde o código-fonte das funções e a configuração de publicação necessária à aplicação.
Registre os segredos exigidos por cada função e onde recuperá-los com segurança. Evite colocar credenciais em notas compartilhadas, capturas de tela ou repositórios públicos.
04 Autenticação e configurações do projeto
Confira as configurações ao redor do banco: provedores de autenticação, URLs de redirecionamento, variáveis de ambiente da aplicação e configurações do Realtime.
Para migrações a um novo projeto, o Supabase documenta configurações adicionais para componentes como Storage, Edge Functions e Auth. Os registros de usuários e a configuração do Auth são partes distintas desse processo. Fonte: restauração de projetos Supabase ↗
05 Etapas de verificação e recuperação
Revise os arquivos do backup comparando-os com seu checklist.
Você consegue localizar as exportações esperadas do banco? Abrir arquivos de exemplo? Identificar o código e as configurações das funções de que precisará?
Anote as etapas manuais restantes. Antes de confiar no backup para recuperação, ensaie o processo de restauração relevante em um destino separado sob seu controle.
DO CHECKLIST AO PRIMEIRO BACKUP
Use o smoonb para preparar seu próximo backup
O Smoonb oferece um fluxo guiado pelo CLI para fazer backup de projetos Supabase.
Use-o para preparar os componentes suportados do projeto, inspecionar os arquivos gerados e identificar configurações adicionais necessárias à migração.
- Crie sua conta e confirme seu e-mail.
- Abra o guia de configuração do CLI e prepare seu ambiente. Você precisará das ferramentas Node.js, Docker, Supabase CLI e PostgreSQL documentadas, além de acesso autorizado ao projeto.
- Gere sua primeira chave de licença quando estiver pronto. Isso inicia seu teste de cinco dias.
- Instale o smoonb localmente no diretório de trabalho com
npm install smoonb, e siga as instruções de configuração. - Execute
npx smoonb backup, siga as instruções e compare os arquivos gerados com o checklist acima.
Revise o escopo suportado para seu projeto e registre as etapas manuais. Após concluir um comando, confira os arquivos que ele produziu.
É necessário um plano pago para continuar após o teste; aplicam-se os limites do plano. Veja planos e preços.
Inclua isso na sua próxima publicação
Guarde o checklist com a documentação do projeto. Atualize-o ao adicionar um bucket, uma função, um provedor de autenticação ou outra dependência.
Para quem mantém várias aplicações Supabase, repetir essa preparação antes de alterações relevantes pode fazer parte da rotina de publicação.
Comece pelo próximo projeto que você vai alterar.