wp-wpcli-and-ops

WP-CLI と運用

使用するタイミング

WP-CLI を使った WordPress の運用作業が含まれるタスクでは、このスキルを使用します。以下が含まれます。

• wp search-replace（URL の変更、ドメイン移行、プロトコルの切り替え）
• DB のエクスポート／インポート、リセット、確認（wp db *）
• プラグイン／テーマのインストール、有効化、更新、言語パック
• cron イベントの一覧表示／実行
• キャッシュ／リライトルールのフラッシュ
• マルチサイトの運用（wp site *、--url、--network）
• 繰り返し実行可能なスクリプトの作成（wp-cli.yml、シェルスクリプト、CI ジョブ）

必要な入力

• WP-CLI を実行する環境（ローカル開発、ステージング、本番）と、安全に実行できるかどうか。
• 対象サイトのルートを指定する方法：
  • --path=<wordpress-root> および（マルチサイトの場合）--url=<site-url>
• マルチサイトかどうか、またコマンドをネットワーク全体に対して実行するかどうか。
• 制約（ダウンタイム不可、DB 書き込み不可、メンテナンス時間帯）。

手順

0) 安全対策：環境と影響範囲を確認する

WP-CLI コマンドは破壊的な操作を実行する可能性があります。書き込みを伴う操作を実行する前に、以下を確認してください。

1. 環境を確認します（開発／ステージング／本番）。
2. 誤ったサイトを対象にしないよう、対象（パス／URL）を確認します。
3. リスクのある操作を行う場合は、バックアップを作成します。

参照：

• references/safety.md

1) WP-CLI とサイトの対象指定を確認する（決定的な確認）

インスペクターを実行します。

• node skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs --path=<path> [--url=<url>]

WP-CLI を利用できない場合は、プロジェクトで指定されているツール（Composer、コンテナー、システムパッケージ）を使ってインストールするか、想定されている実行環境を確認してください。

2) 適切なワークフローを選ぶ

A) 安全な URL／ドメイン移行（search-replace）

以下の安全な手順に従います。

1. wp db export（バックアップ）
2. wp search-replace --dry-run（影響を確認）
3. 適切なフラグを指定して、実際に置換を実行します
4. 必要に応じてキャッシュ／リライトルールをフラッシュします

参照：

• references/search-replace.md

B) プラグイン／テーマの操作

wp plugin *／wp theme * を使用し、意図したサイト（およびネットワーク）を対象としていることを、事前に確認してください。

参照：

• references/packages-and-updates.md

C) cron とキュー

cron の状態を確認し、デバッグでは「すべてをむやみに実行」するのではなく、個々のイベントを実行してください。

参照：

• references/cron-and-cache.md

D) マルチサイトの運用

マルチサイトの変更は、多数のサイトに影響する場合があります。必ず、次のどちらを対象にするか決定してください。

• 単一サイト（--url=）、または
• ネットワーク全体（--network／サイトを順次処理）

参照：

• references/multisite.md

3) 自動化のパターン（スクリプトと wp-cli.yml）

繰り返し実行する運用作業では、以下を優先してください。

• デフォルト設定（path/url、PHP のメモリ制限）には wp-cli.yml を使用する
• コマンドを記録し、エラー時に停止するシェルスクリプトを使用する
• 読み取り専用のチェックをデフォルトで実行する CI ジョブを使用する

参照：

• references/automation.md

検証

• 対象指定や設定に影響する変更を行った後、wpcli_inspect を再実行します。
• 想定どおりの副作用が発生したことを確認します。
  • 正しい URL が更新されている
  • プラグイン／テーマが想定どおりの状態になっている
  • 必要に応じて cron／キャッシュがフラッシュされている
• ヘルスチェック用のエンドポイントやスモークテストスイートがある場合は、運用変更後に実行します。

失敗のパターン／デバッグ

• 「Error: This does not seem to be a WordPress installation.」
  • --path が誤っている、コンテナーが誤っている、または wp-config.php が見つからない
• マルチサイトのコマンドが誤ったサイトに影響している
  • --url が指定されていないか、URL が誤っている
• Search-replace によって予期しないシリアライズの問題が発生する
  • フラグが誤っているか、シリアライズされたデータを安全でない方法で変更している

参照：

• references/debugging.md

エスカレーション

• 環境の安全性を確認できない場合は、書き込み操作を実行しないでください。
• リポジトリでコンテナー化されたツール（Docker／wp-env）が使われているもののアクセスできない場合は、想定されているコマンドランナーまたは CI ジョブを確認してください。