Mulai Cepat: Menyebarkan aplikasi pertama Anda ke Azure Spring Apps
Artikel
Catatan
Paket Basic, Standard, dan Enterprise tidak digunakan lagi mulai pertengahan Maret 2025, dengan periode penghentian 3 tahun. Sebaiknya transisi ke Azure Container Apps. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.
Artikel ini menjelaskan cara menyebarkan aplikasi kecil untuk dijalankan di Azure Spring Apps.
Kode aplikasi yang digunakan dalam tutorial ini adalah aplikasi sederhana. Ketika Anda menyelesaikan contoh ini, aplikasi dapat diakses secara online, dan Anda dapat mengelolanya melalui portal Azure.
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.
Opsi IntelliJ menggunakan Ide Java yang kuat untuk mengelola sumber daya Azure dengan mudah. Opsi ini cocok untuk pengembang Spring yang terbiasa dengan layanan cloud Azure dan IntelliJ IDEA.
Opsi Visual Studio Code menggunakan editor kode sumber yang ringan tetapi kuat, yang dapat dengan mudah mengelola sumber daya Azure. Opsi ini cocok untuk pengembang Spring yang terbiasa dengan layanan cloud Azure dan Visual Studio Code.
Jika Anda menyebarkan instans paket Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Persyaratan paket Enterprise di Marketplace Azure.
Jika Anda menyebarkan instans paket Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Persyaratan paket Enterprise di Marketplace Azure.
Jika Anda menyebarkan instans paket Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Persyaratan paket Enterprise di Marketplace Azure.
Jika Anda menyebarkan instans paket Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Persyaratan paket Enterprise di Marketplace Azure.
Jika Anda menyebarkan instans paket Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Persyaratan paket Enterprise di Marketplace Azure.
Tombol Sebarkan ke Azure di bagian berikutnya meluncurkan pengalaman portal Azure yang mengunduh paket JAR dari halaman rilis spring-cloud-azure-tools di GitHub. Tidak diperlukan langkah-langkah persiapan lokal.
Gunakan langkah-langkah berikut untuk menyiapkan proyek:
Daftar berikut ini menjelaskan interaksi perintah:
Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.
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
Bagian ini menjelaskan cara membuat instans layanan Azure Spring Apps dan menyiapkan lingkungan cloud 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:
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 Azure Spring Apps
Gunakan langkah-langkah berikut untuk membuat instans layanan 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 Standard consumption & dedicated (preview).
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.
Paket
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 Container Apps
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.
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.
Pilih Buka sumber daya untuk masuk ke halaman Gambaran Umum Azure Spring Apps.
Gunakan langkah-langkah berikut untuk membuat sumber daya yang diperlukan:
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
Ini mungkin perlu waktu cukup lama untuk diselesaikan. Anda akan 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 n untuk membuat aplikasi baru.
Masukkan nama aplikasi (demo): Berikan nama aplikasi. Jika Anda menggunakan ID artefak proyek default, tekan Enter secara langsung.
Mengekspos akses publik untuk aplikasi ini (boot-for-azure): Tekan y.
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
[INFO] InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:NONE
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
Gunakan langkah-langkah berikut 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 demo
- Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
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 spring-guides/gs-spring-boot-for-azure.
Tombol Sebarkan ke Azure di bagian berikutnya meluncurkan pengalaman portal Azure yang mengunduh paket JAR dari halaman rilis spring-cloud-azure-tools di GitHub. Tidak diperlukan langkah-langkah persiapan lokal.
Gunakan langkah-langkah berikut untuk menyiapkan proyek:
Daftar berikut ini menjelaskan interaksi perintah:
Masuk OAuth2: Anda perlu mengotorisasi masuk ke Azure berdasarkan protokol OAuth2.
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
Bagian ini menjelaskan cara membuat instans layanan Azure Spring Apps dan menyiapkan lingkungan cloud 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:
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 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 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.
Paket
Standard
Paket harga yang 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
Menunjukkan apakah akan membuat layanan Azure Spring Apps Anda di zona ketersediaan Azure. Fitur ini saat ini tidak didukung di semua wilayah.
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.
Pilih Buka sumber daya untuk masuk ke halaman Gambaran Umum Azure Spring Apps.
Gunakan langkah-langkah berikut untuk membuat sumber daya yang diperlukan:
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, lalu sebarkan 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 pesan dalam 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
Ini mungkin perlu waktu cukup lama untuk diselesaikan. 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 n untuk membuat aplikasi baru.
Masukkan nama aplikasi (demo): Berikan nama aplikasi. Jika Anda menggunakan ID artefak proyek default, tekan Enter secara langsung.
Mengekspos akses publik untuk aplikasi ini (boot-for-azure): Tekan y.
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
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:UNREGISTERED
[INFO] InstanceName:demo-default-x-xxxxxxxxx-xxxxx Status:Terminating Reason:null DiscoverStatus:UNREGISTERED
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Gunakan langkah-langkah berikut 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 pesan dalam contoh berikut:
Deploying services (azd deploy)
(✓) Done: Deploying service demo
- Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
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 package (mengemas salinan aplikasi Anda yang dapat disebarkan), azd provision (menyediakan sumber daya Azure), dan azd deploy (menyebarkan kode aplikasi). Untuk informasi selengkapnya, lihat spring-guides/gs-spring-boot-for-azure.
Tombol Sebarkan ke Azure di bagian berikutnya meluncurkan pengalaman portal Azure yang mengunduh paket JAR dari halaman rilis spring-cloud-azure-tools di GitHub. Tidak diperlukan langkah-langkah persiapan lokal.
Gunakan langkah-langkah berikut untuk menyiapkan proyek:
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 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 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.
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.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 daftarkan namespace: : Microsoft.SaaS
az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS
3.4. Membuat instans Azure Spring Apps
Gunakan langkah-langkah berikut untuk membuat instans layanan:
Gunakan perintah berikut untuk menerima persyaratan hukum dan pernyataan privasi untuk paket Enterprise:
Catatan
Langkah ini diperlukan hanya jika langganan Anda belum pernah digunakan untuk membuat instans paket Enterprise azure Spring Apps.
az term accept \
--publisher vmware-inc \
--product azure-spring-cloud-vmware-tanzu-2 \
--plan asa-ent-hr-mtr
Gunakan perintah berikut ini untuk membuat instans layanan Azure Spring Apps:
az spring create \
--name ${SERVICE_NAME} \
--sku Enterprise
3.5. Membuat aplikasi di instans Azure Spring Apps Anda
Aplikasi adalah abstraksi dari satu aplikasi bisnis. Untuk informasi selengkapnya, lihat Aplikasi dan penyebaran di Azure Spring Apps. Aplikasi berjalan dalam instans layanan Azure Spring Apps, seperti yang ditunjukkan dalam diagram berikut.
Gunakan perintah berikut untuk membuat aplikasi di Azure Spring Apps:
az spring app create \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--assign-endpoint true
3.1. Masuk ke portal Microsoft Azure.
Buka browser web Anda dan buka portal Azure, masukkan kredensial Anda, dan masuk ke portal. Tampilan default adalah dasbor layanan Anda.
3.2. 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 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.
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.
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 n untuk membuat aplikasi baru.
Masukkan nama aplikasi (demo): Berikan nama aplikasi. Jika Anda menggunakan ID artefak proyek default, tekan Enter secara langsung.
Mengekspos akses publik untuk aplikasi ini (boot-for-azure): Tekan y.
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
[INFO] InstanceName:demo-default-x-xxxxxxxxxx-xxxxx Status:Running Reason:null DiscoverStatus:N/A
[INFO] Getting public url of app(demo)...
[INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
Gunakan perintah berikut untuk menyebarkan file .jar untuk aplikasi:
az spring app deploy \
--service ${SERVICE_NAME} \
--name ${APP_NAME} \
--artifact-path target/demo-0.0.1-SNAPSHOT.jar
Menyebarkan aplikasi dapat memakan waktu beberapa menit.
Bagian ini menyediakan langkah-langkah untuk menyebarkan aplikasi Anda ke Azure Spring Apps.
4.1. Mengimpor proyek
Gunakan langkah-langkah berikut untuk mengimpor proyek:
Buka IntelliJ IDEA dan pilih Buka.
Dalam kotak dialog Buka File atau Proyek , pilih folder demo .
4.2. Membangun dan menyebarkan aplikasi
Gunakan langkah-langkah berikut untuk membangun dan menyebarkan aplikasi Anda:
Azure Toolkit untuk IntelliJ menyediakan empat cara untuk masuk ke Azure, dan penyebaran hanya dapat dimulai setelah masuk.
Klik kanan proyek Anda di jendela Proyek IntelliJ lalu pilih Azure ->Deploy ke Azure Spring Apps.
Setujui nama aplikasi di bidang Nama. Nama mengacu pada konfigurasi, bukan nama aplikasi. Anda biasanya tidak perlu mengubahnya.
Di kotak teks Artefak , pilih Maven:demo(Java 17).
Di kotak teks Langganan , verifikasi bahwa langganan Anda sudah benar.
Di kotak teks Spring Apps , pilih instans Azure Spring Apps yang Anda buat.
Di kotak teks Aplikasi , pilih tanda plus (+) untuk membuat aplikasi baru.
Di kotak teks Nama aplikasi: di bawah Dasar Aplikasi, masukkan demo, lalu pilih Pengaturan lainnya.
Pilih tombol Aktifkan di samping Titik akhir publik. Tombol berubah menjadi Nonaktifkan <untuk diaktifkan>. Kemudian, pilih OK.
Di bawah Sebelum diluncurkan, pilih Jalankan Maven Goal 'demo:package', lalu pilih ikon pensil untuk mengedit baris perintah.
Di kotak teks Baris perintah, masukkan -DskipTests setelah paket, lalu pilih OK.
Untuk memulai penyebaran, pilih tombol Jalankan di bagian bawah kotak dialog Sebarkan ke Azure . Plug-in menjalankan perintah package -DskipTests Maven pada demo aplikasi dan menyebarkan file .jar yang dihasilkan oleh package perintah .
Menyebarkan aplikasi dapat memakan waktu beberapa menit. Anda dapat melihat URL publik aplikasi di log konsol output.
Untuk menyebarkan aplikasi ke Azure Spring Apps, ikuti langkah-langkah di bagian Bangun dan sebarkan aplikasi Java di Azure Spring Apps.
5. Memvalidasi aplikasi
Bagian ini menjelaskan cara memvalidasi aplikasi Anda.
Setelah penyebaran selesai, temukan URL aplikasi dari output penyebaran. Gunakan langkah-langkah berikut untuk memvalidasi:
Akses URL aplikasi dari halaman Output Penyebaran. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Periksa detail untuk setiap penyebaran sumber daya, yang berguna untuk menyelidiki masalah penyebaran apa pun.
Setelah penyebaran selesai, akses aplikasi dengan URL aplikasi output. Gunakan langkah-langkah berikut untuk memeriksa log aplikasi untuk menyelidiki masalah penyebaran apa pun:
Akses URL aplikasi output dari halaman Output Penyebaran. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Dari panel navigasi halaman Gambaran Umum instans Azure Spring Apps, pilih Log untuk memeriksa log aplikasi.
Setelah penyebaran selesai, akses aplikasi dengan titik akhir output. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Setelah penyebaran selesai, gunakan langkah-langkah berikut untuk menemukan URL aplikasi dari output penyebaran:
Akses URL aplikasi dari halaman Output Penyebaran. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Periksa detail untuk setiap penyebaran sumber daya, yang berguna untuk menyelidiki masalah penyebaran apa pun.
Setelah penyebaran selesai, gunakan langkah-langkah berikut untuk memvalidasi aplikasi:
Akses URL aplikasi. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Periksa log konsol, yang berguna untuk menyelidiki masalah penyebaran apa pun.
Setelah penyebaran selesai, gunakan langkah-langkah berikut untuk memeriksa log aplikasi untuk menyelidiki masalah penyebaran apa pun:
Akses aplikasi dengan URL aplikasi output. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Gunakan perintah berikut untuk memeriksa log aplikasi untuk menyelidiki masalah penyebaran apa pun:
az spring app logs \
--service ${SERVICE_NAME} \
--name ${APP_NAME}
Gunakan langkah-langkah berikut untuk mengalirkan log aplikasi Anda:
Akses aplikasi dengan URL aplikasi output. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Buka jendela Azure Explorer , perluas simpul Azure, perluas simpul layanan Azure Spring Apps, perluas instans Azure Spring Apps yang Anda buat, lalu pilih instans demo aplikasi yang Anda buat.
Klik kanan dan pilih Mulai Log Streaming, lalu pilih OK untuk melihat log aplikasi real time.
Gunakan langkah-langkah berikut untuk mengalirkan log aplikasi Anda:
Akses aplikasi dengan URL aplikasi output. Saat membuka aplikasi, Anda mendapatkan respons Hello World.
Jika Anda berencana untuk terus bekerja dengan mulai cepat dan tutorial berikutnya, biarkan sumber daya ini tetap di tempatnya. Ketika Anda tidak lagi memerlukan sumber daya, Anda dapat membersihkan sumber daya yang tidak perlu untuk menghindari biaya Azure.