Tutorial: Membangun aplikasi web JBoss dengan Azure App Service di Linux dan MySQL

• Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, Anda dapat membuat akun secara gratis.
• Akun GitHub. Anda juga bisa mendapatkannya secara gratis.
• Pengetahuan tentang Java dengan pengembangan JBoss.
• (Opsional) Untuk mencoba GitHub Copilot, akun GitHub Copilot. Uji coba gratis 30 hari tersedia.

• Akun Azure dengan langganan aktif. Jika Anda tidak memiliki akun Azure, Anda dapat membuat akun secara gratis.
• Azure Developer CLI terinstal. Anda dapat mengikuti langkah-langkah dengan Azure Cloud Shell karena sudah menginstal Azure Developer CLI.
• Pengetahuan tentang Java dengan pengembangan JBoss.
• (Opsional) Untuk mencoba GitHub Copilot, akun GitHub Copilot. Uji coba gratis 30 hari tersedia.

2. Buat App Service dan MySQL

Pertama, Anda membuat sumber daya Azure. Langkah-langkah yang digunakan dalam tutorial ini membuat sekumpulan sumber daya aman secara default yang menyertakan App Service dan Azure Database for MySQL. Untuk proses pembuatan, Anda menentukan:

• Nama untuk aplikasi web. Ini digunakan sebagai bagian dari nama DNS untuk aplikasi Anda dalam bentuk https://<app-name>-<hash>.<region>.azurewebsites.net.
• Wilayah tempat menjalankan aplikasi secara fisik di dunia. Ini juga digunakan sebagai bagian dari nama DNS untuk aplikasi Anda.
• Tumpukan runtime untuk aplikasi. Di sinilah Anda memilih versi Java yang akan digunakan untuk aplikasi Anda.
• Paket hosting untuk aplikasi. Ini adalah tingkat harga yang mencakup serangkaian fitur dan kapasitas penskalaan untuk aplikasi Anda.
• Resource Group untuk aplikasi. Grup sumber daya memungkinkan Anda mengelompokkan (dalam kontainer logika) semua sumber daya Azure yang diperlukan untuk aplikasi.

Masuk ke portal Microsoft Azure dan ikuti langkah-langkah ini untuk membuat sumber daya Azure App Service Anda.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

3. Buat koneksi tanpa kata sandi

Dalam langkah ini, Anda menghasilkan koneksi layanan berbasis identitas terkelola, yang nantinya dapat Anda gunakan untuk membuat sumber data di server JBoss Anda. Dengan menggunakan identitas terkelola untuk terhubung ke database MySQL, kode Anda aman dari kebocoran rahasia yang tidak disengaja.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

4. Konfirmasi sumber data JNDI

Jika Anda menambahkan pengaturan aplikasi yang berisi string koneksi JDBC yang valid untuk Oracle, SQL Server, PostgreSQL, atau MySQL, App Service menambahkan sumber data Java Naming and Directory Interface (JNDI) untuknya di server JBoss. Dalam langkah ini, Anda menggunakan koneksi SSH ke kontainer aplikasi untuk memverifikasi sumber data JNDI. Dalam prosesnya, Anda mempelajari cara mengakses shell SSH dan menjalankan JBoss CLI.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

5. Menyebarkan kode sampel

Dalam langkah ini, Anda mengonfigurasi penyebaran GitHub menggunakan GitHub Actions. Ini hanya salah satu dari banyak cara untuk menyebarkan ke App Service, tetapi juga cara yang bagus untuk memiliki integrasi berkelanjutan dalam proses penyebaran Anda. Secara default, setiap git push repositori GitHub Anda memulai tindakan build dan deploy.

Seperti konvensi JBoss, jika Anda ingin menyebarkan ke konteks akar JBoss, beri nama artefak bawaan Anda ROOT.war.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

6. Menelusuri aplikasi

Mengalami masalah? Periksa bagian Pemecahan Masalah.

7. Mengalirkan log diagnostik

Azure App Service mengambil semua output pesan ke konsol untuk membantu Anda mendiagnosis masalah dengan aplikasi Anda. Aplikasi sampel mencakup pernyataan pengelogan Log4j standar untuk menunjukkan kemampuan ini, seperti yang ditunjukkan dalam cuplikan berikut:

private static final Logger logger = Logger.getLogger(MethodHandles.lookup().lookupClass().getName());

@PersistenceContext
private EntityManager entityManager;

