zebian.

Escrita · ensaio

Migrei o Supabase da cloud para self-hosted (e o que correu mal)

Uma das minhas apps era a última ainda agarrada à cloud da Supabase. Mudá-la para o meu servidor parecia um copiar e colar. Não foi: apareceram permissões em falta, logins desligados e sessões que se evaporaram. A história de como parti tudo e voltei a pô-la de pé.

Há uns meses meti-me a tirar as minhas apps da cloud e a pô-las a correr num servidor que é meu. Não por teimosia, embora também haja disso: é mais barato, os dados ficam comigo, e há um gozo parvo em saber que a coisa toda corre numa máquina a que eu chego por SSH. Uma a uma, fui mudando. Faltava a última, e era a que eu tinha medo de tocar: a App1, um joguinho que se joga sem conta nenhuma, é só carregar e começar.

A App1 usa o Supabase, que é basicamente a caixa onde guarda tudo: a base de dados, os logins, e a maneira de lhes aceder. Estava na versão alugada (cloud). O plano era mudar essa caixa para uma cópia que já tinha montado no meu servidor. No papel, um copiar e colar. Na prática, quatro becos sem saída em fila. Conto-os todos, porque foi a parte que me ensinou alguma coisa, e porque se alguém fizer o mesmo, talvez chegue lá mais depressa do que eu.

O plano que parecia simples

A ideia era a de sempre nestas migrações: copiar a base de dados da cloud para o meu servidor, apontar a app para a cópia, e publicar. O jogo nem deixa de funcionar, porque os dados são os mesmos.

O primeiro problema apareceu antes de eu sequer começar.

Beco 1: a cópia estava velha

Eu já tinha copiado a base de dados para o servidor. Há semanas. E o jogo, claro, não esperou por mim: continuou vivo na cloud todo este tempo, com gente a jogar. Quando fui ver, a cópia do servidor tinha 50 jogadores e a cloud tinha 98. Se eu publicasse assim, metade das pessoas desaparecia.

A solução foi não confiar na cópia antiga e fazer uma fresca, da base de dados viva, na hora. Com um cuidado importante: copiar sem mexer no original. A cloud ficou exatamente como estava, eu só li dela.

Do lado do servidor, em vez de andar a apagar tabela a tabela (que tropeça em mil regras de dependência entre os dados), desliguei as travas todas de uma vez, limpei, e recarreguei tudo dentro de uma única transação. Em Postgres isto faz-se com uma linha mágica:

set session_replication_role = replica;

Aquilo diz à base de dados “por agora, ignora as travas de segurança e os automatismos”. Limpo as tabelas, despejo lá os dados frescos, e volto a ligar tudo. Se alguma coisa corresse mal a meio, a transação inteira era cancelada e o servidor ficava como estava. Rede de segurança.

Resultado: a cópia do servidor passou a ser um espelho exato da cloud naquele momento. 98 jogadores de um lado, 98 do outro. Boa. O difícil, pensei eu, estava feito.

Beco 2: “não tens permissão”

Apontei a app para o servidor e fui ver. Erro em tudo. Código 42501, “permission denied for schema public”.

Demorei a perceber, porque a base de dados estava lá, cheia de dados, perfeita. O problema não eram os dados, era quem os podia ler. O Supabase tem um “convidado”, um utilizador interno chamado anon, que é o que lê os dados quando alguém visita o site sem estar autenticado de forma especial. Na minha migração, as autorizações por omissão que o Supabase normalmente dá a esse convidado tinham-se perdido pelo caminho. A casa estava cheia, mas a porta estava trancada para quem chegava.

A reparação foi devolver as chaves:

grant usage on schema public to anon, authenticated, service_role;
grant all on all tables in schema public to anon, authenticated, service_role;
grant all on all sequences in schema public to anon, authenticated, service_role;
grant all on all routines in schema public to anon, authenticated, service_role;
alter default privileges in schema public
  grant all on tables to anon, authenticated, service_role;
