Adobe Commerceのデプロイメントのトラブルシューティング

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

説明 description

環境

Adobe Commerce on cloud infrastructure

問題/症状

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

解決策 resolution

手順1 - サービスが実行されていることを確認する

Adobe Commerce on cloud infrastructure serviceは有効ですか?

デプロイメントの停止 – 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 --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>]
  • YES – 他の環境ブロックのデプロイメントのトラブルシューティング。 手順3に進みます。
  • NO – 現在の環境のトラブルシューティングを行います。 手順3に進みます。

手順3 – すべてのノードでSSHを検証する

すべてのノードにSSHが成功したか?

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

すべてのサービスを実行していますか?

手順5 - Bitbucketの実行を確認する

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 - スペース制限の確認

ノードまたはスペースが不足しているファイルシステム

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

Elasticsearchのバージョンに関するエラー
  • はい – ステップ 16に進みます。
  • いいえ – ステップ 21に進みます。

手順16 - コンポーザー設定の確認

コンポーザー設定が正しいですか?

手順17 – 長時間実行中のプロセスを確認する

プロセスが長い場合:

統合/開発環境のデプロイメントログの末尾にClosing services app, mysql, redis, opensearch, rabbitmq, and router.のような行が表示される場合

長時間実行中のプロセスを確認し、必要に応じて終了します。

求めるべきプロセスの例

code language-none
/usr/bin/php8.2 /app/bin/magento queue:consumers:start <consumer name>/usr/bin/php8.2 /app/bin/magento cron:run

実行中のそのようなプロセスをすべて停止してから、デプロイメントを再実行します。

  • はい(長時間実行中のプロセスがある) – プロセスを強制終了:

    1. 実行:ps aufx
    2. PIDの検索
    3. 終了:kill -9 <PID>
  • いいえ – ステップ 18に進みます。

手順18 - フック後のエラーを確認する

ポストフックの失敗/ハング?
  • はい – データベース:空きディスク領域、破損、不完全/破損したテーブルを解放します。
  • いいえ – ステップ 19に進みます。

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

サードパーティの拡張機能を使用していますか?
  • はい – ​ サードパーティの拡張機能を無効にして、特にエラーに拡張機能の名前がある場合は、再展開してみてください。
  • いいえ – ステップ 20に進みます。

手順20 – 遅いクエリを確認する

クエリを長時間実行していますか?

​ クエリログが遅く、MySQLがプロセスリストを表示しているかどうかを確認します

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

Elasticsearch版をダウンロードしますか?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f