Mulai cepat: Menyebarkan aplikasi berbasis peristiwa ke Azure Spring Apps

Catatan

Paket Basic, Standard, dan Enterprise memasuki periode pensiun pada 17 Maret 2025. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Artikel ini berlaku untuk:✅ Basic/Standard ✅ Enterprise

Artikel ini menjelaskan cara menyebarkan aplikasi berbasis peristiwa Spring Boot ke Azure Spring Apps.

Proyek sampel adalah aplikasi berbasis peristiwa yang berlangganan antrean Bus Layanan bernama lower-case, lalu menangani pesan dan mengirim pesan lain ke antrean lain bernama upper-case. Untuk membuat aplikasi sederhana, pemrosesan pesan hanya mengonversi pesan menjadi huruf besar. Diagram berikut menggambarkan proses ini:

Artikel ini menyediakan opsi berikut untuk menyebarkan ke Azure Spring Apps:

• Opsi portal Azure adalah cara term mudah dan tercepat untuk membuat sumber daya dan menyebarkan aplikasi dengan satu klik. Opsi ini cocok untuk pengembang Spring yang ingin dengan cepat menyebarkan aplikasi ke layanan cloud Azure.
• Opsi plugin portal Azure + Maven adalah cara yang lebih konvensional untuk membuat sumber daya dan menyebarkan aplikasi langkah demi langkah. Opsi ini cocok untuk pengembang Spring yang menggunakan layanan cloud Azure untuk pertama kalinya.
• Opsi Azure Developer CLI adalah cara yang lebih efisien untuk membuat sumber daya secara otomatis dan menyebarkan aplikasi melalui perintah sederhana. Azure Developer CLI menggunakan templat untuk menyediakan sumber daya Azure yang diperlukan dan untuk menyebarkan kode aplikasi. Opsi ini cocok untuk pengembang Spring yang terbiasa dengan layanan cloud Azure.

• Opsi portal Azure adalah cara term mudah dan tercepat untuk membuat sumber daya dan menyebarkan aplikasi dengan satu klik. Opsi ini cocok untuk pengembang Spring yang ingin dengan cepat menyebarkan aplikasi ke layanan cloud Azure.
• Opsi plugin portal Azure + Maven adalah cara yang lebih konvensional untuk membuat sumber daya dan menyebarkan aplikasi langkah demi langkah. Opsi ini cocok untuk pengembang Spring yang menggunakan layanan cloud Azure untuk pertama kalinya.
• Opsi Azure CLI menggunakan alat baris perintah yang kuat untuk mengelola sumber daya Azure. Opsi ini cocok untuk pengembang Spring yang terbiasa dengan layanan cloud Azure.

1. Prasyarat

Portal Azure

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

plugin portal Azure + Maven

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
• Git.
• Java Development Kit (JDK), versi 17.

Azure Developer CLI

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
• Git.
• Java Development Kit (JDK), versi 17.
• Azure Developer CLI (AZD), versi 1.2.0 atau yang lebih tinggi.

Portal Azure

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.

plugin portal Azure + Maven

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
• Git.
• Java Development Kit (JDK), versi 17.

Azure CLI

• Langganan Azure. Jika Anda tidak memiliki akun Azure, buat akun gratis sebelum memulai.
• Git.
• Java Development Kit (JDK), versi 17.
• Azure CLI versi 2.45.0 atau yang lebih tinggi.

2. Siapkan proyek Spring

Portal Azure

Tombol Sebarkan ke Azure di bagian berikutnya meluncurkan pengalaman portal Azure yang mengunduh paket JAR dari halaman rilis ASA-Samples-Web-Application di GitHub. Tidak diperlukan langkah-langkah persiapan lokal.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:

1. Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Buat proyek sampel dengan menggunakan perintah berikut:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure Developer CLI

Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal. Langkah-langkah ini menggunakan AZD untuk menginisialisasi aplikasi berbasis peristiwa dari templat Azure Developer CLI.

1. Buka terminal, buat folder baru yang kosong, lalu navigasikan ke terminal tersebut.

