「プロジェクトの構築エラー：ビルドフックがステータスコード 1 で失敗しました」でデプロイメントが失敗します

最終更新日： 2025年6月18日

この記事では、デプロイメントプロセスのビルド段階が失敗するクラウドインフラストラクチャ上のAdobe Commerceの問題の原因と解決策について説明し、エラーメッセージは次のように要約されます。エラー構築プロジェクト：ビルドフックがステータスコード 1 で失敗しました。

説明

環境

クラウドインフラストラクチャー上のAdobe Commerce、すべてのバージョン

問題/症状

  • ビルド段階でデプロイメントが失敗します。
  • エラーログが次で終了する：プロジェクトの構築エラー：ビルドフックがステータスコード 1 で失敗しました。 ビルドを中止しました.
  • デプロイメントは、手動で、または結合、プッシュまたは同期によってトリガーされます。

再現手順：

手動で、または環境の結合、プッシュまたはトリガーを実行して、デプロイメントを同期します。

期待される結果：

デプロイメントが正常に完了しました。

実際の結果：

  1. 構築フェーズが失敗し、デプロイメントプロセス全体が停止します。
  2. デプロイメントエラーログに、次のエラーメッセージが表示されます。プロジェクトの構築エラー：ビルドフックがステータスコード 1 で失敗しました。 ビルドを中止しました.

原因

エラーは一般的なエラーメッセージです。 実際の原因は、ログの前半に示されています。 一般的な原因は次のとおりです。

  • 使用可能な記憶域がありません
  • ECE ツールの設定が正しくありません
  • 適用しようとしているパッチは、お使いのAdobe Commerceのバージョンと互換性がないか、適用されている他のパッチまたはカスタマイズと競合しています。
  • カスタムモジュールコードの問題により、が正常にビルドされません。

解決策

  • 十分なストレージがあることを確認します。 使用可能な領域の確認方法について詳しくは、CLI を使用してクラウド環境のディスク領域を確認するを参照してください。 ログディレクトリのクリーニングやディスク容量の増加を検討できます。
  • ECE ツールが正しく設定されていることを確認します。
  • 問題の原因がパッチであるかどうかを確認します。 競合を解決するか、Adobe Commerce サポートにお問い合わせください。 詳しくは、以下を参照してください。
  • 問題の原因がカスタム拡張機能であるかどうかを確認します。 競合を解決するか、拡張機能の開発者にソリューションを問い合わせてください。

以下の段落で、詳しい説明を紹介します。

ログをクリーンアップしたり、領域を増やしたりします

クリーンアップの対象となるディレクトリ：

  • var/log
  • var/report
  • var/debug/
  • var

Adobe Commerce on cloud infrastructure スタータープランアーキテクチャを使用している場合にディスク容量を増やす方法について詳しくは、Integration environment on cloud のディスク容量の増加を参照してください。 同じ手順を使用して、クラウドインフラストラクチャー上のAdobe Commerce Pro プランアーキテクチャの統合環境の容量を増やすことができます。 プロ実稼働/ステージングの場合は、Adobe Commerce サポートにチケットを提出し、ディスク容量の増加をリクエストする必要があります。 しかし、それはプラットフォームによって監視されます。 ただし、通常は、Adobe Commerceがこれらのパラメーターをモニタリングし、アラートを送信したり、契約に従ってアクションを実行したりするので、Pro アーキテクチャのステージング/実稼動で対処する必要はありません。