public List<Task> getAllTasks() {
    logger.log(Level.INFO, "Finding all tasks. ");

    return this.entityManager.createNamedQuery("findAllTasks", Task.class).getResultList();
}

Pelajari selengkapnya tentang pengelogan di aplikasi Java dalam seri di Mengaktifkan Azure Monitor OpenTelemetry untuk aplikasi .NET, Node.js, Python, dan Java.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

8. Membersihkan sumber daya

Setelah selesai, Anda dapat menghapus semua sumber daya dari langganan Azure dengan menghapus grup sumber daya.

2. Buat sumber daya Azure dan sebarkan aplikasi sampel

Dalam langkah ini, Anda membuat sumber daya Azure dan menyebarkan aplikasi sampel ke App Service di Linux. Langkah-langkah yang digunakan dalam tutorial ini membuat sekumpulan sumber daya aman secara default yang menyertakan App Service dan Azure Database for MySQL.

Kontainer pengembangan sudah memiliki Azure Developer CLI (AZD).

1. Dari akar repositori, jalankan azd init.

   azd init --template jboss-app-service-mysql-infra
   

2. Saat diminta, berikan jawaban berikut:

   Pertanyaan	Jawaban
   Lanjutkan menginisialisasi aplikasi di '<your-directory>'?	Y
   Apa yang ingin Anda lakukan dengan file-file ini?	Jaga agar file saya yang ada tidak berubah
   Masukkan nama lingkungan baru	Ketik nama unik. Templat AZD menggunakan nama ini sebagai bagian dari nama DNS aplikasi web Anda di Azure (<app-name>-<hash>.azurewebsites.net). Karakter alfanumerik dan tanda hubung diperbolehkan.

3. Masuk ke Azure dengan menjalankan azd auth login perintah dan ikuti perintah:

   azd auth login
   

4. Buat sumber daya Azure yang diperlukan dan sebarkan kode aplikasi dengan azd up perintah . Ikuti perintah untuk memilih langganan dan lokasi yang diinginkan untuk sumber daya Azure.

   azd up
   

   Perintah azd up membutuhkan waktu sekitar 15 menit untuk diselesaikan (cache Redis membutuhkan waktu paling lama). Ini juga mengkompilasi dan menyebarkan kode aplikasi Anda, tetapi Anda akan memodifikasi kode nanti untuk bekerja dengan App Service. Saat sedang berjalan, perintah menyediakan pesan tentang proses provisi dan penyebaran, termasuk tautan ke penyebaran di Azure. Setelah selesai, perintah juga menampilkan tautan ke aplikasi penyebaran.

   Templat AZD ini berisi file (azure.yaml dan direktori infra ) yang menghasilkan arsitektur aman secara default dengan sumber daya Azure berikut:

   • Grup sumber daya: Kontainer untuk semua sumber daya yang dibuat.
   • Paket App Service: Menentukan sumber daya komputasi untuk App Service. Paket Linux di tingkat B1 dibuat.
   • App Service: Mewakili aplikasi Anda dan berjalan dalam paket App Service.
   • Jaringan virtual: Terintegrasi dengan aplikasi App Service dan mengisolasi lalu lintas jaringan back-end.
   • Server Fleksibel Azure Database for MySQL: Hanya dapat diakses dari jaringan virtual. Database dibuat untuk Anda di server.
   • Azure Cache for Redis: Hanya dapat diakses dari dalam jaringan virtual.
   • Titik akhir privat: Titik akhir akses untuk brankas kunci dan cache Redis di jaringan virtual.
   • Zona DNS privat: Aktifkan resolusi DNS brankas kunci, server database, dan cache Redis di jaringan virtual.
   • Ruang kerja Analitik Log: Bertindak sebagai kontainer target untuk aplikasi Anda untuk mengirimkan lognya, di mana Anda juga dapat mengkueri log.
   • Brankas kunci: Digunakan untuk menjaga kata sandi database Anda tetap sama saat Anda menyebarkan ulang dengan AZD.

   Setelah perintah selesai membuat sumber daya dan menyebarkan kode aplikasi untuk pertama kalinya, aplikasi sampel yang disebarkan belum berfungsi karena Anda harus membuat perubahan kecil untuk membuatnya terhubung ke database di Azure.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

3. Verifikasi string koneksi

Templat AZD yang Anda gunakan menghasilkan variabel konektivitas untuk Anda sudah sebagai pengaturan aplikasi dan mengeluarkannya ke terminal untuk kenyamanan Anda. Pengaturan aplikasi adalah salah satu cara untuk menjaga rahasia koneksi keluar dari repositori kode Anda.

