主権移行の検証

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を使用してください。最初のコマンドは、そのテナントがもはやレガシーなネットワーク側のデータに依存していないかを確認します。2番目のコマンドは、ソブリンプッシュジョブが処理およびドレインできるかを確認します。

よくある失敗例

データベースの権限が一致しない

検証で「grant」または「writer-user」のエラーが報告された場合は、設定されているデータベースホストを確認してください。「localhost」、「127.0.0.1」、コンテナサービスのホスト名などは、MySQLのgrantホストとして異なる場合があります。テナントのホストバインディングまたはデータベース権限を更新してから、検証を再実行してください。

Bedrockまたはローカルインストールが接続できない

Bedrockやローカルソケットインストールの場合、データベースがlocalhostと報告される一方で、ランタイムは正規化されたアドレス経由で接続しようとする場合があります。バージョン1.2.0では同一マシン上のホスト文字列を正規化しますが、カスタムのホスト上書き設定がデータベース権限と競合する可能性があります。

非同期プッシュキューがドレインされない

verify-sovereign-pushが完了しない場合は、Action Schedulerまたは設定されている非同期ランナーを確認してください。ジョブが安全に再試行または破棄できることを確認してから、失敗したジョブをクリアしてください。

テナントのユーザー数が間違っている

移行によってソブリンテナント用のユーザーがプロビジョニングされるはずです。期待されるインストールユーザーが見当たらない場合は、SSOを再試行する前にユーザープロビジョニングの手順を再度実行してください。

SSO訪問が拒否される

ステートレステナントの自動ログインでは、テナントドメイン、オリジンピン、トークンの目的、nonce（ワンタイム値）、および有効期限が一致している必要があります。SSO訪問を生成した後、テナントURLが正しいことを確認し、すぐにログインを試みてください。

再試行するタイミング

インフラの変更のたびに検証を再試行してください。すべての検証チェックがパスするまで、本番トラフィックの切り替え、ソースデータの削除、または移行認証情報の削除はしないでください。