2. Gunakan perintah berikut untuk menginisialisasi proyek:

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Masukkan nama lingkungan baru: Berikan nama lingkungan, yang digunakan sebagai akhiran untuk grup sumber daya yang dibuat untuk menyimpan semua sumber daya Azure. Nama ini harus unik dalam langganan Azure Anda.

   Konsol menghasilkan pesan yang mirip dengan contoh berikut:

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

3. Siapkan lingkungan cloud

Sumber daya utama yang Anda butuhkan untuk menjalankan sampel ini adalah instans Azure Spring Apps, instans Azure Key Vault, dan instans Azure Bus Layanan. Gunakan langkah-langkah berikut untuk membuat sumber daya ini.

Portal Azure

Bagian ini menggunakan tombol Sebarkan ke Azure untuk meluncurkan pengalaman penyebaran di portal Azure. Pengalaman ini menggunakan templat ARM untuk membuat sumber daya Azure.

3.1. Masuk ke portal Microsoft Azure.

Buka portal Azure dan masukkan kredensial Anda untuk masuk ke portal. Tampilan default adalah dasbor layanan Anda.

3.2. Membuat sumber daya Azure

Gunakan langkah-langkah berikut untuk membuat semua sumber daya Azure yang bergantung pada aplikasi:

1. Pilih tombol Sebarkan ke Azure berikut untuk meluncurkan pengalaman penyebaran di portal Azure:

   

2. Isi formulir pada tab Dasar . Gunakan tabel berikut sebagai panduan untuk melengkapi formulir:

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama berlangganan Anda.	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Wilayah	Wilayah yang paling dekat dengan pengguna Anda.	Wilayah ini digunakan untuk membuat grup sumber daya.

3. Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk menyebarkan aplikasi ke Azure Spring Apps.

4. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan. Pilih Buka sumber daya untuk membuka halaman Gambaran Umum layanan.

   

plugin portal Azure + Maven

3.1. Masuk ke portal Microsoft Azure.

Buka browser web Anda dan buka portal Azure. Masukkan info masuk Anda untuk masuk ke portal. Tampilan default adalah dasbor layanan Anda.

3.2. Membuat instans Bus Layanan

Gunakan langkah-langkah berikut untuk membuat instans Bus Layanan:

1. Pilih Buat sumber daya di sudut portal Azure.

2. Di kotak pencarian layanan Pencarian dan marketplace, cari bus layanan.

3. Pada bagian Bus Layanan, pilih Buat.

4. Isi formulir pada tab Dasar . Gunakan tabel berikut sebagai panduan untuk melengkapi formulir:

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama berlangganan Anda.	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Nama namespace layanan	my-srvbus	Nama unik yang mengidentifikasi layanan Bus Layanan Anda.
   Tempat	Lokasi yang paling dekat dengan pengguna Anda.	Lokasi yang paling dekat dengan pengguna Anda.
   Opsi dan paket hosting	Dasar	Paket harga menentukan sumber daya dan biaya yang terkait dengan instans Anda.

5. Pilih Tinjau dan Buat untuk meninjau parameter pembuatan. Kemudian, pilih Buat untuk menyelesaikan pembuatan instans Bus Layanan.

6. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan. Pilih Buka sumber daya untuk membuka halaman Gambaran Umum layanan.

   

7. Pilih Buka sumber daya untuk masuk ke halaman Bus Layanan Namespace.

8. Pilih Kebijakan akses bersama pada menu navigasi lalu pilih RootManageSharedAccessKey.

9. Pada halaman Kebijakan SAS: RootManageSharedAccessKey, salin dan simpan nilai String Koneksi Utama, yang digunakan untuk menyiapkan koneksi dari aplikasi Spring.

10. Pilih Antrean pada menu navigasi lalu pilih Antrean.

11. Pada halaman Buat Antrean , masukkan huruf kecil untuk Nama lalu pilih Buat.

12. Buat antrean lain dengan mengulangi langkah sebelumnya menggunakan huruf besar untuk Nama.

3.3. Membuat instans Azure Spring Apps