1. Dalam output AZD, temukan pengaturan AZURE_MYSQL_CONNECTIONSTRINGaplikasi . Hanya nama pengaturan yang ditampilkan. Mereka terlihat seperti ini dalam output AZD:

    App Service app has the following app settings:
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
            - AZURE_MYSQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
    

   AZURE_MYSQL_CONNECTIONSTRINGberisi string koneksi ke database MySQL di Azure. Anda perlu menggunakannya dalam kode Anda nanti.

2. Demi kenyamanan Anda, templat AZD menunjukkan tautan langsung ke halaman pengaturan aplikasi aplikasi. Temukan tautan dan buka di tab browser baru.

   Jika Anda menambahkan pengaturan aplikasi yang berisi oracle, SQL Server, PostgreSQL, atau mySQL yang valid string koneksi, App Service menambahkannya sebagai sumber data Java Naming and Directory Interface (JNDI) dalam file context.xml server JBoss.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

4. Konfirmasi sumber data JNDI

Dalam langkah ini, Anda menggunakan koneksi SSH ke kontainer aplikasi untuk memverifikasi sumber data JNDI di server JBoss. Dalam prosesnya, Anda mempelajari cara mengakses shell SSH untuk kontainer JBoss.

1. Dalam output AZD, temukan URL untuk sesi SSH dan navigasikan ke dalamnya di browser. Ini terlihat seperti ini dalam output:

    Open SSH session to App Service container at: https://<app-name>-<hash>.scm.azurewebsites.net/webssh/host
    

2. Di terminal SSH, jalankan $JBOSS_HOME/bin/jboss-cli.sh --connect.

3. Di koneksi JBoss CLI, jalankan ls subsystem=datasources/data-source. Anda akan melihat sumber data yang dihasilkan secara otomatis yang disebut AZURE_MYSQL_CONNECTIONSTRING_DS.

4. Dapatkan nama JNDI sumber data dengan /subsystem=datasources/data-source=AZURE_MYSQL_CONNECTIONSTRING_DS:read-attribute(name=jndi-name). Anda sekarang memiliki nama java:jboss/env/jdbc/AZURE_MYSQL_CONNECTIONSTRING_DSJNDI , yang dapat Anda gunakan dalam kode aplikasi Anda nanti.

   

Mengalami masalah? Periksa bagian Pemecahan Masalah.

5. Ubah kode sampel dan sebarkan ulang

Mengalami masalah? Periksa bagian Pemecahan Masalah.

6. Menelusuri aplikasi

1. Di output AZD, temukan URL aplikasi Anda dan navigasikan ke url tersebut di browser. URL terlihat seperti ini dalam output AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

2. Tambahkan beberapa tugas ke dalam daftar.

   

   Selamat, Anda menjalankan aplikasi web di Azure App Service, dengan konektivitas yang aman ke Azure Database for MySQL.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

7. Mengalirkan log diagnostik

Azure App Service dapat mengambil log konsol untuk membantu Anda mendiagnosis masalah dengan aplikasi Anda. Untuk kenyamanan, templat AZD sudah mengaktifkan pengelogan ke sistem file lokal dan mengirimkan log ke ruang kerja Analitik Log.

Aplikasi sampel mencakup pernyataan pengelogan Log4j standar untuk menunjukkan kemampuan ini, seperti yang ditunjukkan dalam cuplikan berikut:

private static final Logger logger = Logger.getLogger(MethodHandles.lookup().lookupClass().getName());

@PersistenceContext
private EntityManager entityManager;

public List<Task> getAllTasks() {
    logger.log(Level.INFO, "Finding all tasks. ");

    return this.entityManager.createNamedQuery("findAllTasks", Task.class).getResultList();
}

Dalam output AZD, temukan tautan untuk mengalirkan log App Service dan navigasikan ke log tersebut di browser. Tautan terlihat seperti ini dalam output AZD:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Pelajari selengkapnya tentang pengelogan di aplikasi Java dalam seri di Mengaktifkan Azure Monitor OpenTelemetry untuk aplikasi .NET, Node.js, Python, dan Java.

Mengalami masalah? Periksa bagian Pemecahan Masalah.

8. Membersihkan sumber daya

Untuk menghapus semua sumber daya Azure di lingkungan penyebaran saat ini, jalankan azd down dan ikuti perintahnya.

azd down