Bagikan melalui

Memecahkan masalah build umum di Azure Spring Apps

  • Artikel

Catatan

Paket Basic, Standard, dan Enterprise tidak digunakan lagi mulai pertengahan Maret 2025, dengan periode penghentian 3 tahun. Sebaiknya transisi ke Azure Container Apps. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Konsumsi Standar dan paket khusus akan ditolak mulai 30 September 2024, dengan pematian lengkap setelah enam bulan. Sebaiknya transisi ke Azure Container Apps. Untuk informasi selengkapnya, lihat Memigrasikan konsumsi Azure Spring Apps Standard dan paket khusus ke Azure Container Apps.

Artikel ini berlaku untuk:❌ Basic/Standard ✔️ Enterprise

Artikel ini menjelaskan cara memecahkan masalah build dengan penyebaran Azure Spring Apps Anda.

Membangun kode keluar

Paket Azure Spring Apps Enterprise menggunakan Tanzu Buildpacks untuk mengubah kode sumber aplikasi Anda menjadi gambar. Untuk informasi selengkapnya, lihat Tanzu Buildpacks.

Saat Anda menyebarkan aplikasi di Azure Spring Apps menggunakan Azure CLI, Anda akan melihat log build di konsol Azure CLI. Jika build gagal, Azure Spring Apps menampilkan kode keluar dan pesan kesalahan di konsol CLI yang menunjukkan mengapa eksekusi buildpack gagal selama fase siklus hidup buildpack yang berbeda.

Daftar berikut ini menjelaskan beberapa kode keluar umum:

  • 20 - Semua grup buildpack gagal dideteksi.

    Pertimbangkan kemungkinan penyebab kode keluar 20 berikut:

    • Penyusun yang Anda gunakan tidak mendukung bahasa yang digunakan proyek Anda.

      Jika Anda menggunakan penyusun default, periksa bahasa yang didukung penyusun default. Untuk informasi selengkapnya, lihat bagian Jenis APM yang didukung dari Cara mengonfigurasi integrasi APM dan sertifikat CA.

      Jika Anda menggunakan penyusun kustom, periksa apakah buildpack penyusun kustom Anda mendukung bahasa yang digunakan proyek Anda.

    • Anda berjalan melawan jalur yang salah; misalnya, file pom.xml proyek Maven Anda tidak berada di jalur akar.

      Atur BP_MAVEN_POM_FILE untuk menentukan lokasi file pom.xml proyek.

    • Ada yang salah dengan aplikasi Anda; misalnya, file .jar Anda tidak memiliki /META-INF/MANIFEST. File MF yang berisi Main-Class entri.

  • 51 - Kesalahan build buildpack.

    Pertimbangkan kemungkinan penyebab kode keluar 51 berikut:

    • Jika Azure Spring Apps menampilkan pesan Build failed in stage build with reason OOMKilled kesalahan di konsol Azure CLI, build gagal karena memori yang tidak mencukup.

      Gunakan perintah berikut untuk meningkatkan memori menggunakan build-memory variabel lingkungan:

      az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-app-name> \
    --build-memory 3Gi

    • Build gagal karena kesalahan kode sumber aplikasi; misalnya, ada kesalahan kompilasi dalam kode sumber Anda.

      Periksa log build untuk menemukan akar penyebabnya.

    • Build gagal karena kesalahan dependensi unduhan; misalnya, masalah jaringan menyebabkan pengunduhan dependensi Maven gagal.

    • Build gagal karena versi JDK yang tidak didukung. Misalnya, file JAR telah dikompilasi menggunakan versi LTS non-Java, yang tidak didukung oleh buildpack. Untuk versi yang didukung, lihat bagian Menyebarkan aplikasi Java dari Cara menyebarkan aplikasi poliglot dalam paket Azure Spring Apps Enterprise.

  • 62 - Gagal menulis gambar ke Azure Container Registry.

    Pertimbangkan kemungkinan penyebab kode keluar 62 berikut:

    • Jika Azure Spring Apps menampilkan pesan Failed to write image to the following tags kesalahan di log build, build gagal karena masalah jaringan.

      Coba lagi untuk memperbaiki masalah.

Jika aplikasi Anda adalah file statis atau aplikasi front-end dinamis yang dilayani oleh server web, lihat bagian Kesalahan build dan penyebaran umum dari Menyebarkan file statis web.

Langkah berikutnya