Gunakan langkah-langkah berikut untuk membuat instans Azure Spring Apps:

1. Pilih Buat sumber daya di sudut portal Azure.

2. Pilih Komputasi >Azure Spring Apps.

3. Isi formulir Dasar dengan informasi berikut:

   Gunakan tabel berikut sebagai panduan untuk melengkapi formulir. Paket yang direkomendasikan adalah Standar.

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama langganan Anda	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Nama	myasa	Nama unik yang mengidentifikasi layanan Azure Spring Apps Anda. Nama harus antara 4 hingga 32 karakter dan hanya boleh berisi huruf kecil, angka, dan tanda hubung. Karakter pertama dari nama layanan harus berupa huruf dan karakter terakhir harus berupa huruf atau angka.
   Rencana	Standar	Paket menentukan sumber daya dan biaya yang terkait dengan instans Anda.
   Wilayah	Wilayah yang paling dekat dengan pengguna Anda	Lokasi yang paling dekat dengan pengguna Anda.
   Zona Redundan	Tidak dipilih	Apakah akan membuat layanan Azure Spring Apps Anda di zona ketersediaan Azure, layanan tersebut hanya dapat didukung di beberapa wilayah saat ini.

4. Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Pilih Buat untuk menyediakan instans Azure Spring Apps.

5. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan. Memilih Buka sumber daya akan membuka halaman Gambaran Umum layanan.

   

3.4. Menyambungkan instans aplikasi ke instans Bus Layanan

1. Buka instans Azure Spring Apps Anda di portal Microsoft Azure.

2. Pilih Aplikasi di menu navigasi, lalu pilih Buat Aplikasi.

3. Pada halaman Buat Aplikasi, masukkan simple-event-driven-app untuk Nama aplikasi dan pilih Java 17 untuk platform Runtime.

   

4. Setelah pembuatan aplikasi, pilih nama aplikasi yang Anda buat di langkah sebelumnya.

5. Pada halaman Konfigurasi, pilih tab Variabel lingkungan, masukkan SERVICE_BUS_CONNECTION_STRING untuk Kunci, tempelkan Bus Layanan string koneksi untuk Nilai, lalu pilih Simpan.

   

Azure Developer CLI

1. Gunakan perintah berikut untuk masuk ke Azure dengan OAuth2. Abaikan langkah ini jika Anda sudah masuk.

   azd auth login
   

   Konsol menghasilkan pesan yang mirip dengan contoh berikut:

   Logged in to Azure.
   

2. Gunakan perintah berikut untuk mengatur templat menggunakan paket standar :

   azd env set PLAN standard
   

3. Gunakan perintah berikut untuk mengemas salinan aplikasi Anda yang dapat disebarkan, menyediakan infrastruktur templat ke Azure, dan menyebarkan kode aplikasi ke sumber daya yang baru disediakan:

   azd provision
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Pilih Langganan Azure yang akan digunakan: Gunakan panah untuk memindahkan, mengetik untuk memfilter, lalu tekan Enter.
   • Pilih lokasi Azure yang akan digunakan: Gunakan panah untuk memindahkan, mengetik untuk memfilter, lalu tekan Enter.

   Konsol menghasilkan pesan yang mirip dengan contoh berikut:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Catatan

   Perintah ini mungkin memerlukan beberapa saat untuk bisa menyelesaikan prosesnya. Anda diperlihatkan indikator kemajuan saat menyediakan sumber daya Azure.

4. Menyebarkan aplikasi ke Azure Spring Apps

Portal Azure

Tombol Sebarkan ke Azure di bagian sebelumnya meluncurkan pengalaman portal Azure yang mencakup penyebaran aplikasi, sehingga tidak diperlukan hal lain.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menyebarkan menggunakan plugin Maven untuk Azure Spring Apps:

