[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

Cloud Automation Patching Service (CAPS)のトラブルシューティング ガイド

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

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

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

パッチ操作期間

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

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

一般的な成功メッセージ

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

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

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

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

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

解決策：

「このパッチはCAPSによって管理されませんでした。 元に戻すことができません」

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

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

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

環境エラーと検証エラー

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

それが発生した場合：​検証中

原因：​統合環境が親環境と異なります

解決策：

「実稼動環境の保護対策が満たされていない」

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

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

解決策：

「パッチが適用されましたが、ヘルスチェックに失敗しました。 元に戻すことを検討してください」

発生時：​検証中のパッチ適用後

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

解決策：

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

「Adobe Commerce リポジトリの認証に失敗しました」

それが発生したとき：​任意のステージ中

原因：​無効または期限切れのAdobe Commerce リポジトリ資格情報

解決策：

この問題を解決するために推奨されるオプションは2つあります。

オプション 1: env:COMPOSER_AUTH環境レベルの変数を修正（推奨）

オプション 1で問題が解決しない場合は、オプション 2に進みます。

オプション 2: auth.json ファイルを手動で作成してデプロイする

「環境アクセスに対する権限が不十分です」

実行時：​環境の作成中またはアクセス中

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

解決策：

リソースおよびクォータのエラー

「環境クォータを超えました」

実行時：​環境作成中

原因：​環境の制限に達しました

解決策：

「運用に必要なリソースが不足しています」

それが発生したとき：​任意のステージ中

原因：​環境に十分なCPU、メモリ、またはストレージがありません

解決策：

ヘルプの取得

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

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

提供する情報：

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

関連資料

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

関連トピック