주권 마이그레이션 확인

Ultimate Multisite 1.2.0 버전부터 소유권 테넌트(sovereign tenant) 마이그레이션을 위한 WP-CLI 확인 명령어가 포함되었습니다. 테넌트 마이그레이션, SSO 방문 또는 격리 설치가 예상대로 작동하지 않을 때 이 명령어들을 사용하세요.

실행할 명령어

네트워크 WordPress 설치에서 확인을 실행합니다.

wp tenant verify-no-legacy --site=<site-id>
wp tenant verify-sovereign-push --site=<site-id>

마이그레이션하려는 테넌트의 사이트 ID를 사용하세요. 첫 번째 명령어는 해당 테넌트가 더 이상 레거시 네트워크 측 데이터에 의존하지 않는지 확인합니다. 두 번째 명령어는 소유권 푸시 작업이 처리되고 정리(drain)될 수 있는지 검증합니다.

일반적인 실패 사례

데이터베이스 권한이 호스트와 일치하지 않음

확인 결과에서 권한 또는 writer-user 오류가 보고되면 설정된 데이터베이스 호스트를 확인하세요. localhost, 127.0.0.1, 그리고 컨테이너 서비스 이름은 서로 다른 MySQL 권한 호스트입니다. 테넌트 호스트 바인딩이나 데이터베이스 권한을 업데이트한 후 다시 확인을 실행해 보세요.

Bedrock 또는 로컬 설치에서 연결할 수 없음

Bedrock 및 로컬 소켓 설치의 경우, 런타임이 정규화된 주소를 통해 연결하더라도 데이터베이스를 localhost로 보고할 수 있습니다. 버전 1.2.0에서는 동일 머신의 호스트 문자열을 정규화하지만, 사용자 지정 호스트 오버라이드가 데이터베이스 권한과 충돌할 수 있습니다.

비동기 푸시 큐가 정리되지 않음

verify-sovereign-push가 완료되지 않으면 Action Scheduler 또는 설정된 비동기 러너를 확인하세요. 실패한 작업은 안전하다고 확인한 후에만 삭제하거나 재시도해야 합니다.

테넌트 사용자 수가 잘못됨

마이그레이션 시 소유권 테넌트를 위한 사용자가 프로비저닝되어야 합니다. 예상되는 설치 사용자가 누락된 경우, SSO를 다시 시도하기 전에 사용자 프로비저닝 단계를 다시 실행해 보세요.

SSO 방문 거부

상태 비저장(Stateless) 테넌트 자동 로그인을 위해서는 테넌트 도메인, 오리진 핀(origin pin), 토큰 목적(token purpose), nonce, 만료일이 모두 일치해야 합니다. SSO 방문을 생성한 직후에 테넌트 URL이 올바른지 확인하고 로그인 시도를 해보세요.

재시도할 때

모든 검증 항목이 통과할 때까지 인프라 변경 후에는 매번 인증을 다시 시도해 주세요. 모든 검증 체크가 완료될 때까지 프로덕션 트래픽을 전환하거나, 소스 데이터를 삭제하거나, 마이그레이션 자격 증명을 제거하지 마세요.