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: ✔️ Konsumsi standar dan khusus (Pratinjau) ✔️ 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.
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.
Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:
Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:
Buat proyek sampel dengan menggunakan perintah berikut:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal. Langkah-langkah ini menggunakan AZD untuk menginisialisasi aplikasi berbasis peristiwa dari templat Azure Developer CLI.
Buka terminal, buat folder baru yang kosong, lalu navigasikan ke terminal tersebut.
Gunakan perintah berikut untuk menginisialisasi proyek:
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, Azure Key Vault, dan instans Azure Bus Layanan. Gunakan langkah-langkah berikut untuk membuat sumber daya ini.
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:
Pilih tombol Sebarkan ke Azure berikut untuk meluncurkan pengalaman penyebaran di portal Azure:
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.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk menyebarkan aplikasi ke Azure Spring Apps.
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.
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:
Pilih Buat sumber daya di sudut portal Azure.
Di kotak pencarian layanan Pencarian dan marketplace, cari bus layanan.
Pada bagian Bus Layanan, pilih Buat.
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.
Location
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.
Pilih Tinjau dan Buat untuk meninjau parameter pembuatan. Kemudian, pilih Buat untuk menyelesaikan pembuatan instans Bus Layanan.
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.
Pilih Buka sumber daya untuk masuk ke halaman Bus Layanan Namespace.
Pilih Kebijakan akses bersama pada menu navigasi lalu pilih RootManageSharedAccessKey.
Pada halaman Kebijakan SAS: RootManageSharedAccessKey, salin dan simpan nilai String Koneksi ion Utama, yang digunakan untuk menyiapkan koneksi dari aplikasi Spring.
Pilih Antrean pada menu navigasi lalu pilih Antrean.
Pada halaman Buat Antrean , masukkan huruf kecil untuk Nama lalu pilih Buat.
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:
Pilih Buat sumber daya di sudut portal.
Pilih Komputasi >Azure Spring Apps.
Isi formulir Konsumsi standar & khusus (pratinjau) dengan informasi berikut:
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
Konsumsi standar & khusus (pratinjau)
Paket harga 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.
Lingkungan Aplikasi Kontainer
myacaenv
Lingkungan adalah batas aman di sekitar satu atau beberapa aplikasi kontainer yang dapat berkomunikasi satu sama lain dan berbagi jaringan virtual, pengelogan, dan konfigurasi Dapr.
(Opsional) Gunakan langkah-langkah berikut untuk membuat Lingkungan Aplikasi Kontainer:
Pilih Buat untuk membuat Lingkungan Aplikasi Kontainer.
Isi tab Dasar dengan informasi berikut:
Nama lingkungan: myacaenv
Paket: (Pratinjau) Profil beban kerja Konsumsi dan Khusus
Redundansi zona: Dinonaktifkan
Pilih tab Profil beban kerja (Pratinjau), lalu pilih Tambahkan profil beban kerja untuk menambahkan profil beban kerja.
Pada halaman Tambahkan profil beban kerja (Pratinjau) , tambahkan informasi berikut:
Nama profil beban kerja: my-wlp
Ukuran profil beban kerja: Pilih Dedicated-D4
Rentang jumlah instans autoscaling: Pilih 3 dan 5
Pilih Tambahkan. Pilihan ini membawa Anda kembali ke halaman Tambahkan profil beban kerja (Pratinjau). Pilih my-wlp, lalu pilih Buat untuk membuat Lingkungan Aplikasi Kontainer.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Pilih Buat untuk menyediakan instans Azure Spring Apps.
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.
Pilih Buka sumber daya untuk masuk ke halaman Gambaran Umum Azure Spring Apps.
Pilih Aplikasi di menu navigasi kiri, lalu pilih Buat Aplikasi.
Pada halaman Buat Aplikasi , masukkan simple-event-driven-app untuk Nama aplikasi, lalu pilih Gunakan aplikasi sampel mulai cepat untuk membuat aplikasi.
Pilih Buat untuk menyelesaikan pembuatan instans Azure Spring Apps.
Setelah pembuatan aplikasi, pilih nama aplikasi yang Anda buat di langkah sebelumnya.
Pilih Konfigurasi dari panel navigasi, lalu konfigurasikan properti berikut pada tab Variabel lingkungan .
SERVICE_BUS_CONNECTION_STRING: Masukkan string koneksi utama Bus Layanan.
Pilih Simpan untuk menyimpan properti koneksi.
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.
Gunakan perintah berikut untuk memprovisikan infrastruktur templat ke Azure:
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>-<random-string>> 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 melihat indikator kemajuan saat menyediakan sumber daya Azure.
Tombol Sebarkan ke Azure di bagian sebelumnya meluncurkan pengalaman portal Azure yang mencakup penyebaran aplikasi, sehingga tidak diperlukan hal lain.
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.
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
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.
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.
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.
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.
Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:
Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:
Buat proyek sampel dengan menggunakan perintah berikut:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal. Langkah-langkah ini menggunakan AZD untuk menginisialisasi aplikasi berbasis peristiwa dari templat Azure Developer CLI.
Buka terminal, buat folder baru yang kosong, lalu navigasikan ke terminal tersebut.
Gunakan perintah berikut untuk menginisialisasi proyek:
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.
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:
Pilih tombol Sebarkan ke Azure berikut untuk meluncurkan pengalaman penyebaran di portal Azure:
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.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk menyebarkan aplikasi ke Azure Spring Apps.
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.
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:
Pilih Buat sumber daya di sudut portal Azure.
Di kotak pencarian layanan Pencarian dan marketplace, cari bus layanan.
Pada bagian Bus Layanan, pilih Buat.
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.
Location
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.
Pilih Tinjau dan Buat untuk meninjau parameter pembuatan. Kemudian, pilih Buat untuk menyelesaikan pembuatan instans Bus Layanan.
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.
Pilih Buka sumber daya untuk masuk ke halaman Bus Layanan Namespace.
Pilih Kebijakan akses bersama pada menu navigasi lalu pilih RootManageSharedAccessKey.
Pada halaman Kebijakan SAS: RootManageSharedAccessKey, salin dan simpan nilai String Koneksi ion Utama, yang digunakan untuk menyiapkan koneksi dari aplikasi Spring.
Pilih Antrean pada menu navigasi lalu pilih Antrean.
Pada halaman Buat Antrean , masukkan huruf kecil untuk Nama lalu pilih Buat.
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:
Pilih Buat sumber daya di sudut portal Azure.
Pilih Komputasi >Azure Spring Apps.
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
Standard
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 dicentang
Apakah akan membuat layanan Azure Spring Apps Anda di zona ketersediaan Azure, layanan tersebut hanya dapat didukung di beberapa wilayah saat ini.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Pilih Buat untuk menyediakan instans Azure Spring Apps.
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. Koneksi instans aplikasi ke instans Bus Layanan
Buka instans Azure Spring Apps Anda di portal Microsoft Azure.
Pilih Aplikasi di menu navigasi, lalu pilih Buat Aplikasi.
Pada halaman Buat Aplikasi, masukkan simple-event-driven-app untuk Nama aplikasi dan pilih Java 17 untuk platform Runtime.
Setelah pembuatan aplikasi, pilih nama aplikasi yang Anda buat di langkah sebelumnya.
Pada halaman Konfigurasi, pilih tab Variabel lingkungan, masukkan SERVICE_BUS_CONNECTION_STRING untuk Kunci, tempelkan Bus Layanan string koneksi untuk Nilai, lalu pilih Simpan.
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.
Gunakan perintah berikut untuk mengatur templat menggunakan paket standar :
azd env set PLAN standard
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.
Tombol Sebarkan ke Azure di bagian sebelumnya meluncurkan pengalaman portal Azure yang mencakup penyebaran aplikasi, sehingga tidak diperlukan hal lain.
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.
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
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.
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.
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.
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.
Gunakan langkah-langkah berikut untuk menyiapkan sampel secara lokal:
Proyek sampel siap di GitHub. Kloning proyek sampel dengan menggunakan perintah berikut:
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.
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:
Pilih tombol Sebarkan ke Azure berikut untuk meluncurkan pengalaman penyebaran di portal Azure:
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.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk menyebarkan aplikasi ke Azure Spring Apps.
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.
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:
Pilih Buat sumber daya di sudut portal Azure.
Di kotak pencarian layanan Pencarian dan marketplace, cari bus layanan.
Pada bagian Bus Layanan, pilih Buat.
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.
Location
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.
Pilih Tinjau dan Buat untuk meninjau parameter pembuatan. Kemudian, pilih Buat untuk menyelesaikan pembuatan instans Bus Layanan.
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.
Pilih Buka sumber daya untuk masuk ke halaman Bus Layanan Namespace.
Pilih Antrean pada menu navigasi, lalu pilih Antrean.
Pada halaman Buat Antrean , masukkan huruf kecil untuk Nama lalu pilih Buat.
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:
Pilih Buat sumber daya di sudut portal Azure.
Pilih Komputasi >Azure Spring Apps.
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 dicentang
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 dicentang
Opsi untuk menggunakan aplikasi sampel bawaan.
Pilih Tinjau dan Buat untuk meninjau pilihan Anda. Lalu, pilih Buat untuk memprovisikan instans Azure Spring Apps.
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 masuk ke halaman Gambaran Umum Azure Spring Apps.
3.4. Koneksi instans aplikasi ke instans Bus Layanan
Gunakan langkah-langkah berikut untuk menyambungkan instans layanan Anda:
Buka instans Azure Spring Apps Anda di portal Microsoft Azure.
Dari panel navigasi, buka panel Aplikasi lalu pilih Buat Aplikasi.
Pada halaman Buat Aplikasi , untuk nama aplikasi, gunakan simple-event-driven-app dan biarkan semua bidang lain dengan nilai defaultnya.
Pilih Buat untuk menyelesaikan pembuatan aplikasi lalu pilih aplikasi untuk melihat detailnya.
Pilih Layanan Koneksi atau dari panel navigasi lalu pilih Buat untuk membuat koneksi layanan baru.
Isi tab Dasar dengan informasi berikut:
Jenis layanan: Pilih Bus Layanan.
nama Koneksi ion: 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.
Konfigurasikan tab Berikutnya: Autentikasi dengan informasi berikut:
Pilih jenis autentikasi yang ingin Anda gunakan antara layanan komputasi dan layanan target Anda.: Pilih string Koneksi ion.
Pilih Next: Networking. Gunakan opsi default Konfigurasikan aturan firewall untuk mengaktifkan akses ke layanan target.
Pilih Berikutnya: Tinjau dan Buat untuk meninjau pilihan Anda, lalu pilih Buat untuk membuat koneksi.
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.
Gunakan langkah-langkah berikut untuk membuat grup sumber daya baru:
Gunakan perintah berikut untuk masuk ke Azure CLI:
az login
Gunakan perintah berikut untuk mengatur lokasi default:
az configure --defaults location=${LOCATION}
Gunakan perintah berikut untuk mencantumkan semua langganan yang tersedia untuk menentukan ID langganan yang akan digunakan:
az account list --output table
Gunakan perintah berikut untuk mengatur langganan default:
az account set --subscription <subscription-ID>
Gunakan perintah berikut ini untuk membuat grup sumber daya:
az group create --resource-group ${RESOURCE_GROUP}
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:
Gunakan perintah berikut untuk membuat namespace Bus Layanan:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
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. Koneksi 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:
Dapatkan string koneksi Bus Layanan dengan menggunakan perintah berikut:
Tombol Sebarkan ke Azure di bagian sebelumnya meluncurkan pengalaman portal Azure yang mencakup penyebaran aplikasi, sehingga tidak diperlukan hal lain.
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.
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
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.
Buka halaman Gambaran Umum instans Azure Spring Apps dan pilih Log untuk memeriksa log aplikasi.
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.
Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:
Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.
Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.
Gunakan langkah-langkah berikut untuk menghapus seluruh grup sumber daya, termasuk layanan yang baru dibuat:
Temukan grup sumber daya Anda di portal Azure. Pada menu navigasi, pilih Grup sumber daya, lalu pilih nama grup sumber daya Anda.
Pada halaman Grup sumber daya, pilih Hapus. Masukkan nama grup sumber daya Anda di kotak teks untuk mengonfirmasi penghapusan, lalu pilih Hapus.
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.
