Mulai Cepat: Menyebarkan aplikasi pertama Anda ke Azure Spring Apps

Catatan

50 jam vCPU pertama dan memori 100 GB gratis setiap bulan. Untuk informasi selengkapnya, lihat Pengurangan Harga - Azure Spring Apps melakukan lebih banyak hal, biaya lebih murah!di Blog Azure.

Catatan

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: ✔️ Tingkat Dasar/Standar ✔️ Tingkat Enterprise

Mulai cepat ini menjelaskan cara menyebarkan aplikasi kecil untuk dijalankan di Azure Spring Apps.

Kode aplikasi yang digunakan dalam tutorial ini adalah aplikasi sederhana. Ketika Anda telah menyelesaikan contoh ini, aplikasi akan dapat diakses secara online, dan Anda dapat mengelolanya melalui portal Azure.

Mulai cepat ini menjelaskan cara:

• Hasilkan proyek Spring dasar.
• Menyediakan instans layanan.
• Membangun dan menyebarkan aplikasi dengan titik akhir publik.
• Membersihkan sumber daya.

Di akhir mulai cepat ini, Anda akan memiliki aplikasi spring yang berfungsi yang berjalan di Azure Spring Apps.

Azure CLI

Prasyarat

• Langganan Azure. Jika Anda tidak memiliki langganan, buat akun gratis sebelum memulai.
• Azure CLI. Instal ekstensi Azure Spring Apps dengan perintah berikut: az extension add --name spring
• Jika Anda menyebarkan tingkat Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Prasyarat dari Menampilkan penawaran tingkat Azure Spring Apps Enterprise di Marketplace Azure.

Memprovisikan instans Azure Spring Apps

Gunakan langkah-langkah berikut untuk menyediakan instans layanan.

1. Pilih Coba dan masuk ke akun Azure Anda di Azure Cloud Shell.

   az account show
   

2. Ruang kerja Azure Cloud Shell bersifat sementara. Pada awalnya, shell meminta Anda untuk mengaitkan instans Azure Storage dengan langganan Anda untuk mempertahankan file di seluruh sesi.

   

3. Setelah berhasil masuk, gunakan perintah berikut untuk menampilkan daftar langganan Anda.

   az account list --output table
   

4. Gunakan perintah berikut untuk memilih dan menautkan ke langganan Anda.

   az account set --subscription <subscription-id>
   

5. Gunakan perintah berikut untuk membuat grup sumber daya.

   az group create \
       --resource-group <name-of-resource-group> \
       --location eastus
   

6. Gunakan perintah berikut untuk membuat instans layanan Azure Spring Apps.

   az spring create \
       --resource-group <name-of-resource-group> \
       --name <service-instance-name>
   

7. Pilih Y untuk menginstal ekstensi Azure Spring Apps dan menjalankannya.

Membuat aplikasi di instans Azure Spring Apps Anda

Gunakan perintah berikut untuk menentukan nama aplikasi di Azure Spring Apps sebagai hellospring.

az spring app create \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --assign-endpoint true

Mengkloning dan membangun proyek sampel Spring Boot

Gunakan langkah-langkah berikut untuk mengkloning proyek sampel Spring Boot.

1. Gunakan perintah berikut untuk mengkloning proyek sampel Spring Boot dari GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot.git
   

2. Gunakan perintah berikut untuk berpindah ke folder proyek.

   cd gs-spring-boot/complete
   

3. Gunakan perintah Maven berikut untuk membangun proyek.

   mvn clean package -DskipTests
   

Menyebarkan aplikasi lokal ke Azure Spring Apps

Gunakan perintah berikut untuk menyebarkan file .jar untuk aplikasi (target/spring-boot-complete-0.0.1-SNAPSHOT.jar di Windows).

az spring app deploy \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --artifact-path target/spring-boot-complete-0.0.1-SNAPSHOT.jar

Penyebaran aplikasi dapat memakan waktu beberapa menit.

IntelliJ

Prasyarat

• Langganan Azure. Jika Anda tidak memiliki langganan, buat akun gratis sebelum memulai.
• IDEA IntelliJ.
• Azure Toolkit untuk IntelliJ.
• Jika Anda menyebarkan tingkat Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Prasyarat dari Menampilkan penawaran tingkat Azure Spring Apps Enterprise di Marketplace Azure.

Membuat proyek Spring

Gunakan langkah-langkah berikut untuk membuat proyek:

1. Gunakan Spring Initializr untuk menghasilkan proyek sampel dengan dependensi yang direkomendasikan untuk Azure Spring Apps. URL berikut menyediakan pengaturan default untuk Anda.

https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.6.10&packaging=jar&jvmVersion=11&groupId=com.example&artifactId=hellospring&name=hellospring&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.hellospring&dependencies=web,cloud-eureka,actuator,cloud-config-client

Gambar berikut menunjukkan pengaturan Initializr yang direkomendasikan untuk proyek sampel hellospring .

Contoh ini menggunakan Java versi 11. Untuk menggunakan versi Java yang berbeda, ubah pengaturan versi Java di bawah Metadata Proyek.

1. Saat semua dependensi diatur, pilih Buat.

2. Unduh dan bongkar paket, lalu buat pengontrol web untuk aplikasi web Anda dengan menambahkan file src/main/java/com/example/hellospring/HelloController.java dengan konten berikut:

   package com.example.hellospring;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Greetings from Azure Spring Apps!";
       }
   
   }
   

Memprovisikan instans Azure Spring Apps

Gunakan langkah-langkah berikut untuk membuat instans Azure Spring Apps menggunakan portal Azure.

