Azure Spring Apps における一般的なビルドの問題のトラブルシューティング
Note
Basic、Standard、Enterprise プランは、2025 年 3 月中旬以降非推奨になり、廃止期間は 3 年間です。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の廃止のお知らせ」を参照してください。
Standard 従量課金と専用プランは、2024 年 9 月 30 日以降に非推奨になり、6 か月後に完全にシャットダウンされます。 Azure Container Apps に移行することをお勧めします。 詳細については、「Azure Spring Apps の Standard 従量課金および専用プランを Azure Container Apps に移行する」を参照してください。
この記事の適用対象: ❎ Basic/Stanadard ✅ Enterprise
この記事では、Azure Spring Apps のデプロイのビルドの問題をトラブルシューティングする方法について説明します。
ビルド終了コード
Azure Spring Apps Enterprise プランでは、Tanzu Buildpacks を使用して、アプリケーションのソース コードをイメージに変換します。 詳細については、「Tanzu Buildpacks」を参照してください。
Azure CLI を使用して Azure Spring Apps にアプリをデプロイすると、Azure CLI コンソールにビルド ログが表示されます。 ビルドが失敗した場合、Azure Spring Apps では CLI コンソールに終了コードとエラー メッセージを表示し、ビルドパックのライフサイクルのさまざまなフェーズでビルドパックの実行が失敗した理由を示します。
以下に示したのは、一般的な終了コードとその説明です。
20 - すべてのビルドパック グループの検出に失敗しました。
20 の終了コードについて考えられる原因を次に示します。
使用しているビルダーでは、プロジェクトで使用した言語をサポートしていません。
既定のビルダーを使用している場合は、既定のビルダーでサポートされている言語を確認します。 詳細については、「APM 統合と CA 証明書を構成する方法」の「サポートされている APM の種類」セクションを参照してください。
カスタム ビルダーを使用している場合は、カスタム ビルダーのビルドパックでプロジェクトでの使用言語がサポートされているかどうかを確認します。
間違ったパスに対してを実行しています。たとえば、Maven プロジェクトの pom.xml ファイルがルート パスにありません。
プロジェクトの pom.xml ファイルの場所を指定するように
BP_MAVEN_POM_FILEを設定します。アプリケーションに問題があります。たとえば、.jar ファイルに
Main-Classエントリを含む /META-INF/MANIFEST.MF ファイルがありません。
51 - ビルドパックのビルド エラー。
51 の終了コードについて考えられる原因を次に示します。
Azure Spring Apps によって Azure CLI コンソールにエラー メッセージ
Build failed in stage build with reason OOMKilledが表示された場合、メモリ不足のためビルドに失敗しました。build-memory環境変数を使用してメモリを増やすには、次のコマンドを使用します。az spring app deploy \ --resource-group <your-resource-group-name> \ --service <your-Azure-Spring-Apps-name> \ --name <your-app-name> \ --build-memory 3Giアプリケーションのソース コード エラーが原因でビルドに失敗しました。たとえば、ソース コードにコンパイル エラーがあります。
ビルド ログを確認して、根本原因を見つけます。
ダウンロード依存関係エラーが原因でビルドに失敗しました。たとえば、ネットワークの問題により、Maven 依存関係のダウンロードが失敗しました。
JDK バージョンがサポートされていないため、ビルドに失敗しました。 たとえば、JAR ファイルは、ビルドパックでサポートされていない、Java LTS 以外のバージョンを使用してコンパイルされています。 サポートされているバージョンについては、「Azure Spring Apps Enterprise プランで多言語アプリをデプロイする方法」の「Java アプリケーションをデプロイする」セクションを参照してください。
62 - Azure Container Registry へのイメージ書き込みに失敗しました。
62 の終了コードについて考えられる原因を次に示します。
Azure Spring Apps でビルド ログにエラー メッセージ
Failed to write image to the following tagsが表示される場合、ネットワークの問題が原因でビルドが失敗しました。再試行して問題を修正します。
アプリケーションが、Web サーバーによって提供される静的ファイルまたは動的フロントエンド アプリケーションの場合、「Web 静的ファイルをデプロイする」の「ビルドとデプロイに関する一般的なエラー」セクションを参照してください。