Migre do Replit Auth para o Clerk

Use este guia para mover um app existente do Replit Auth para o Clerk Auth. O Agent cuida da migração para apps elegíveis, para que usuários que retornam mantenham acesso aos seus dados existentes.

​

Inicie a migração

As migrações do Agent devem sempre ser executadas em uma nova task. Você pode iniciar a migração de uma das seguintes formas:

​

Iniciar a partir do Agent

​

Iniciar a partir do painel Auth

​

Revise o plano de migração

De qualquer forma que você iniciar, o Agent cria a task Migrate from Replit Auth to Clerk e prepara o plano de migração. Selecione View plan e revise o plano antes que a task prossiga. Não altere o código de autenticação do seu app nem as credenciais do Clerk enquanto o Agent estiver trabalhando.

​

O que o Agent faz

O Agent conclui a migração nesta ordem:

1. Move os dados de usuário do Replit Auth para o Clerk, incluindo detalhes de identidade da conta e credenciais de login suportadas.
2. Aguarda a conclusão da migração de dados antes de alterar seu app.
3. Atualiza a lógica de login e sessão do seu app, reinicia o app e executa as verificações automatizadas disponíveis.

​

Os dados do seu app permanecem no lugar

O Agent altera apenas o código de autenticação do seu app. Ele não atualiza os dados existentes nem o esquema do banco de dados do seu app. Suas tabelas e relacionamentos permanecem intactos. Seus usuários existentes continuam conectados aos registros que já possuem, como perfis, trabalho salvo e permissões.

​

Quanto tempo leva

Espere que o Agent trabalhe entre 10 minutos e uma hora. A migração de dados em si pode levar alguns minutos para apps menores e até algumas horas para apps com muitos usuários. O Agent não começa a alterar o código do seu app até que essa migração seja concluída.

​

Depois da migração

Antes de publicar, teste o app atualizado em Desenvolvimento:

1. Faça login com uma conta existente e confirme que seus dados salvos estão disponíveis.
2. Saia e faça login novamente.
3. Crie uma nova conta de teste e confirme que ela consegue usar o app como esperado.

​

Recursos adicionais

• Visão geral do Clerk Auth — Como o Clerk Auth funciona no Replit
• Planeje uma migração de autenticação personalizada — Planeje uma migração a partir de um sistema de autenticação personalizado