Adobe Commerceのデプロイメントのトラブルシューティング
Adobe Commerceでのデプロイメントの停止と失敗は、デプロイメントトラブルシューティングツールを使用して解決できます。 各質問をクリックすると、トラブルシューティングの各ステップの回答が表示されます。
説明 description
環境
Adobe Commerce on cloud infrastructure
問題/症状
- 環境でデプロイメントが停止または失敗する
- 他の環境で進行中のアクティビティが原因でデプロイメントをブロックしました
- ノードへのSSH アクセスの問題
- サービスが実行されていない(例:Elasticsearch、cron、Composer関連)
- 不十分なディスク容量またはinode制限
- 403/Elasticsearch バージョン/config エラー
- リモートクラスターアップロードの失敗または再展開エラー
- 長時間実行されるプロセス、フック後の失敗、サードパーティ拡張機能の競合
- 低速クエリとデータベース側の問題(MySQL)
- コンポーザー設定の問題またはパッチの制約
解決策 resolution
手順1 - サービスが実行されていることを確認する
デプロイメントの停止 – Adobe Commerce オンクラウドインフラストラクチャサービスは有効ですか? Adobe Commerce Cloud (Experience Cloud ページのAdobe Status以下)を確認してください。
- はい – ステップ 2に進みます。
- NO - メンテナンスまたはグローバルな停止。 推定期間と更新を確認します。
手順2 – 他の環境でのデプロイメントの確認
実行中のアクティビティのリストを取得するには、magento-cloud CLIを使用して次のコマンドを実行します(1つのクラウドプロジェクトにのみ追加されている場合)。 メモ: magento-cloud CLIの最新バージョンを使用していることを確認してください。 手順については、Commerce on Cloud ガイドのCLIの更新を参照してください。
| code language-none |
|---|
|
進行中のアクティビティのリストを取得するには、magento-cloudを使用して次のコマンドを実行します(複数のプロジェクトに追加されている場合)。
| code language-none |
|---|
|
既存のデプロイメントアクティビティに関する情報を検索するには(詳細については、「Cloud UIに「出荷されたログ」エラーがある場合のデプロイメントログの確認」を参照)、このコマンドを実行して、そのアクティビティの実行中のログを取得できます。
| code language-none |
|---|
|
- YES – 他の環境ブロックのデプロイメントのトラブルシューティング。 手順3に進みます。
- NO – 現在の環境のトラブルシューティングを行います。 手順3に進みます。
手順3 – すべてのノードでSSHを検証する
- はい – 手順4に進みます。
- いいえ – サポートチケットを送信。
手順4 – 実行中のすべてのサービスを確認する
- はい – ステップ 5に進みます。
- いいえ – サポートチケットを送信。
手順5 - Bitbucketの実行を確認する
- はい – status.bitbucket.comを確認してください。
- NO - ビルドおよびデプロイ ログのデプロイメント ログ エラーを確認します。 手順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- Pro ステージング/実稼動環境の場合: サポートチケット を送信してストレージを追加します。
- 統合/スターター環境の場合:
-
いいえ – ステップ 12に進みます。
手順12 – 環境の再デプロイメントに失敗したエラー
- はい – 手順13に進みます。
- いいえ – ステップ 8に進みます。
手順13 - Elasticsearchのアップグレードが失敗したかどうかを確認する
- はい – Elasticsearchのアップグレード手順に失敗しました。 Elasticsearch ソフトウェアの互換性を参照してください。 Elasticsearchのアップグレードがまだ機能しない場合は、 サポートチケットを送信してください。 注: Adobe Commerce クラウド インフラストラクチャでは、サービスのアップグレードを本番環境にプッシュする際に、48営業時間前にインフラストラクチャ チームに通知する必要があります。 本番環境へのダウンタイムを最小限に抑えながら、必要な時間枠で設定を更新できるインフラストラクチャサポートエンジニアを確保する必要があるため、これは必要です。 そのため、変更を本番環境に導入する必要がある48時間前に、必要なサービスのアップグレードの詳細と、アップグレードプロセスを開始する時間を記載したサポートチケットを送信します。
- いいえ – ステップ 14に進みます。
手順14 - スペース制限の確認
- はい – ディスク領域の管理を参照してください。
- いいえ – ステップ 15に進みます。
手順15 - Elasticsearch バージョン エラー
- はい – ステップ 16に進みます。
- いいえ – ステップ 21に進みます。
手順16 - コンポーザー設定の確認
- はい – ステップ 10に進みます。
- いいえ – Composer トラブルシューティング web ページ を確認してください。
手順17 – 長時間実行中のプロセスを確認する
統合/開発環境のデプロイメントログの末尾にClosing services app, mysql, redis, opensearch, rabbitmq, and router.のような行が表示される場合
長時間実行中のプロセスを確認し、必要に応じて終了します。
求めるべきプロセスの例
| code language-none |
|---|
|
実行中のそのようなプロセスをすべて停止してから、デプロイメントを再実行します。
-
はい(長時間実行中のプロセスがある) – プロセスを強制終了:
- 実行:
ps aufx - PIDの検索
- 終了:
kill -9 <PID>
- 実行:
-
いいえ – ステップ 18に進みます。
手順18 - フック後のエラーを確認する
- はい – データベース:空きディスク領域、破損、不完全/破損したテーブルを解放します。
- いいえ – ステップ 19に進みます。
手順19 - サードパーティの拡張機能がデプロイメントをブロックしているかどうかを確認する
- はい – サードパーティの拡張機能を無効にして、特にエラーに拡張機能の名前がある場合は、再展開してみてください。
- いいえ – ステップ 20に進みます。
手順20 – 遅いクエリを確認する
クエリログが遅く、MySQLがプロセスリストを表示しているかどうかを確認します。
- はい – 実行中のクエリをすべて強制終了します。 MySQL Killをレビューします。
- いいえ – サポートチケットを送信。
手順21 - Elasticsearch バージョンのダウングレード
- はい – 設定では実行できません。 サポートチケットを送信。
- いいえ – サポートチケットを送信。