青天の霹靂に備える、Magento保守移行・引き継ぎチェックリスト

青天の霹靂に備える、Magento保守移行・引き継ぎチェックリスト


「長年任せていたMagento(Adobe Commerce)の開発ベンダーがM&Aで買収され、親会社の方針で別プラットフォームへの移行を迫られた」「突然、現行システムの保守終了を告げられた」——。

近年、EC業界の再編やベンダー側の経営ガバナンスの変化に伴い、「自社(事業会社)には落ち度がないのに、青天の霹靂でMagentoの保守先を切り替えざるを得なくなった」というご相談が急増しています。

本記事では、Magentoの保守を他社へスムーズに移管するために、旧ベンダーから確実に回収・確認すべき「システムログイン情報・構成図・ライセンス・運用・デプロイ手順」から、最悪の事態に備える「バックアップからのリストア手順および復旧テスト成功の証跡」まで、実践チェックリストを網羅的に解説します。


1. なぜ急なMagento保守移管は難航しやすいのか?

ベンダー側の経営判断やM&Aによる保守終了では、旧ベンダーのエンジニアリソースがすでに別事業へシフトしており、「最低限の資料しか出てこない」「口頭での説明時間が十分に取れない」ケースが少なくありません。引き継ぎ時に以下の3つが欠落していると、移管後の仕様解析に膨大な工数(コスト)がかかり、障害時の復旧も遅れてしまいます。

難航する主な要因 引き継ぎ後に発生する現場トラブル
① 変更履歴・設計背景の欠如 「なぜこの独自仕様になっているのか」が不明なため、セキュリティパッチ1つ当てるのにも「どこが壊れるかわからない」ブラックボックス状態に陥る。
② ライセンス・契約の所在不明 Adobe Commerceライセンスや有償エクステンション、AWS等のインフラ契約が旧ベンダー名義のままになっており、移管時に契約切り替えや再購入が必要になる。
③ デプロイ・リストア手順の属人化 Magento特有のビルド・デプロイ工程や、最悪のケース(データ破損等)に備えたバックアップからのリストア手順が実証されておらず、重大障害時に復旧できない。
【重要:「バックアップを取っている」だけでは不十分です】
引き継ぎ時に「自動バックアップは設定済み」と回答されても、いざ障害時に復元しようとすると「権限エラーで戻せない」「商品画像(pub/media)が対象外だった」「手順が古くエラーになる」というトラブルが多発します。必ずリストア手順書と、直近のリストアテスト成功の証明(証跡)をセットで確認してください。

2. 【保存版】Magento保守引き継ぎ必須アセット一覧

旧ベンダーとの保守契約が終了するまでに、以下の6領域のアセットを漏れなく回収・確認してください。

引き継ぎカテゴリー 回収・確認すべき必須チェック項目
最優先
1. システムログイン情報・権限
・Magento管理画面(Admin)の最高権限アカウント(2段階認証の再設定手順含む)
・サーバー/クラウドインフラの管理者権限(AWS、GCP、Adobe Commerce Cloud等のIAM権限・SSH鍵)
・DB(MySQL)・キャッシュ(Redis / Varnish)・検索(OpenSearch)の接続情報
・Gitリポジトリ(GitHub / GitLab等)の管理者権限およびドメイン・DNS・SSL管理権限
・外部連携サービスのAPIキー一覧(決済代行、WMS、ERP、MAツール、CDN等)
契約・権利
2. ライセンスの所在
・Adobe Commerceライセンスの契約名義と更新期限(自社契約か旧ベンダー代理契約か)
・導入済み有償エクステンションの一覧とライセンスキー・Marketplace購入アカウントの所在
・Composer認証キー(auth.json)(モジュールのアップデートや再ビルドに必須)
・インフラ・ミドルウェア・監視ツール等の契約名義と月額費用一覧
設計・経緯
3. システム構成図・変更履歴
・インフラ構成図・外部連携データフロー図(サーバー台数、LB、CDN、基幹・決済連携の同期タイミング)
・独自カスタマイズ一覧・DB拡張定義(コア改修の有無、独自テーブル・カスタム属性の目的)
・過去の変更履歴・設計背景メモ(「なぜこの構成・独自仕様になっているか」「過去にどんな障害がありどう回避しているか」の経緯)
・既知の不具合・未対応の技術負債リスト
開発・リリース
4. デプロイ手順・開発環境
・ローカル開発環境・ステージング環境の構築手順書(サーバ間の依存関係、環境変数、ダミーデータ投入方法)
・Gitブランチ運用ルール(本番用・開発用ブランチの命名規則とマージフロー)
・本番デプロイ手順書(setup:upgrade / di:compile / static-content:deploy 等の実行順序とダウンタイム有無)
・切り戻し(ロールバック)手順(デプロイ失敗時に直前の状態へ戻す具体的な手順)
最後の砦
5. バックアップ・リストア手順とテスト証跡
・バックアップ対象範囲・スケジュール・保管場所(DBに加え、商品画像等の pub/media や設定ファイル app/etc/env.php が含まれているか)
・バックアップからのリストア(復元)手順書(最悪のケースでシステム破損時にゼロから復元する具体的コマンド)
・リストアテスト成功の証明(証跡)(実際に復元して正常稼働まで確認したテスト記録・実施日・結果ログ)
日常・障害対応
6. 運用フロー・稼働確認手順
・デプロイ後・リストア後の稼働確認手順書(フロント表示、カート投入、決済テスト、管理画面、外部連携の正常性チェック項目)
・Cron(定期バッチ)一覧と監視方法(受注・在庫連携、インデックス更新の実行スケジュールとエラー対処法)
・日次・月次の定常運用および例外対応マニュアル(手動補正や特定顧客向けイレギュラー対応)
・障害時の一次切り分け・エスカレーションフロー(アラート通知先、ログ出力場所、緊急連絡網)