1. Navigasi ke direktori lengkap , lalu jalankan perintah berikut untuk mengonfigurasi aplikasi di Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.
   • Pilih langganan: Pilih nomor daftar langganan instans Azure Spring Apps yang Anda buat, yang default ke langganan pertama dalam daftar. Jika Anda menggunakan nomor default, tekan Enter secara langsung.
   • Gunakan Azure Spring Apps yang sudah ada di Azure: Tekan y untuk menggunakan instans Azure Spring Apps yang ada.
   • Pilih Azure Spring Apps untuk penyebaran: Pilih nomor daftar instans Azure Spring Apps yang Anda buat. Jika Anda menggunakan nomor default, tekan Enter secara langsung.
   • Gunakan aplikasi yang sudah ada di Azure Spring Apps <nama> instans Anda: Tekan y untuk menggunakan aplikasi yang dibuat.
   • Konfirmasi untuk menyimpan semua konfigurasi di atas: Tekan y. Jika Anda menekan n, konfigurasi tidak disimpan dalam file POM.

2. Gunakan perintah berikut untuk menyebarkan aplikasi:

   ./mvnw azure-spring-apps:deploy
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.

   Setelah perintah dijalankan, Anda dapat melihat dari pesan log berikut bahwa penyebaran berhasil:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure Developer CLI

Gunakan langkah-langkah berikut untuk menggunakan AZD untuk mengemas aplikasi, menyediakan sumber daya Azure yang diperlukan oleh aplikasi web, lalu sebarkan ke Azure Spring Apps.

1. Gunakan perintah berikut untuk mengemas salinan aplikasi Anda yang dapat disebarkan:

   azd package
   

   Konsol menghasilkan pesan yang mirip dengan contoh berikut:

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. Gunakan perintah berikut untuk menyebarkan kode aplikasi ke sumber daya yang baru disediakan:

   azd deploy
   

   Konsol menghasilkan pesan yang mirip dengan contoh berikut:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Catatan

Anda juga dapat menggunakan azd up untuk menggabungkan tiga perintah sebelumnya: azd provision (menyediakan sumber daya Azure), azd package (mengemas salinan aplikasi Anda yang dapat disebarkan), dan azd deploy (menyebarkan kode aplikasi). Untuk informasi selengkapnya, lihat Azure-Samples/ASA-Samples-Event-Driven-Application.

2. Siapkan proyek Spring

Portal Azure

Tombol Sebarkan ke Azure di bagian berikutnya meluncurkan pengalaman portal Azure yang mengunduh paket JAR dari halaman rilis ASA-Samples-Web-Application di GitHub. Tidak diperlukan langkah-langkah persiapan lokal.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:

1. Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Buat proyek sampel dengan menggunakan perintah berikut:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Azure CLI

Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:

1. Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Buat proyek sampel dengan menggunakan perintah berikut:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

3. Siapkan lingkungan cloud

Sumber daya utama yang Anda butuhkan untuk menjalankan sampel ini adalah instans Azure Spring Apps dan instans Azure Bus Layanan. Bagian berikut menjelaskan cara membuat sumber daya ini.

Portal Azure

Bagian ini menggunakan tombol Sebarkan ke Azure untuk meluncurkan pengalaman penyebaran di portal Azure. Pengalaman ini menggunakan templat ARM untuk membuat sumber daya Azure.

3.1. Masuk ke portal Microsoft Azure.

Buka portal Azure dan masukkan kredensial Anda untuk masuk ke portal. Tampilan default adalah dasbor layanan Anda.

3.2. Membuat sumber daya Azure

Gunakan langkah-langkah berikut untuk membuat semua sumber daya Azure yang bergantung pada aplikasi:

1. Pilih tombol Sebarkan ke Azure berikut untuk meluncurkan pengalaman penyebaran di portal Azure:

   

2. Isi formulir pada tab Dasar . Gunakan tabel berikut sebagai panduan untuk melengkapi formulir:

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama berlangganan Anda.	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Wilayah	Wilayah yang paling dekat dengan pengguna Anda.	Wilayah ini digunakan untuk membuat grup sumber daya.

3. Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk menyebarkan aplikasi ke Azure Spring Apps.

4. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan. Pilih Buka sumber daya untuk membuka halaman Gambaran Umum layanan.

   

plugin portal Azure + Maven

