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 Main Agent

1. Na conversa principal do Agent, peça ao Agent para migrar seu app do Replit Auth para o Clerk.
2. O Agent propõe uma task de migração separada para você revisar e iniciar.

​

Iniciar a partir do Auth Pane

1. No Editor de Projeto, abra Tools e selecione Users & Auth.
2. No banner Introducing a new Replit Auth, selecione Update now.
3. Selecione Ask Agent to migrate.

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 Development:

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