Mulai cepat: Meluncurkan aplikasi Java pertama Anda di Azure Container Apps menggunakan file WAR atau JAR

Artikel ini menunjukkan kepada Anda cara menyebarkan aplikasi sampel Spring PetClinic ke Azure Container Apps menggunakan file arsip aplikasi web (WAR) atau file Arsip Java (JAR).

Ada beberapa opsi yang tersedia untuk menyebarkan aplikasi Java, termasuk opsi berikut:

• Penyebaran dari sistem file lokal atau dari repositori kode.
• Penyebaran menggunakan Maven atau IDE.
• Penyebaran menggunakan file WAR, file JAR, atau langsung dari kode sumber.

Pada akhir tutorial ini, Anda menyebarkan aplikasi web yang dapat Anda kelola melalui portal Microsoft Azure. Cuplikan layar berikut menunjukkan beranda aplikasi PetClinic yang disebarkan ke Azure Container Apps:

Prasyarat

• Langganan Azure. Buat akun gratis.
• Izin Contributor atau Owner pada langganan Azure. Untuk informasi selengkapnya, lihat Menetapkan peran Azure menggunakan portal Azure.
• Akun GitHub.
• Git
• Azure CLI
• Ekstensi CLI Azure Container Apps, versi 0.3.47 atau yang lebih tinggi. Gunakan perintah berikut untuk menginstal versi terbaru: az extension add --name containerapp --upgrade --allow-preview
• Java Development Kit, versi 17 atau yang lebih baru.
• Apache Maven

Membangun proyek

Bangun proyek dengan menggunakan langkah-langkah berikut:

1. Kloning repositori Sampel Java Azure Container Apps dengan menggunakan perintah berikut:

   git clone https://github.com/Azure-Samples/azure-container-apps-java-samples.git
   

1. Kloning repositori Aplikasi Sampel Spring PetClinic dengan menggunakan perintah berikut:

   git clone https://github.com/spring-petclinic/spring-framework-petclinic.git
   

2. Navigasikan ke folder spring-petclinic dengan menggunakan perintah berikut:

   cd azure-container-apps-java-samples/spring-petclinic/spring-petclinic/
   

3. Inisialisasi dan perbarui repositori Aplikasi Sampel Spring PetClinic ke versi terbaru dengan menggunakan perintah berikut:

   git submodule update --init --recursive
   

4. Gunakan perintah berikut untuk membersihkan area build Maven, mengkompilasi kode proyek, dan membuat file JAR, melewati semua pengujian selama proses ini:

   mvn clean verify
   

Anda sekarang memiliki file /target/petclinic.jar .

2. Navigasikan ke folder spring-framework-petclinic dengan menggunakan perintah berikut:

   cd spring-framework-petclinic
   

3. Gunakan perintah berikut untuk membersihkan area build Maven, mengkompilasi kode proyek, dan membuat file JAR, melewati semua pengujian selama proses ini:

   mvn clean verify
   

Anda sekarang memiliki file /target/petclinic.war .

Menyebarkan proyek

Sebarkan paket JAR ke Azure Container Apps dengan menggunakan perintah berikut:

Catatan

Versi JDK default adalah 17. Anda memiliki opsi untuk menentukan versi dengan menggunakan variabel lingkungan. Untuk mengubah versi JDK agar kompatibilitas dengan aplikasi Anda, gunakan --build-env-vars BP_JVM_VERSION=<your-JDK-version> argumen . Untuk informasi selengkapnya, lihat Membangun variabel lingkungan untuk Java di Azure Container Apps (pratinjau).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription-ID>\
    --location <location> \
    --environment <environment-name> \
    --artifact <JAR-file-path-and-name> \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Sebarkan file WAR ke Azure Container Apps dengan menggunakan perintah berikut:

Catatan

Versi Tomcat default adalah 9. Untuk mengubah versi agar kompatibel dengan aplikasi Anda, gunakan argumen --build-env-vars BP_TOMCAT_VERSION=<your-Tomcat-version>. Dalam contoh ini, versi Tomcat diatur ke 10 - termasuk versi minor apa pun - dengan menetapkan parameter BP_TOMCAT_VERSION=10.*. Untuk informasi selengkapnya, lihat Membangun variabel lingkungan untuk Java di Azure Container Apps (pratinjau).

az containerapp up \
    --resource-group <resource-group> \
    --name <container-app-name> \
    --subscription <subscription>\
    --location <location> \
    --environment <environment-name> \
    --artifact <WAR-file-path-and-name> \
    --build-env-vars BP_TOMCAT_VERSION=10.* \
    --ingress external \
    --target-port 8080 \
    --query properties.configuration.ingress.fqdn

Memverifikasi status aplikasi

Dalam contoh ini, containerapp up perintah menyertakan --query properties.configuration.ingress.fqdn argumen, yang mengembalikan nama domain yang sepenuhnya memenuhi syarat (FQDN), juga dikenal sebagai URL aplikasi.

Lihat aplikasi dengan menempelkan URL ini ke browser.

Membersihkan sumber daya

Jika Anda berencana untuk terus bekerja dengan lebih banyak quickstart dan tutorial, Anda mungkin ingin membiarkan sumber daya ini tetap ada. Saat Anda tidak lagi memerlukan sumber daya, Anda dapat menghapusnya untuk menghindari biaya Azure, dengan menggunakan perintah berikut:

az group delete --name <resource-group>

Konten terkait

• Panduan Cepat: Luncurkan aplikasi layanan mikro Java pertama Anda dengan komponen Java terkelola dalam Azure Container Apps
• Sampel Java PetClinic AI pada Gambaran Umum Aplikasi Kontainer
• Membangun variabel lingkungan untuk Java di Azure Container Apps (pratinjau)