3.1. Masuk ke portal Microsoft Azure.

Buka portal Azure dan masukkan kredensial Anda untuk masuk ke portal. Tampilan default adalah dasbor layanan Anda.

3.2. Membuat instans Bus Layanan

Gunakan langkah-langkah berikut untuk membuat instans Bus Layanan:

1. Pilih Buat sumber daya di sudut portal Azure.

2. Di kotak pencarian layanan Pencarian dan marketplace, cari bus layanan.

3. Pada bagian Bus Layanan, pilih Buat.

4. Isi formulir pada tab Dasar . Gunakan tabel berikut sebagai panduan untuk melengkapi formulir:

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama berlangganan Anda.	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Nama namespace layanan	my-srvbus	Nama unik yang mengidentifikasi layanan Bus Layanan Anda.
   Tempat	Lokasi yang paling dekat dengan pengguna Anda.	Lokasi yang paling dekat dengan pengguna Anda.
   Opsi dan paket hosting	Dasar	Paket harga menentukan sumber daya dan biaya yang terkait dengan instans Anda.

5. Pilih Tinjau dan Buat untuk meninjau parameter pembuatan. Kemudian, pilih Buat untuk menyelesaikan pembuatan instans Bus Layanan.

6. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan. Pilih Buka sumber daya untuk membuka halaman Gambaran Umum layanan.

   

7. Pilih Buka sumber daya untuk masuk ke halaman Bus Layanan Namespace.

8. Pilih Antrean pada menu navigasi, lalu pilih Antrean.

9. Pada halaman Buat Antrean , masukkan huruf kecil untuk Nama lalu pilih Buat.

10. Buat antrean lain dengan mengulangi langkah sebelumnya menggunakan huruf besar untuk Nama.

3.3. Membuat instans Azure Spring Apps

Gunakan langkah-langkah berikut untuk membuat instans layanan:

1. Pilih Buat sumber daya di sudut portal Azure.

2. Pilih Komputasi >Azure Spring Apps.

3. Isi formulir Dasar dengan informasi berikut:

   Pengaturan	Nilai yang disarankan	Deskripsi
   Langganan	Nama berlangganan Anda.	Langganan Azure yang ingin Anda gunakan untuk server Anda. Jika Anda memiliki beberapa langganan, pilih langganan tempat Anda ingin ditagih untuk sumber daya tersebut.
   Grup sumber daya	myresourcegroup	Nama grup sumber daya baru atau nama yang sudah ada dari langganan Anda.
   Nama	myasa	Nama unik yang mengidentifikasi layanan Azure Spring Apps Anda. Nama harus antara 4 hingga 32 karakter dan hanya boleh berisi huruf kecil, angka, dan tanda hubung. Karakter pertama dari nama layanan harus berupa huruf dan karakter terakhir harus berupa huruf atau angka.
   Wilayah	Wilayah yang paling dekat dengan pengguna Anda.	Lokasi yang paling dekat dengan pengguna Anda.
   Opsi dan paket hosting	Perusahaan	Paket harga yang menentukan sumber daya dan biaya yang terkait dengan instans Anda.
   Zona Redundan	Tidak dipilih	Opsi untuk membuat layanan Azure Spring Apps Anda di zona ketersediaan Azure. Fitur ini saat ini tidak didukung di semua wilayah.
   Paket IP Perangkat Lunak	Bayar sesuai penggunaan	Paket harga yang memungkinkan Anda membayar sesuai pemakaian dengan Azure Spring Apps.
   Menyebarkan proyek sampel	Tidak dipilih	Opsi untuk menggunakan aplikasi sampel bawaan.

4. Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk memprovisikan instans Azure Spring Apps.

5. Pada toolbar, pilih ikon Pemberitahuan (bel) untuk memantau proses penyebaran. Setelah penyebaran selesai, Anda dapat memilih Sematkan ke dasbor, yang membuat petak peta untuk layanan ini di dasbor portal Azure Anda sebagai pintasan ke halaman Gambaran Umum layanan.

   

