Adobe Commerce導入のトラブルシューティング

Adobe Commerceでのスタックしたデプロイメントと失敗したデプロイメントは、デプロイメントのトラブルシューティング ツールを使用して解決できます。 各質問をクリックすると、トラブルシューティングの各ステップの回答が表示されます。

説明 description

環境

クラウドインフラストラクチャー上のAdobe Commerce

問題/症状

  • 環境でのデプロイメントの停止または失敗
  • 他の環境で進行中のアクティビティが原因でデプロイメントがブロックされる
  • ノードへの SSH アクセスの問題
  • サービスが実行されていない(Elasticsearch、cron、Composer 関連など)
  • ディスク領域または inode の制限が不十分です
  • 403/Elasticsearch version/config エラー
  • リモートクラスターのアップロード失敗または再展開エラー
  • 長時間実行されているプロセス、フック後のエラー、サードパーティ拡張機能の競合
  • 低速のクエリとデータベース側の問題(MySQL)
  • Composer 設定の問題またはパッチ制約

解決策 resolution

手順 1 - サービスが実行中であることを確認

Adobe Commerce on cloud infrastructure service は稼働していますか?

デプロイメントの停止 – クラウドインフラストラクチャサービス上でAdobe Commerceは稼働していますか。 Adobe Commerce Cloud (Adobe ステータス ページの Experience Cloudの下 ​)を確認します。

  • 対応 – ステップ 2 に進みます。
  • なし – メンテナンスまたはグローバルな停止。 推定期間と更新を確認します。

手順 2 – 他の環境でのデプロイメントの確認

既存の環境のデプロイメントをブロックしているデプロイメントが他の環境にありますか?

進行中のアクティビティのリストを取得するには、magento-cloud CLI を使用して次のコマンドを実行します(1 つのクラウドプロジェクトにのみ追加されている場合)。 メモ: magento-cloud CLI の最新バージョンを使用していることを確認してください。 手順については、Cloud 上のCommerce ガイドの CLI の更新 ​ を参照してください。

code language-none
magento-cloud --state=in_progress

進行中のアクティビティのリストを取得するには、magento-cloud を使用して次のコマンドを実行します(複数のプロジェクトに追加されている場合)。

code language-none
magento-cloud -p <project-id or project-url> --state=in_progress

既存のデプロイメントアクティビティに関する情報を見つけるには(詳しくは Cloud UI で「ログが出荷された」エラーの場合のデプロイメントログの確認 ​ を参照)、このコマンドを実行して、そのアクティビティの実行ログを取得できます。

code language-none
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • 対応 – 他の環境がデプロイメントをブロックする場合のトラブルシューティング。 手順 3 に進みます。
  • いいえ – 現在の環境のトラブルシューティングを行います。 手順 3 に進みます。

手順 3 – すべてのノードで SSH を確認する

すべてのノードで SSH に成功しますか?

手順 4 – 実行中のすべてのサービスの確認

すべてのサービスが実行中ですか?

手順 5 - ビットバケットの実行状態の確認

Bitbucket を使用しますか?

手順 6 - エラーコードを確認

エラーコードが報告されていますか?
  • 対応 – ステップ 7 に進みます。
  • いいえ – ステップ 8 に進みます。

手順 7 - 403 Forbidden エラー

403 禁断?
  • 対応 – 手順 16 に進みます。
  • いいえ – ステップ 9 に進みます。

手順 8 – 実行中の cron ジョブの確認

cron ジョブは現在実行中ですか? 分岐に SSH でログインし、次のコマンドを実行します。
code language-none
ps aufxx | grep cron
  • 対応 – cron ジョブの強制終了とロック解除:

    code language-none
    php vendor/bin/ece-tools cron:kill
    

    php vendor/bin/ece-tools cron:unlock

  • いいえ – 手順 17 に進みます。

手順 9 - リモートクラスターにデプロイ可能なアプリケーションのエラー

リモートクラスターにアプリケーションをアップロードできないというエラーが発生しましたか?
  • 対応 – 手順 10 に進みます。
  • いいえ – 手順 11 に進みます。

手順 10 – 十分なストレージの確認

使用可能なストレージは問題ない?

手順 11 - ディスク容量の確認

ファイルに警告を書き込めませんでしたか?
  • 対応 –

    • 統合/スターター環境の場合:.magento.app.yaml でディスク値を増やし、再デプロイします。 それでもうまくいかない場合は、​ サポートチケットを送信 ​ してください。 または、大きなログファイルを削除します。
    code language-none
    ls -la var/log
    
  • いいえ – 手順 12 に進みます。

手順 12 – 環境の再デプロイメントに失敗しましたエラー

環境の再デプロイメントに失敗しましたエラーですか?
  • 対応 – 手順 13 に進みます。
  • いいえ – 手順 8 に進みます。

手順 13 - Elasticsearchのアップグレードに失敗したかどうかを確認する

Elasticsearchをアップグレードまたはデプロイしますか?
  • 対応 – Elasticsearchでアップグレード手順に失敗しました。 Elasticsearch ソフトウェア互換性 ​ を参照してください。 それでもElasticsearchのアップグレードが機能しない場合は、​ サポートチケットを送信 ​ してください。 注意: クラウドインフラストラクチャー上のAdobe Commerceでは、インフラストラクチャチームに 48 営業時間通知しなければ、サービスアップグレードを実稼動環境にプッシュすることはできません。 実稼動環境のダウンタイムを最小限に抑え、目的の期間内に設定を更新できるインフラストラクチャサポートエンジニアを確保する必要があるので、これが必要になります。 そのため、変更を実稼動環境で行う必要がある 48 時間前に、必要なサービスアップグレードの詳細とアップグレードプロセスを開始する時刻を記載したサポートチケットを送信します。
  • いいえ – ステップ 14 に進みます。

手順 14 - スペース制限を確認

ファイル・システムの inode またはスペースが不足している場合

手順 15 - Elasticsearchのバージョンエラー

Elasticsearchのバージョンでエラーが発生した場合は、
  • 対応 – 手順 16 に進みます。
  • いいえ – 手順 21 に進みます。

手順 16 - Composer 設定の確認

コンポーザーの構成は正しいですか?

手順 17 – 長時間実行されているプロセスの確認

長時間実行されているプロセスですか?
  • 対応 – プロセスの強制終了:

    1. 実行:ps aufx
    2. PID を見つけます。
    3. 終了:kill -9 <PID>
  • いいえ – 手順 18 に進みます。

手順 18 - ポストフックの失敗を確認する

フック後のエラー/ハング?
  • はい – データベース:空き ​ ディスク領域 ​、破損、不完全/破損したテーブル。
  • いいえ – 手順 19 に進みます。

手順 19 - サードパーティの拡張機能でデプロイメントがブロックされているかどうかを確認する

サードパーティの拡張機能を使用している場合は、

手順 20 – 処理に時間のかかるクエリの確認

長時間実行されているクエリは?

​ 低速のクエリログと MySQL show processlist を確認してください ​

手順 21 - Elasticsearchのバージョンのダウングレード

Elasticsearchのバージョンをダウングレードしますか?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f