Verificación de Migración Soberana
Ultimate Multisite: Multi-Tenancy 1.2.0 incluye comandos de verificación WP-CLI para migraciones de inquilinos soberanos. Úsalos cuando una migración de inquilino, una visita SSO o una instalación aislada no se comporten como se espera.
Comandos a ejecutar
Ejecuta la verificación desde la instalación de WordPress en la red:
wp tenant verify-no-legacy --site=<site-id>
wp tenant verify-sovereign-push --site=<site-id>
Utiliza el ID del sitio para el inquilino que estás migrando. El primer comando comprueba que el inquilino ya no dependa de datos heredados del lado de la red. El segundo comando verifica que los trabajos de empuje soberano puedan procesarse y drenarse correctamente.
Fallos comunes
Los permisos de la base de datos no coinciden con el host
Si la verificación reporta fallos en los permisos de grant o writer-user, comprueba el host de la base de datos configurado. localhost, 127.0.0.1 y un nombre de servicio de contenedor son hosts de MySQL diferentes para permisos. Actualiza la vinculación del host del inquilino o los permisos de la base de datos, y luego vuelve a ejecutar la verificación.
Las instalaciones Bedrock o locales no pueden conectarse
Las instalaciones Bedrock y las instalaciones con socket local pueden reportar la base de datos como localhost mientras que el tiempo de ejecución se conecta a través de una dirección normalizada. La versión 1.2.0 normaliza las cadenas de host de la misma máquina, pero las anulaciones de host personalizadas aún pueden entrar en conflicto con los permisos de la base de datos.
La cola de empuje asíncrono no se drena
Si verify-sovereign-push no termina, comprueba Action Scheduler o el ejecutor asíncrono configurado. Borra los trabajos fallidos solo después de confirmar que es seguro reintentarlos o descartarlos.
El número de usuarios del inquilino es incorrecto
La migración debe provisionar usuarios para el inquilino soberano. Si falta el usuario de instalación esperado, vuelve a ejecutar el paso de provisión de usuarios antes de intentar la visita SSO de nuevo.
La visita SSO es rechazada
El inicio de sesión automático para inquilinos sin estado requiere que el dominio del inquilino, la clave de origen (origin pin), el propósito del token, el nonce y la fecha de caducidad coincidan. Confirma que la URL del inquilino es correcta y que se intenta iniciar sesión poco después de generar la visita SSO.
Cuándo reintentar
Vuelve a intentar la verificación después de cada cambio en la infraestructura. No cambies el tráfico de producción, elimines los datos de origen ni elimines las credenciales de migración hasta que todas las comprobaciones de verificación pasen.