6. Pilih Buka sumber daya untuk masuk ke halaman Gambaran Umum Azure Spring Apps.

3.4. Menyambungkan instans aplikasi ke instans Bus Layanan

Gunakan langkah-langkah berikut untuk menyambungkan instans layanan Anda:

1. Buka instans Azure Spring Apps Anda di portal Microsoft Azure.

2. Dari panel navigasi, buka panel Aplikasi lalu pilih Buat Aplikasi.

3. Pada halaman Buat Aplikasi , untuk nama aplikasi, gunakan simple-event-driven-app dan biarkan semua bidang lain dengan nilai defaultnya.

4. Pilih Buat untuk menyelesaikan pembuatan aplikasi lalu pilih aplikasi untuk melihat detailnya.

5. Pilih Konektor Layanan dari panel navigasi lalu pilih Buat untuk membuat koneksi layanan baru.

6. Isi tab Dasar dengan informasi berikut:

   • Jenis layanan: Pilih Bus Layanan.
   • Nama koneksi: Diisi dengan nama yang dibuat secara otomatis yang dapat Anda ubah.
   • Langganan: Pilih langganan Anda.
   • Namespace: Pilih namespace yang Anda buat.
   • Jenis klien: Pilih SpringBoot.

7. Konfigurasikan tab Berikutnya: Autentikasi dengan informasi berikut:

   Catatan

   Microsoft merekomendasikan penggunaan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini, seperti untuk database, cache, olahpesan, atau layanan AI, memerlukan tingkat kepercayaan yang sangat tinggi dalam aplikasi dan membawa risiko yang tidak ada dalam alur lain. Gunakan alur ini hanya ketika opsi yang lebih aman, seperti identitas terkelola untuk koneksi tanpa kata sandi atau tanpa kunci, tidak layak. Untuk operasi komputer lokal, lebih suka identitas pengguna untuk koneksi tanpa kata sandi atau tanpa kunci.

   • Pilih jenis autentikasi yang ingin Anda gunakan antara layanan komputasi dan layanan target Anda.: Pilih String koneksi.

8. Pilih Next: Networking. Gunakan opsi default Konfigurasikan aturan firewall untuk mengaktifkan akses ke layanan target.

9. Pilih Berikutnya: Tinjau dan Buat untuk meninjau pilihan Anda, lalu pilih Buat untuk membuat koneksi.

Azure CLI

3.1. Berikan nama untuk setiap sumber daya

Buat variabel untuk menahan nama sumber daya dengan menggunakan perintah berikut. Pastikan untuk mengganti placeholder dengan nilai Anda sendiri.

export RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

3.2. Membuat grup sumber daya baru

Gunakan langkah-langkah berikut untuk membuat grup sumber daya baru:

1. Gunakan perintah berikut untuk masuk ke Azure CLI:

   az login
   

2. Gunakan perintah berikut untuk mengatur lokasi default:

   az configure --defaults location=${LOCATION}
   

3. Gunakan perintah berikut untuk mencantumkan semua langganan yang tersedia untuk menentukan ID langganan yang akan digunakan:

   az account list --output table
   

4. Gunakan perintah berikut untuk mengatur langganan default:

   az account set --subscription <subscription-ID>
   

5. Gunakan perintah berikut ini untuk membuat grup sumber daya:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Gunakan perintah berikut untuk mengatur grup sumber daya yang baru dibuat sebagai grup sumber daya default:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Menginstal ekstensi dan mendaftarkan namespace

Gunakan perintah berikut untuk menginstal ekstensi Azure Spring Apps untuk Azure CLI dan mendaftarkan Microsoft.SaaS namespace layanan:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Membuat instans Azure Spring Apps

Gunakan perintah berikut untuk membuat instans Azure Spring Apps Anda:

az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku Enterprise

Kemudian, gunakan perintah berikut untuk membuat aplikasi di instans Azure Spring Apps:

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Membuat instans Bus Layanan

Gunakan langkah-langkah berikut untuk membuat instans Bus Layanan:

1. Gunakan perintah berikut untuk membuat namespace Bus Layanan:

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

