Verificação de Migração Soberana
O Ultimate Multisite: Multi-Tenancy 1.2.0 inclui comandos de verificação WP-CLI para migrações de inquilinos soberanos (sovereign tenants). Use-os quando uma migração de inquilino, visita SSO ou instalação isolada não se comportarem como o esperado.
Comandos a serem executados
Execute a verificação da instalação do WordPress na rede:
wp tenant verify-no-legacy --site=<site-id>
wp tenant verify-sovereign-push --site=<site-id>
Use o ID do site para o inquilino que você está migrando. O primeiro comando verifica se o inquilino não depende mais de dados legados do lado da rede. O segundo comando verifica se os jobs de push soberano podem ser processados e esvaziados (drained).
Falhas comuns
Permissões do banco de dados não correspondem ao host
Se a verificação reportar falhas de permissão (grant) ou de usuário escritor (writer-user), verifique o host do banco de dados configurado. localhost, 127.0.0.1 e um nome de serviço de container são hosts MySQL de permissão diferentes. Atualize a vinculação do host do inquilino ou as permissões do banco de dados, e depois execute a verificação novamente.
Instalações Bedrock ou locais não conseguem se conectar
Instalações Bedrock e locais podem reportar o banco de dados como localhost enquanto o runtime se conecta através de um endereço normalizado. A versão 1.2.0 normaliza as strings de host da mesma máquina, mas sobrescritas de host personalizadas ainda podem entrar em conflito com as permissões do banco de dados.
Fila de push assíncrono não é esvaziada (drained)
Se o verify-sovereign-push não terminar, verifique o Action Scheduler ou o runner assíncrono configurado. Limpe os jobs falhos somente depois de confirmar que estão seguros para serem reprocessados ou descartados.
Contagem de usuários do inquilino está incorreta
A migração deve provisionar usuários para o inquilino soberano. Se o usuário de instalação esperado estiver faltando, execute novamente a etapa de provisionamento de usuários antes de tentar o SSO novamente.
Visita SSO é rejeitada
O login automático do inquilino sem estado exige que o domínio do inquilino, o pin de origem (origin pin), o propósito do token, o nonce e a expiração sejam iguais. Confirme se a URL do inquilino está correta e tente fazer o login logo após gerar a visita SSO.
Quando tentar novamente
Tente a verificação após cada mudança na infraestrutura. Não mude o tráfego de produção, exclua os dados da origem ou remova as credenciais de migração até que todos os testes de verificação sejam aprovados.