Menyebarkan aplikasi Spring Boot ke Linux di Azure App Service

Tutorial ini menunjukkan cara menggunakan Docker untuk menampung aplikasi Spring Boot Anda dan menyebarkan gambar Docker Anda sendiri ke host Linux di Azure App Service.

Prasyarat

Untuk menyelesaikan langkah-langkah dalam tutorial ini, Anda memerlukan prasyarat berikut:

• Langganan Azure; jika Anda belum memiliki langganan Azure, aktifkan manfaat pelanggan MSDN Anda atau daftar untuk akun Azure gratis.
• Azure Command-Line Antarmuka (CLI).
• Java Development Kit (JDK) yang didukung. Untuk informasi selengkapnya tentang JDK yang tersedia untuk digunakan saat mengembangkan di Azure, lihat dukungan Java di Azure dan Azure Stack.
• alat pemrograman Apache Maven (Versi 3).
• Klien Git.
• Klien Docker .

Nota

Karena persyaratan virtualisasi tutorial ini, Anda tidak dapat mengikuti langkah-langkah dalam artikel ini pada komputer virtual. Anda harus menggunakan komputer fisik dengan fitur virtualisasi diaktifkan.

Membuat aplikasi web "Panduan Memulai Spring Boot di Docker"

Langkah-langkah berikut menelusuri langkah-langkah yang diperlukan untuk membuat aplikasi web Spring Boot sederhana dan mengujinya secara lokal.

1. Buka prompt perintah dan buat direktori lokal untuk menahan aplikasi Anda, dan ubah ke direktori tersebut; misalnya:

   mkdir SpringBoot
   cd SpringBoot
   

2. Kloning Spring Boot di Docker Getting Started proyek sampel ke direktori yang Anda buat; misalnya:

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

3. Ubah direktori ke proyek yang telah selesai; misalnya:

   cd gs-spring-boot-docker/complete
   

4. Bangun file JAR menggunakan Maven; misalnya:

   mvn package
   

5. Setelah aplikasi web dibuat, ubah direktori ke target direktori tempat file JAR berada dan mulai aplikasi web; misalnya:

   cd target
   java -jar spring-boot-docker-complete-0.0.1-SNAPSHOT.jar --server.port=80
   

6. Uji aplikasi web dengan menelusurinya secara lokal menggunakan browser web. Misalnya, jika Anda memiliki curl yang tersedia dan Anda mengonfigurasi server Tomcat untuk berjalan pada port 80:

   curl http://localhost
   

7. Anda melihat pesan berikut ditampilkan: Hello Docker World

   

Membuat Azure Container Registry untuk digunakan sebagai registri Docker privat

Langkah-langkah berikut berjalan menggunakan portal Microsoft Azure untuk membuat Azure Container Registry.

Nota

Jika Anda ingin menggunakan Azure CLI alih-alih portal Microsoft Azure, ikuti langkah-langkah dalam Membuat registri kontainer Docker privat menggunakan Azure CLI 2.0.

1. Buka portal Microsoft Azure dan masuk.

   Setelah Anda masuk ke akun Anda di portal Azure, ikuti langkah-langkah dalam artikel Membuat registri kontainer Docker privat menggunakan portal Azure. Langkah-langkah berikut memparafrasekan instruksi tersebut demi keluasan.

2. Pilih ikon menu untuk Baru, pilih Kontainer, lalu pilih Azure Container Registry.

   

3. Saat halaman Buat registri kontainer muncul, masukkan Nama registri, Langganan, Grup sumber daya, dan Lokasi. Lalu pilih Buat.

   

4. Pilih Kunci akses di bawah Pengaturan dan aktifkan sakelar Diaktifkan untuk pengguna Admin.

   

Mengonfigurasi Maven untuk membangun gambar ke Azure Container Registry Anda

1. Buka direktori proyek yang telah selesai untuk aplikasi Spring Boot Anda - misalnya, C:\SpringBoot\gs-spring-boot-docker\complete atau /users/robert/SpringBoot/gs-spring-boot-docker/complete - dan buka file pom.xml dengan editor teks.

2. Perbarui koleksi <properties> dalam file pom.xml dengan versi terbaru jib-maven-plugin, nilai server masuk, dan pengaturan akses untuk Azure Container Registry Anda dari bagian sebelumnya dalam tutorial ini. Misalnya:

   <properties>
      <jib-maven-plugin.version>3.2.0</jib-maven-plugin.version>
      <docker.image.prefix>wingtiptoysregistry.azurecr.io</docker.image.prefix>
      <java.version>1.8</java.version>
   </properties>
   

3. Tambahkan jib-maven-plugin ke <plugins> koleksi dalam file pom.xml . Contoh ini menggunakan versi 3.2.0.

   Tentukan gambar dasar di <from>/<image>, di sini mcr.microsoft.com/openjdk/jdk:11-ubuntu. Tentukan nama gambar akhir yang akan dibangun dari basis di <to>/<image>.

   Autentikasi {docker.image.prefix} adalah server masuk di halaman registri yang ditampilkan sebelumnya. {project.artifactId} adalah nama dan nomor versi file JAR dari build Maven pertama proyek.

   <plugin>
     <artifactId>jib-maven-plugin</artifactId>
     <groupId>com.google.cloud.tools</groupId>
     <version>${jib-maven-plugin.version}</version>
     <configuration>
        <from>
            <image>mcr.microsoft.com/openjdk/jdk:11-ubuntu</image>
        </from>
        <to>
            <image>${docker.image.prefix}/${project.artifactId}</image>
        </to>
     </configuration>
   </plugin>
   