2. Gunakan perintah berikut untuk membuat dua antrean bernama lower-case dan upper-case:

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Menyambungkan instans aplikasi ke instans Bus Layanan

Anda sekarang telah membuat Bus Layanan dan aplikasi di Azure Spring Apps, tetapi aplikasi tidak dapat tersambung ke Bus Layanan. Gunakan langkah-langkah berikut untuk mengaktifkan aplikasi agar tersambung ke Bus Layanan, lalu sebarkan aplikasi:

1. Dapatkan string koneksi Bus Layanan dengan menggunakan perintah berikut:

   Catatan

   Microsoft merekomendasikan penggunaan alur autentikasi paling aman yang tersedia. Alur autentikasi yang dijelaskan dalam prosedur ini, seperti untuk database, cache, olahpesan, atau layanan AI, memerlukan tingkat kepercayaan yang sangat tinggi dalam aplikasi dan membawa risiko yang tidak ada dalam alur lain. Gunakan alur ini hanya ketika opsi yang lebih aman, seperti identitas terkelola untuk koneksi tanpa kata sandi atau tanpa kunci, tidak layak. Untuk operasi komputer lokal, lebih suka identitas pengguna untuk koneksi tanpa kata sandi atau tanpa kunci.

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

2. Gunakan perintah berikut untuk memberikan string koneksi ke aplikasi melalui variabel lingkungan:

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

4. Menyebarkan aplikasi ke Azure Spring Apps

Portal Azure

Tombol Sebarkan ke Azure di bagian sebelumnya meluncurkan pengalaman portal Azure yang mencakup penyebaran aplikasi, sehingga tidak diperlukan hal lain.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menyebarkan menggunakan plugin Maven untuk Azure Spring Apps:

1. Navigasi ke direktori lengkap , lalu jalankan perintah berikut untuk mengonfigurasi aplikasi di Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.
   • Pilih langganan: Pilih nomor daftar langganan instans Azure Spring Apps yang Anda buat, yang default ke langganan pertama dalam daftar. Jika Anda menggunakan nomor default, tekan Enter secara langsung.
   • Gunakan Azure Spring Apps yang sudah ada di Azure: Tekan y untuk menggunakan instans Azure Spring Apps yang ada.
   • Pilih Azure Spring Apps untuk penyebaran: Pilih nomor daftar instans Azure Spring Apps yang Anda buat. Jika Anda menggunakan nomor default, tekan Enter secara langsung.
   • Gunakan aplikasi yang sudah ada di Azure Spring Apps <nama> instans Anda: Tekan y untuk menggunakan aplikasi yang dibuat.
   • Konfirmasi untuk menyimpan semua konfigurasi di atas: Tekan y. Jika Anda menekan n, konfigurasi tidak disimpan dalam file POM.

2. Gunakan perintah berikut untuk menyebarkan aplikasi:

   ./mvnw azure-spring-apps:deploy
   

   Daftar berikut ini menjelaskan interaksi perintah:

   • Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.

   Setelah perintah dijalankan, Anda dapat melihat dari pesan log berikut bahwa penyebaran berhasil:

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Azure CLI

Lingkungan cloud sekarang siap. Sebarkan aplikasi dengan menggunakan perintah berikut:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

5. Memvalidasi aplikasi

Gunakan langkah-langkah berikut untuk mengonfirmasi bahwa aplikasi berbasis peristiwa berfungsi dengan benar. Anda dapat memvalidasi aplikasi dengan mengirim pesan ke lower-case antrean, lalu mengonfirmasi bahwa ada pesan dalam upper-case antrean.

1. Kirim pesan ke antrean lower-case dengan Bus Layanan Explorer. Untuk informasi selengkapnya, lihat bagian Kirim pesan ke antrean atau topik dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

2. Konfirmasikan bahwa ada pesan baru yang dikirim ke upper-case antrean. Untuk informasi selengkapnya, lihat bagian Mengintip pesan dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

3. Buka halaman Gambaran Umum instans Azure Spring Apps dan pilih Log untuk memeriksa log aplikasi.

   

