Adobe Commerce導入のトラブルシューティング
Adobe Commerceでのスタックしたデプロイメントと失敗したデプロイメントは、デプロイメントのトラブルシューティング ツールを使用して解決できます。 各質問をクリックすると、トラブルシューティングの各ステップの回答が表示されます。
説明 description
環境
クラウドインフラストラクチャー上のAdobe Commerce
問題/症状
- 環境でのデプロイメントの停止または失敗
- 他の環境で進行中のアクティビティが原因でデプロイメントがブロックされる
- ノードへの SSH アクセスの問題
- サービスが実行されていない(Elasticsearch、cron、Composer 関連など)
- ディスク領域または inode の制限が不十分です
- 403/Elasticsearch version/config エラー
- リモートクラスターのアップロード失敗または再展開エラー
- 長時間実行されているプロセス、フック後のエラー、サードパーティ拡張機能の競合
- 低速のクエリとデータベース側の問題(MySQL)
- Composer 設定の問題またはパッチ制約
解決策 resolution
手順 1 - サービスが実行中であることを確認
デプロイメントの停止 – クラウドインフラストラクチャサービス上で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 を使用して次のコマンドを実行します(複数のプロジェクトに追加されている場合)。
| code language-none |
|---|
|
既存のデプロイメントアクティビティに関する情報を見つけるには(詳しくは Cloud UI で「ログが出荷された」エラーの場合のデプロイメントログの確認 を参照)、このコマンドを実行して、そのアクティビティの実行ログを取得できます。
| code language-none |
|---|
|
- 対応 – 他の環境がデプロイメントをブロックする場合のトラブルシューティング。 手順 3 に進みます。
- いいえ – 現在の環境のトラブルシューティングを行います。 手順 3 に進みます。
手順 3 – すべてのノードで SSH を確認する
- 対応 – 手順 4 に進みます。
- いいえ – サポートチケットを送信 。
手順 4 – 実行中のすべてのサービスの確認
- 対応 – ステップ 5 に進みます。
- いいえ – サポートチケットを送信 。
手順 5 - ビットバケットの実行状態の確認
- 対応 – status.bitbucket.com を確認します。
- いいえ – ビルドとデプロイ ログでデプロイメントログエラーを確認します。 手順 6 に進みます。
手順 6 - エラーコードを確認
- 対応 – ステップ 7 に進みます。
- いいえ – ステップ 8 に進みます。
手順 7 - 403 Forbidden エラー
- 対応 – 手順 16 に進みます。
- いいえ – ステップ 9 に進みます。
手順 8 – 実行中の cron ジョブの確認
| code language-none |
|---|
|
-
対応 – cron ジョブの強制終了とロック解除:
code language-none php vendor/bin/ece-tools cron:killphp vendor/bin/ece-tools cron:unlock -
いいえ – 手順 17 に進みます。
手順 9 - リモートクラスターにデプロイ可能なアプリケーションのエラー
- 対応 – 手順 10 に進みます。
- いいえ – 手順 11 に進みます。
手順 10 – 十分なストレージの確認
-
対応 – 手順 11 に進みます。
-
いいえ – レビュー ディスク容量の管理 。
手順 11 - ディスク容量の確認
-
対応 –
- 統合/スターター環境の場合:
.magento.app.yamlでディスク値を増やし、再デプロイします。 それでもうまくいかない場合は、 サポートチケットを送信 してください。 または、大きなログファイルを削除します。
code language-none ls -la var/log- ステージング環境/実稼動環境の場合: サポートチケットを送信 して、ストレージを追加します。
- 統合/スターター環境の場合:
-
いいえ – 手順 12 に進みます。
手順 12 – 環境の再デプロイメントに失敗しましたエラー
- 対応 – 手順 13 に進みます。
- いいえ – 手順 8 に進みます。
手順 13 - Elasticsearchのアップグレードに失敗したかどうかを確認する
- 対応 – Elasticsearchでアップグレード手順に失敗しました。 Elasticsearch ソフトウェア互換性 を参照してください。 それでもElasticsearchのアップグレードが機能しない場合は、 サポートチケットを送信 してください。 注意: クラウドインフラストラクチャー上のAdobe Commerceでは、インフラストラクチャチームに 48 営業時間通知しなければ、サービスアップグレードを実稼動環境にプッシュすることはできません。 実稼動環境のダウンタイムを最小限に抑え、目的の期間内に設定を更新できるインフラストラクチャサポートエンジニアを確保する必要があるので、これが必要になります。 そのため、変更を実稼動環境で行う必要がある 48 時間前に、必要なサービスアップグレードの詳細とアップグレードプロセスを開始する時刻を記載したサポートチケットを送信します。
- いいえ – ステップ 14 に進みます。
手順 14 - スペース制限を確認
- 対応 – ディスク容量の管理 を参照してください。
- いいえ – ステップ 15 に進みます。
手順 15 - Elasticsearchのバージョンエラー
- 対応 – 手順 16 に進みます。
- いいえ – 手順 21 に進みます。
手順 16 - Composer 設定の確認
- 対応 – 手順 10 に進みます。
- いいえ – Composer トラブルシューティング Web ページ を確認してください。
手順 17 – 長時間実行されているプロセスの確認
-
対応 – プロセスの強制終了:
- 実行:
ps aufx - PID を見つけます。
- 終了:
kill -9 <PID>
- 実行:
-
いいえ – 手順 18 に進みます。
手順 18 - ポストフックの失敗を確認する
- はい – データベース:空き ディスク領域 、破損、不完全/破損したテーブル。
- いいえ – 手順 19 に進みます。
手順 19 - サードパーティの拡張機能でデプロイメントがブロックされているかどうかを確認する
- はい – サードパーティの拡張機能を無効にする を試して、特にエラーに拡張機能名がある場合は再デプロイします。
- いいえ – 手順 20 に進みます。
手順 20 – 処理に時間のかかるクエリの確認
低速のクエリログと MySQL show processlist を確認してください 。
- 対応 – 長時間実行中のクエリを強制終了します。 MySQL Kill を確認します。
- いいえ – サポートチケットを送信 。
手順 21 - Elasticsearchのバージョンのダウングレード
- 対応 – 設定では実行できません。 サポートチケットを送信 。
- いいえ – サポートチケットを送信 。