1. Di tab baru, buka portal Microsoft Azure.

2. Dari kotak pencarian teratas, cari Azure Spring Apps.

3. Pilih Azure Spring Apps dari hasil.

   

4. Di halaman Azure Spring Apps, pilih Buat.

   

5. Isi formulir di halaman Buat Azure Spring Apps. Pertimbangkan panduan berikut:

   • Langganan: Pilih langganan yang ingin Anda ditagih untuk sumber daya ini.
   • Grup sumber daya: Membuat grup sumber daya baru untuk sumber daya baru adalah praktik terbaik.
   • Nama Layanan: Tentukan nama instans layanan. Anda akan menggunakan nama ini nanti di artikel ini tempat <tempat penampung nama> instans layanan muncul. 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: Pilih wilayah untuk instans layanan Anda.

   

6. Pilih Tinjau dan buat.

Mengimpor proyek

Gunakan langkah-langkah berikut untuk mengimpor proyek.

1. Buka IntelliJ IDEA, lalu pilih Buka.

2. Dalam kotak dialog Buka File atau Proyek , pilih folder hellospring .

   

Membangun dan menyebarkan aplikasi

Catatan

Untuk menjalankan proyek secara lokal, tambahkan spring.config.import=optional:configserver: ke file application.properties proyek.

Gunakan langkah-langkah berikut untuk membangun dan menyebarkan aplikasi Anda.

1. Jika Anda belum menginstal Azure Toolkit untuk IntelliJ, ikuti langkah-langkah dalam Menginstal Azure Toolkit untuk IntelliJ.

2. Klik kanan proyek Anda di jendela Proyek IntelliJ, lalu pilih Azure ->Deploy ke Azure Spring Apps.

   

3. Setujui nama aplikasi di bidang Nama. Nama mengacu pada konfigurasi, bukan nama aplikasi. Anda biasanya tidak perlu mengubahnya.

4. Di kotak teks Artefak, pilih Maven:com.example:hellospring-0.0.1-SNAPSHOT.

5. Di kotak teks Langganan , verifikasi bahwa langganan Anda sudah benar.

6. Di kotak teks Layanan, pilih instans Azure Spring Apps yang Anda buat di Memprovisikan instans Azure Spring Apps.

7. Di kotak teks Aplikasi , pilih tanda plus (+) untuk membuat aplikasi baru.

   

8. Di kotak teks Nama aplikasi: di bawah Dasar Aplikasi, masukkan hellospring, lalu pilih kotak centang Pengaturan lainnya .

9. Pilih tombol Aktifkan di samping Titik akhir publik. Tombol berubah menjadi Nonaktifkan <untuk diaktifkan>.

10. Jika Anda menggunakan Java 11, pilih Java 11 untuk opsi Runtime .

11. PilihOK.

    

12. Di bawah Sebelum diluncurkan, pilih Jalankan Maven Goal 'hellospring:package', lalu pilih ikon pensil untuk mengedit baris perintah.

    

13. Di kotak teks Baris perintah , masukkan -DskipTests setelah paket, lalu pilih OK.

    

14. Untuk memulai penyebaran, pilih tombol Jalankan di bagian bawah kotak dialog Sebarkan aplikasi Azure Spring Apps . Plug-in menjalankan perintah mvn package -DskipTests pada hellospring aplikasi dan menyebarkan file .jar yang dihasilkan oleh package perintah .

Visual Studio Code

Prasyarat

• Jika Anda menyebarkan tingkat Azure Spring Apps Enterprise untuk pertama kalinya dalam langganan target, lihat bagian Prasyarat dari Menampilkan penawaran tingkat Azure Spring Apps Enterprise di Marketplace Azure.

Menyebarkan aplikasi web Spring Boot ke Azure Spring Apps dengan Visual Studio Code

Untuk menyebarkan aplikasi web Spring Boot ke Azure Spring Apps, ikuti langkah-langkah di Java di Azure Spring Apps.

Setelah penyebaran selesai, Anda dapat mengakses aplikasi di https://<service instance name>-hellospring.azuremicroservices.io/.

Membersihkan sumber daya

Jika Anda berencana untuk terus bekerja dengan mulai cepat dan tutorial berikutnya, biarkan sumber daya ini tetap di tempatnya. Saat Anda tidak lagi memerlukan sumber daya, hapus dengan menghapus grup sumber daya. Gunakan perintah berikut untuk menghapus grup sumber daya:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Langkah berikutnya

Dalam mulai cepat ini, Anda mempelajari cara membuat proyek Spring dasar, menyediakan instans layanan, membangun dan menyebarkan aplikasi dengan titik akhir publik, dan membersihkan sumber daya.

Anda juga memiliki akses ke log, metrik, dan kemampuan pelacakan terdistribusi yang kuat dari portal Azure. Untuk informasi selengkapnya, lihat Mulai Cepat: Memantau aplikasi Azure Spring Apps dengan log, metrik, dan pelacakan.

Untuk mempelajari cara menggunakan lebih banyak kemampuan Azure Spring, lanjutkan ke seri mulai cepat yang menyebarkan aplikasi contoh ke Azure Spring Apps:

Pengenalan ke aplikasi sampel

Untuk templat aplikasi kemasan dengan infrastruktur Azure Spring Apps yang disediakan menggunakan Bicep, lihat Aplikasi Layanan Mikro Spring Boot PetClinic yang Disebarkan ke Azure Spring Apps.

Contoh lainnya tersedia di GitHub: Contoh Azure Spring Apps.