notify pgrst, 'reload schema';

A última linha é fácil de esquecer e é a que faz a diferença: avisa a camada de API que as regras mudaram, para ela recarregar e parar de dizer que não. Sem isto, podia ter as permissões certas e continuar a ver o erro.

Fica a lição número um para quem migrar uma base de dados Supabase: depois de um restore, confirma sempre as permissões. É o tropeço mais clássico que há.

Beco 3: ninguém conseguia entrar

Permissões resolvidas, os dados a aparecer. Fui tentar jogar. A App1 deixa entrar sem conta nenhuma, como convidado, é metade da graça, carregas e jogas. Só que agora dava erro: anonymous_provider_disabled.

O serviço que trata dos logins, no meu servidor, vinha com a opção de “entrar como anónimo” desligada de fábrica. Na cloud estava ligada, por isso eu nunca tinha pensado nisso. Liguei-a:

ENABLE_ANONYMOUS_USERS=true

E recriei o contentor desse serviço para apanhar a mudança. A partir daí, voltou a deixar entrar sem conta. Lição número dois: quando se muda de instância, não basta levar os dados, há que confirmar que os métodos de login que a app usa estão todos ligados do outro lado.

Beco 4: as sessões evaporaram-se (o mais traiçoeiro)

Este não dá erro nenhum. É pior, é silencioso, e foi o que me obrigou a aceitar um custo que não tinha previsto.

Quando alguém entra como convidado, recebe uma espécie de crachá digital, guardado no browser, que diz “este é o jogador tal”. Esse crachá vem assinado com uma chave secreta da instância. E aqui está a coisa: a chave secreta do meu servidor é diferente da chave da cloud. Tinha de ser, são instâncias separadas.

O que isto quer dizer na prática: no momento em que a app passou a falar com o servidor, todos os crachás que as pessoas tinham guardado, assinados pela cloud, deixaram de ser reconhecidos. O servidor olha para o crachá antigo e não confia nele. Resultado: o jogador volta como convidado novo, do zero.

Os dados antigos não se perdem, continuam na base de dados. Mas ficam órfãos: lá estão o histórico e a pontuação daquele jogador, só que ninguém consegue provar que é o dono. Para uma app com login por email e password isto não acontece, a pessoa volta a entrar e está tudo lá. Para convidados anónimos, é o preço de mudar de casa. Decidi que, para um jogo, era um preço aceitável. Mas é o tipo de pormenor que mais vale saber antes, e não descobrir com um jogador a perguntar onde foram parar os pontos dele.

A prova: 98 para 99

Faltava a parte mais satisfatória: ter a certeza de que a app de produção estava mesmo a escrever no meu servidor, e não a fingir.

Pus o site a apontar em definitivo para o servidor, abri a App1 como qualquer pessoa a abriria, e fui jogar uma corrida. Depois fui espreitar o número de jogadores na base de dados do servidor. Tinha passado de 98 para 99. O 99 era eu. Pequeno, mas é a prova que interessa: o jogo real, na internet, a criar um registo novo na minha máquina. Migração feita.

O que aprendi

Se tivesse de resumir a quem vá fazer o mesmo:

  • Faz a cópia fresca na hora. Um snapshot de há semanas mente-te, e a app não pára de viver enquanto tu hesitas.
  • As permissões perdem-se no restore. Conta com isso e volta a dá-las, sem esquecer o aviso final à camada de API.
  • Confirma os métodos de login do outro lado. O que está ligado na cloud pode vir desligado de fábrica.
  • As sessões anónimas não sobrevivem. Chave de assinatura diferente, crachás antigos inválidos. Aceita-o ou avisa as pessoas.

E porquê todo este trabalho para mudar uma coisa que já funcionava? Porque agora é mesmo minha. Deixei de pagar a renda da cloud, os dados estão num servidor a que eu chego quando quiser, e da próxima vez que algo destes correr mal, o erro é meu para resolver. O que, estranhamente, é a parte de que mais gosto.