※旧ベンダーの協力期間が短い場合は、まず「1. ログイン情報」「2. ライセンス・Composerキー」「5. バックアップデータ」の確保を最優先に進めてください。

3. 引き継ぎ現場で多発する「ハマりどころ」と回避策

ドキュメントを受け取っただけで安心してしまうと、実際の保守運用が始まってから思わぬ落とし穴にハマります。

① 「なぜこの構成なのか?」がわからず改修が止まる

Magentoは柔軟なカスタマイズができる反面、「過去の特定キャンペーンのために無理やり入れたフック処理」や「基幹システム側の制約を回避するための特殊なバッチ処理」が残っていることが多々あります。変更履歴や設計背景のドキュメントがない場合は、旧ベンダーの担当者に「一番触るのが怖い箇所・過去に障害が起きた箇所はどこか?」をヒアリングし、録画・議事録化しておくことが極めて有効です。

② リストアテスト未実施のまま引き継ぎ、緊急時に復元できない

最悪のケースでシステムが破損した際、手順書通りにコマンドを打っても「環境変数の不備」や「メディアファイルの容量超過・権限エラー」で復元できないケースがあります。引き継ぎ期間中に、ステージング環境等を使って実際にバックアップからのリストア演習を行い、稼働確認手順書に沿って正常動作を証明するステップを組み込みましょう。

③ 稼働確認(正常性チェック)の基準が曖昧

「デプロイ後にトップページが表示されたからOK」としてしまい、実はバックグラウンドの在庫同期バッチや特定の決済手段がエラーになっていた、という事故も頻発します。引き継ぎ時に「どこまで確認すれば正常稼働と言えるか」のチェックリストを明文化しておく必要があります。

4. 協力期間が短い場合の「引き継ぎ進行ステップ」

旧ベンダーの撤退スケジュールが迫っており、すべての資料をゼロから作成してもらう余裕がない場合は、以下の3ステップで効率的に引き継ぎを進めます。

Step 1. 権限・コード・バックアップの保全(契約終了 2ヶ月前〜)

まずはシステムの「実体」を自社および新保守ベンダーの管理下に移します。ログイン情報、Gitリポジトリ、Composer認証キー(auth.json)、ライセンス契約、および最新バックアップデータの所在を確保できれば、最悪の場合でもコード解析から保守を継続できます。

Step 2. デプロイ・リストア・稼働確認のハンズオン録画(契約終了 1ヶ月前〜)

完璧な手順書の作成を待つよりも、Web会議の画面共有で旧ベンダーに「本番デプロイ」「検証環境へのリストア」「稼働確認」を実演してもらい、その操作画面と解説を録画するのが最も確実でスピーディです。この実演が成功すれば、そのまま「リストアテスト成功の証明」にもなります。

Step 3. 変更履歴・技術負債のQ&Aヒアリング(契約終了 直前まで)

コードや構成図を見て疑問に思った点(「なぜこのサーバー構成になっているのか?」「この独自モジュールの役割は?」)をスプレッドシート等にまとめ、旧ベンダーのエンジニアから回答を引き出します。

5. よくある質問(FAQ)

Q 旧ベンダーから設計書や構成図がほとんど出てこない場合でも引き継ぎは可能ですか?

A. はい、可能です。
ソースコード(Gitリポジトリ)とサーバー・インフラへのアクセス権限さえ確保できれば、新しい保守ベンダー側でコードやサーバー設定を解析(ソースエンジニアリング)し、最新のシステム構成図や仕様書を再作成することができます。まずは権限とバックアップの確保を最優先に進めましょう。

Q Magentoの保守移管にはどのくらいの期間を見ておくべきですか?

A. 規模やカスタマイズ量にもよりますが、目安として1.5ヶ月〜3ヶ月程度が理想です。
権限移管やライセンスの名義変更手続き、検証環境でのデプロイ・リストアテスト、並行稼働期間を含めると2ヶ月前後あると安全です。期限が1ヶ月を切っている緊急案件の場合は、並行して調査・保全を行う体制が求められます。

6. まとめ

ベンダー側のM&Aや経営方針転換に伴う急な保守切り替えは事業会社にとって大きな痛手ですが、適切なチェックリストで引き継ぎを行うことで、ブラックボックス化していたシステムを健全化する好機にもなります。

  • ログイン情報・ライセンス・Composerキー・構成図・変更履歴を漏れなく回収する
  • デプロイ手順や稼働確認手順は、可能な限りハンズオン(画面共有・録画)で実演してもらう
  • 最悪の事態に備え、バックアップからのリストア手順と「リストアテスト成功の証明」を必ず確保する

Magento(Adobe Commerce)の保守移管・引き継ぎはACROVEにお任せください

私たちは、単にシステムを構築・保守するだけの開発会社ではありません。
他社で構築された複雑なMagento環境の調査・棚卸しから、安全な保守移管、BtoB・大規模SKUサイトの安定運用、さらには将来的な内製化支援まで伴走するパートナーです。

現行ベンダーからの切り替えや引き継ぎでお困りの方、以下のようなお悩みがあればいつでもご相談ください:

  • 「ベンダーの方針転換やM&Aにより、急にMagentoの保守先を探さなければならなくなった」
  • 「旧ベンダーから十分なドキュメントが出てこず、今の構成やライセンス状況が把握できていない」
  • 「BtoB要件や外部連携が複雑で、引き受けてくれる技術力の高い保守ベンダーが見つからない」

どんな些細な疑問でも構いません。まずは、私たちに貴社のMagento環境の状況をお聞かせください。

貴社のECビジネスの継続性と安全性を、確かなMagento技術力で守り抜きましょう。