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

Last update: Wed Nov 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
ビルド
デプロイ

作成対象：

開発者

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

影響を受ける製品とバージョン

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

問題

再現手順 :

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

期待される結果 :

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

実際の結果 :

構築フェーズが失敗し、デプロイメントプロセス全体が停止します。
デプロイメントエラーログで、エラーメッセージが「"プロジェクトの構築エラー：ビルドフックがステータスコード 1 で失敗しました」で終わります。ビルドを中止しました".

原因：

環境の構築が失敗する理由は複数あります。通常、デプロイメントログには長いエラーメッセージが表示され、最初の部分が理由についてより具体的で、結論は 「プロジェクトの構築エラー：ビルドフックがステータスコード 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 アーキテクチャのステージング/実稼動で対処する必要はありません。

ECE ツールが正しく設定されていることを確認します。

ビルドフックが magento.app.yaml ファイルで正しく定義されていることを確認します。 Adobe Commerce 2.2.X を使用している場合、ビルドフックは次のように定義する必要があります。

code language-yaml

code language-yaml
`# We run build hooks before your application has been packaged. build: \| php ./vendor/bin/ece-tools build # We run deploy hook after your application has been deployed and started. deploy: \| php ./vendor/bin/ece-tools deploy`

# We run build hooks before your application has been packaged.
build: |
    php ./vendor/bin/ece-tools build
# We run deploy hook after your application has been deployed and started.
deploy: |
    php ./vendor/bin/ece-tools deploy

ece-tools へのアップグレードの記事を参照してください。

次のコマンドを実行して、ECE-tools パッケージが composer.lock ファイルに存在することを確認します。

code language-bash
`grep '"name": "magento/ece-tools"' composer.lock`

これらを指定した場合、応答は次の例のようになります。 bash "name": "magento/ece-tools", "version": "2002.0.20",

ece-tools へのアップグレードの記事を参照してください。

パッチが原因で問題が発生しているか。

環境が正常に構築されない原因となっている適用されたパッチがある場合は、デプロイログに次のような内容が表示されます。

%patch_name%.composer.patch
[2019-02-19 18:12:59] CRITICAL:
....
[2019-02-19 18:12:59] CRITICAL: Command git apply --check --reverse /app/m2-hotfixes/%patch_name%.composer.patch returned code 1
...
W:
W: Command git apply --check --reverse /app/m2-hotfixes/%patch_name%.composer.patch returned code 1
W:
W:
W: build
...
E: Error building project: The build hook failed with status code 1. Aborted build.

これらのエラーメッセージは、適用しようとしているパッチが別のAdobe Commerce バージョン用に作成されたか、カスタマイズまたは以前に適用されたパッチと競合していることを意味します。競合を解決するか、Adobe Commerce サポートにお問い合わせください。

拡張機能が問題の原因ですか？

カスタム拡張機能のために環境を正常にビルドできない場合は、デプロイメントログにカスタムモジュール名と、このモジュールが原因で発生する特定の競合が表示されます。競合を解決するか、拡張機能の開発者にソリューションを問い合わせてください。

変更が適用されていることを確認します

変更をコミットし、プッシュします。これにより、デプロイメントが自動的にトリガーされます。

recommendation-more-help

8bd06ef0-b3d5-4137-b74e-d7b00485808a