4. Buka direktori proyek yang telah selesai untuk aplikasi Spring Boot Anda dan jalankan perintah berikut untuk membangun kembali aplikasi dan dorong kontainer ke Azure Container Registry Anda:

   az acr login --name wingtiptoysregistry && mvn compile jib:build
   

Nota

Perintah az acr login ... mencoba masuk ke Azure Container Registry. Jika tidak, Anda perlu menyediakan <username> dan <password> untuk jib-maven-plugin. Untuk mempelajari selengkapnya, lihat Metode Autentikasi dalam jib.

Saat Anda menggunakan Jib untuk mengunggah image Anda ke Azure Container Registry, image tersebut tidak menggunakan Dockerfile. Untuk informasi selengkapnya, lihat artikel ini .

Membuat aplikasi web di Linux di Azure App Service dengan menggunakan gambar kontainer Anda

1. Buka portal Microsoft Azure dan masuk.

2. Pilih ikon menu untuk Buat sumber daya, pilih Komputasi, lalu pilih Aplikasi Web.

   

3. Saat halaman Aplikasi Web di Linux muncul, masukkan informasi berikut:

   • Pilih Langganan Anda dari daftar drop-down.

   • Pilih grup sumber daya yang sudah ada, atau tentukan nama untuk membuat grup sumber daya baru.

   • Masukkan nama unik untuk Nama aplikasi; misalnya: wingtiptoyslinux.

   • Tentukan keTerbitkan .

   • Untuk bidang Sistem Operasi , pilih Linux.

   • Pilih Wilayah.

   • Terima Paket Linux dan pilihPaket App Service yang sudah ada, atau pilih Buat baru untuk membuat paket layanan aplikasi baru.

   • Pilih Berikutnya: Docker.

   

   Pada halaman Aplikasi Web pilih Docker, dan masukkan informasi berikut:

   • Pilih Kontainer Tunggal.

   • Registri: Pilih kontainer Anda, misalnya: wingtiptoysregistry.

   • Image: Pilih gambar yang dibuat sebelumnya, misalnya: spring-boot-docker.

   • Tag: Pilih tag untuk gambar, misalnya: terbaru .

   • Perintah Startup: Biarkan kosong karena gambar sudah memiliki perintah start up.

   Setelah Anda memasukkan semua informasi sebelumnya, pilih Tinjau + buat.

   

   • Pilih Tinjau + buat.

Tinjau informasi dan pilih Buat.

Setelah penyebaran selesai, pilih Pergi ke sumber daya. Halaman penyebaran menampilkan URL untuk mengakses aplikasi.

Nota

Azure secara otomatis memetakan permintaan Internet ke server Tomcat tersemat yang berjalan pada port 80. Namun, jika Anda mengonfigurasi server Tomcat yang disematkan untuk dijalankan pada port 8080 atau port kustom, Anda perlu menambahkan variabel lingkungan ke aplikasi web yang menentukan port untuk server Tomcat yang disematkan. Untuk menambahkan variabel lingkungan, gunakan langkah-langkah berikut:

1. Buka portal Microsoft Azure dan masuk.

2. Pilih ikon untuk Web Apps, dan pilih aplikasi Anda dari halaman App Services.

3. Pilih Konfigurasi di panel navigasi kiri.

4. Di bagian Pengaturan aplikasi , tambahkan pengaturan baru bernama WEBSITES_PORT dan masukkan nomor port kustom Anda untuk nilai tersebut.

5. Pilih OK. Lalu pilih Simpan.

Membersihkan sumber daya

Saat Anda tidak lagi memerlukan sumber daya, gunakan portal Azure untuk menghapusnya. Menghapus sumber daya membantu Anda menghindari biaya tak terduga.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang Spring dan Azure, lanjutkan ke pusat dokumentasi Spring on Azure.

Spring pada Azure

Lihat juga

Untuk informasi selengkapnya tentang menggunakan aplikasi Spring Boot di Azure, lihat artikel berikut ini:

• Menyebarkan Aplikasi Spring Boot pada Kluster Kubernetes di Azure Container Service

Untuk informasi selengkapnya tentang menggunakan Azure dengan Java, lihat Azure for Java Developers dan Bekerja dengan Azure DevOps dan Java.

Untuk detail lebih lanjut tentang proyek sampel Spring Boot di Docker, lihat Spring Boot di Docker Getting Started.

Untuk panduan dalam memulai aplikasi Spring Boot milik Anda sendiri, lihat Spring Initializr di https://start.spring.io/.

Untuk informasi selengkapnya tentang mulai membuat aplikasi Spring Boot sederhana, lihat Spring Initializr di https://start.spring.io/.

Untuk contoh selengkapnya tentang cara menggunakan gambar Docker kustom dengan Azure, lihat Menggunakan gambar Docker kustom untuk Azure Web App di Linux.