Memecahkan masalah build umum di Azure Spring Apps

Catatan

Azure Spring Apps adalah nama baru untuk layanan Azure Spring Cloud. Meskipun layanan memiliki nama baru, Anda akan melihat nama lama di beberapa tempat untuk sementara saat kami berupaya memperbarui aset seperti cuplikan layar, video, dan diagram.

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