Adobe Commerce Patching Automationのトラブルシューティング ガイド

パッチ操作にPatching Automationを使用する場合、エラーメッセージや問題が発生し、パッチの適用やリバージョンが正常に行われなくなる可能性があります。 このガイドでは、最も一般的な問題の解決策を提供します。

クイックトラブルシューティング手順

パッチ操作が失敗した場合

パッチ操作期間

ほとんどの環境では、次のタイムラインでパッチ操作の期間を説明しますが、環境のサイズと複雑さによっては時間がかかる場合があります。

進行中のパッチをキャンセル

一般的な成功メッセージ

一般的なエラーメッセージと解決策

環境準備エラー

「前回のデプロイメントは成功しませんでした。 パッチを適用または元に戻す前に、環境が安定していることを確認してください。」

発生時： パッチ固有の検証の前に、予備チェックの開始時

原因： ターゲット環境の最新のデプロイメントが正常に完了しませんでした

解決策： パッチ操作を再試行する前に、ターゲット環境を再デプロイし、デプロイメントが正常に完了したことを確認します（Cloud Consoleのデプロイメントログを確認します）。

パッチアプリケーションエラー

「コードベースまたはパッチファイルでこれらの問題がPatching Automationによって検出されたため、パッチを適用できません」

それが発生した場合：​事前確認中

原因： パッチが現在のコードベースと競合しているか、パッチ自体に問題があります

解決策：

「Patching Automationを通じて適用されなかったパッチを元に戻そうとしています。 パッチは手動で適用された可能性があります。」

それが発生した場合：​復元操作中

原因： Patching Automationを通じて適用されなかったパッチを元に戻そうとしています

解決策：​最初にパッチを適用するために使用したのと同じ方法を使用するか、サポートに連絡して手動サポートを受けてください

環境エラーと検証エラー

「環境が親と同期していません」

それが発生した場合：​検証中、統合環境がターゲット環境に結合される前に、結合前の同期チェックで

原因：​統合環境が親環境と異なるのは、通常、パッチのテスト中にターゲット環境が変更されたためです

解決策：

「結合後の検証に失敗しました：結合後に環境が同期していません。」

統合環境がターゲット環境に既に結合された後、検証中に​が発生する

原因： 2つの環境のコードがマージ後に一致しません。通常は、実際の競合ではなく、一時的なPlatform.sh API伝播遅延が発生します

解決策：

「cronが有効でメンテナンスモードが無効になっている場合、実稼動環境でパッチジョブを作成できません。 パッチを適用する前に、メンテナンスモードを有効にし、cron ジョブを無効にしてください。」

実行時：​実稼動環境の事前チェック中

原因：​実稼動環境が必要な安全性条件を満たしていません

解決策：

「パッチ操作は完了しましたが、環境のヘルスチェックに失敗しました。 これは、デプロイメントの潜在的な問題を示します。 環境ステータスを確認し、変更を元に戻すことを検討してください。」

発生時： パッチ適用または復帰後、検証中

原因： パッチは正常に適用または元に戻されましたが、後続のヘルスチェックに失敗しました

解決策：

認証エラーとアクセスエラー

「アクセス拒否」

それが発生した場合：​環境の作成またはアクセス中にアカウントに必要な権限がない場合

原因： ユーザーアカウントに必要な権限がありません

解決策：

GitHub統合エラー

「プロバイダー「github」で使用できるGit資格情報はありません。 このリポジトリ用のパッチ自動処理GitHub アプリのインストール"

発生時： GitHubに接続されたプロジェクトのパッチ運用中

原因： Patching Automation GitHub アプリがリポジトリにインストールされていません

解決策： GitHub統合の設定 Patching Automationの手順に従います

“GitHub API リクエストに失敗しました”

発生時： GitHub接続プロジェクトのパッチ操作中

原因：​一時的な問題により、サービスはGitHubに接続できませんでした

解決策：​数分待って、操作をやり直してください。 エラーが解決しない場合は、Adobe Commerce Cloud サポート ​にお問い合わせください

「タイムアウト内に環境が作成されない」（GitHub接続プロジェクト）

それが発生した場合：​統合環境の作成中

原因： プロジェクトのGitHub統合で、fetch-branches オプションが無効になっています。 その結果、サービスによってプッシュされた一時的なブランチは同期されず、統合環境は作成されません。

解決策：​統合のfetch-branches オプション ​を有効にしてから、操作を再試行してください。 「GitHub統合を Patching Automationに設定する」を参照してください。

環境アクティベーションエラー

「統合環境をアクティブ化できません。」

発生時： Patching Automationがパッチを安全にテストするために必要な一時統合環境をアクティブ化できない場合。

原因： エラーと共に表示される追加の詳細によって異なります：

詳細にComposerまたはAdobe Commerce パッケージが記載されている場合：

詳細に環境スロットまたはリソースが記載されている場合：

その他の原因：​については、パッチ適用の自動化UIで詳細なエラーログを確認するか、正確なエラーテキストをサポートにお問い合わせください。

ヘルプの取得

サポートへの問い合わせタイミング：

次の場合は、Adobe Commerce Cloud サポートにお問い合わせください。

提供する情報：

サポートに連絡する際は、以下を提供してください。

関連資料

詳細な技術情報については、以下を参照してください。

関連トピック