Portal Azure

1. Kirim pesan ke antrean lower-case dengan Bus Layanan Explorer. Untuk informasi selengkapnya, lihat bagian Kirim pesan ke antrean atau topik dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

2. Konfirmasikan bahwa ada pesan baru yang dikirim ke upper-case antrean. Untuk informasi selengkapnya, lihat bagian Mengintip pesan dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

3. Buka halaman Gambaran Umum instans Azure Spring Apps dan pilih Log untuk memeriksa log aplikasi.

   

4. Periksa detail untuk setiap penyebaran sumber daya, yang berguna untuk menyelidiki masalah penyebaran apa pun.

plugin portal Azure + Maven

1. Kirim pesan ke antrean lower-case dengan Bus Layanan Explorer. Untuk informasi selengkapnya, lihat bagian Kirim pesan ke antrean atau topik dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

2. Konfirmasikan bahwa ada pesan baru yang dikirim ke upper-case antrean. Untuk informasi selengkapnya, lihat bagian Mengintip pesan dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

3. Buka halaman Gambaran Umum instans Azure Spring Apps dan pilih Log untuk memeriksa log aplikasi.

   

4. Periksa detail untuk setiap penyebaran sumber daya, yang berguna untuk menyelidiki masalah penyebaran apa pun.

Azure CLI

1. Kirim pesan ke antrean lower-case dengan Bus Layanan Explorer. Untuk informasi selengkapnya, lihat bagian Kirim pesan ke antrean atau topik dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

2. Konfirmasikan bahwa ada pesan baru yang dikirim ke upper-case antrean. Untuk informasi selengkapnya, lihat bagian Mengintip pesan dari Gunakan Bus Layanan Explorer untuk menjalankan operasi data pada Bus Layanan.

3. Buka halaman Gambaran Umum instans Azure Spring Apps dan pilih Log untuk memeriksa log aplikasi.

   

4. Gunakan perintah berikut untuk memeriksa log aplikasi untuk menyelidiki masalah penyebaran apa pun:

   az spring app logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME}
   

6. Membersihkan sumber daya

Pastikan untuk menghapus sumber daya yang Anda buat di artikel ini saat Anda tidak lagi membutuhkannya. Anda dapat menghapus grup sumber daya Azure, yang menyertakan semua sumber daya dalam grup sumber daya.

Portal Azure

Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:

1. Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.

2. Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:

1. Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.

2. Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.

Azure CLI

Gunakan perintah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:

az group delete --name ${RESOURCE_GROUP}

Portal Azure

Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:

1. Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.

2. Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.

plugin portal Azure + Maven

Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:

1. Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.

2. Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.

Azure Developer CLI

Gunakan perintah berikut untuk menghapus semua sumber daya Azure yang digunakan dalam aplikasi sampel ini:

azd down

Daftar berikut ini menjelaskan interaksi perintah:

• Total sumber daya yang akan dihapus: <total> sumber daya Anda, yakin ingin melanjutkan?: Tekan y.
• Sebagai gantinya, Anda ingin menghapus sumber daya ini secara permanen, sehingga nama sumber daya tersebut dapat digunakan kembali?: Tekan y. Tekan n jika Anda ingin menggunakan kembali Key Vault.

Konsol menghasilkan pesan yang mirip dengan contoh berikut:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.

7. Langkah selanjutnya

Log aplikasi terstruktur untuk Azure Spring Apps

Memetakan domain kustom yang sudah ada ke Azure Spring Apps

Menyiapkan CI/CD Azure Spring Apps dengan GitHub Actions

Mengotomatiskan penyebaran aplikasi ke Azure Spring Apps

Menggunakan identitas terkelola untuk aplikasi di Azure Spring Apps

Membuat koneksi layanan di Azure Spring Apps dengan Azure CLI

Menjalankan aplikasi layanan mikro (Klinik Hewan Peliharaan)

Pengantar aplikasi sampel Fitness Store

Untuk informasi lebih lanjut, baca artikel berikut:

• Sampel Azure Spring Apps.
• Spring di Azure
• Spring Cloud Azure