Menyebarkan Aplikasi Spring Boot ke Azure Kubernetes Service

Nota

Untuk aplikasi Spring Boot, sebaiknya gunakan Azure Container Apps. Namun, Anda masih dapat memilih untuk menggunakan Azure Kubernetes Service sebagai tujuan. Untuk informasi selengkapnya, lihat Memilih layanan Azure yang tepat untuk aplikasi Java Anda.

Tutorial ini memandu Anda menggabungkan Kubernetes dan Docker untuk mengembangkan dan menyebarkan aplikasi Spring Boot ke Microsoft Azure. Lebih khusus lagi, Anda menggunakan Spring Boot untuk pengembangan aplikasi, Kubernetes untuk penyebaran kontainer, dan Azure Kubernetes Service (AKS) untuk menghosting aplikasi Anda.

Kubernetes dan Docker adalah solusi sumber terbuka yang membantu pengembang mengotomatiskan penyebaran, penskalaan, dan manajemen aplikasi mereka yang berjalan dalam kontainer.

Prasyarat

• Langganan Azure; jika Anda belum memiliki langganan Azure, Anda dapat mengaktifkan manfaat pelanggan MSDN atau mendaftar untuk akun Azure gratis .
• Antarmuka Command-Line Azure (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 pengembangan Maven dari Apache (Versi 3).
• Klien Git.
• Klien Docker .
• pembantu kredensial ACR 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 "Getting Started" Spring Boot pada Docker

Langkah-langkah berikut memandu Anda membangun aplikasi web Spring Boot dan mengujinya secara lokal.

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

   mkdir C:\SpringBoot
   cd C:\SpringBoot
   

   --atau--

   mkdir /users/$USER/SpringBoot
   cd /users/$USER/SpringBoot
   

2. Kloning proyek sampel Spring Boot di Docker Getting Started ke direktori.

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

3. Ubah direktori ke proyek yang telah selesai.

   cd gs-spring-boot-docker
   cd complete
   

4. Gunakan Maven untuk membuat dan menjalankan aplikasi sampel.

   mvn package spring-boot:run
   

5. Uji aplikasi web dengan menelusuri ke http://localhost:8080, atau dengan perintah curl berikut:

   curl http://localhost:8080
   

6. Anda akan melihat pesan berikut ditampilkan: Hello Docker World

   

Membuat Azure Container Registry menggunakan Azure CLI

1. Buka jendela perintah.

2. Masuk ke akun Azure Anda:

   az login
   

3. Pilih Langganan Azure Anda:

   az account set -s <YourSubscriptionID>
   

4. Buat grup sumber daya untuk sumber daya Azure yang digunakan dalam tutorial ini.

   az group create --name=wingtiptoys-kubernetes --location=eastus
   

5. Buat registri kontainer Azure privat di grup sumber daya. Tutorial ini mendorong aplikasi sampel sebagai gambar Docker ke registri ini di langkah selanjutnya. Ganti wingtiptoysregistry dengan nama unik untuk registri Anda.

   az acr create --resource-group wingtiptoys-kubernetes --location eastus \
    --name wingtiptoysregistry --sku Basic
   

Dorong aplikasi Anda ke registri kontainer melalui Jib

1. Masuk ke Azure Container Registry Anda dari Azure CLI.

   # set the default name for Azure Container Registry, otherwise you need to specify the name in "az acr login"
   az config set defaults.acr=wingtiptoysregistry
   az acr login
   

2. Buka file pom.xml dengan editor teks; misalnya Visual Studio Code.

   code pom.xml
   

3. Perbarui koleksi <properties> dalam file pom.xml dengan nama registri untuk Azure Container Registry Anda dan versi terbaru dari plug-in jib-maven .

   <properties>
      <!-- Note: If your ACR name contains upper case characters, be sure to convert them to lower case characters. -->
      <docker.image.prefix>wingtiptoysregistry.azurecr.io</docker.image.prefix>
      <jib-maven-plugin.version>2.5.2</jib-maven-plugin.version>
      <java.version>1.8</java.version>
   </properties>
   

4. Perbarui koleksi <plugins> dalam file pom.xml sehingga elemen <plugin> berisi entri untuk jib-maven-plugin, seperti yang ditunjukkan dalam contoh berikut. Perhatikan bahwa kami menggunakan gambar dasar dari Microsoft Container Registry (MCR): mcr.microsoft.com/openjdk/jdk:11-ubuntu, yang berisi JDK yang didukung secara resmi untuk Azure. Untuk gambar dasar MCR lainnya dengan JDK yang didukung secara resmi, lihat Menginstal Microsoft Build of OpenJDK..

   <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}/gs-spring-boot-docker</image>
        </to>
     </configuration>
   </plugin>
   

5. Navigasikan ke direktori proyek yang telah selesai untuk aplikasi Spring Boot Anda dan jalankan perintah berikut untuk membangun gambar dan mendorong gambar ke registri:

   az acr login && mvn compile jib:build
   

Nota

Karena masalah keamanan Azure Cli dan Azure Container Registry, kredensial yang dibuat oleh az acr login berlaku selama 1 jam. Jika Anda melihat kesalahan 401 Unauthorized, Anda dapat menjalankan perintah az acr login --name <your registry name> lagi untuk mengotoriskan ulang. Jika Anda melihat kesalahan Read timed out, Anda dapat mencoba meningkatkan batas waktu dengan mvn -Djib.httpTimeout=7200000 jib:dockerBuild, atau -Djib.httpTimeout=0 untuk batas waktu tak terbatas.

Membuat Kluster Kubernetes di AKS menggunakan Azure CLI

1. Buat kluster Kubernetes di Azure Kubernetes Service. Perintah berikut membuat kluster kubernetes di grup sumber daya wingtiptoys-kubernetes, dengan wingtiptoys-akscluster sebagai nama kluster, dengan Azure Container Registry (ACR) wingtiptoysregistry terpasang, dan wingtiptoys-kubernetes sebagai awalan DNS:

   az aks create --resource-group=wingtiptoys-kubernetes --name=wingtiptoys-akscluster \
    --attach-acr wingtiptoysregistry \
    --dns-name-prefix=wingtiptoys-kubernetes --generate-ssh-keys
   

   Perintah ini mungkin perlu waktu cukup lama untuk diselesaikan.

2. Instal kubectl menggunakan Azure CLI. Pengguna Linux mungkin harus mengawali perintah ini dengan sudo karena menyebarkan Kubernetes CLI ke /usr/local/bin.

   az aks install-cli
   

3. Unduh informasi konfigurasi kluster sehingga Anda dapat mengelola kluster dari antarmuka web Kubernetes dan kubectl.

   az aks get-credentials --resource-group=wingtiptoys-kubernetes --name=wingtiptoys-akscluster
   

Menyebarkan gambar ke kluster Kubernetes Anda

Tutorial ini menyebarkan aplikasi menggunakan kubectl, lalu memungkinkan Anda menjelajahi penyebaran melalui antarmuka web Kubernetes.

Menyebarkan dengan kubectl

1. Buka jendela perintah.

2. Jalankan kontainer Anda di kluster Kubernetes dengan menggunakan perintah kubectl run. Berikan nama layanan untuk aplikasi Anda di Kubernetes dan nama gambar lengkap. Misalnya:

   kubectl run gs-spring-boot-docker --image=wingtiptoysregistry.azurecr.io/gs-spring-boot-docker:latest
   

   Dalam perintah ini:

   • Nama kontainer gs-spring-boot-docker ditentukan segera setelah perintah run

   • Parameter --image menentukan server login gabungan dan nama gambar sebagai wingtiptoysregistry.azurecr.io/gs-spring-boot-docker:latest

3. Mengekspos kluster Kubernetes secara eksternal dengan menggunakan perintah kubectl expose. Tentukan nama layanan Anda, port TCP yang menghadap publik yang digunakan untuk mengakses aplikasi, dan port target internal yang didengarkan aplikasi Anda. Misalnya:

   kubectl expose pod gs-spring-boot-docker --type=LoadBalancer --port=80 --target-port=8080
   

   Dalam perintah ini:

   • Nama kontainer gs-spring-boot-docker ditentukan segera setelah perintah expose pod.

   • Parameter --type menentukan bahwa kluster menggunakan load balancer.

   • Parameter --port menentukan port TCP yang menghadap publik 80. Anda mengakses aplikasi di port ini.

   • Parameter --target-port menetapkan port TCP internal sebesar 8080. Load balancer meneruskan permintaan ke aplikasi Anda di port ini.

4. Setelah aplikasi disebarkan ke kluster, kueri alamat IP eksternal dan buka di browser web Anda:

   kubectl get services -o=jsonpath='{.items[*].status.loadBalancer.ingress[0].ip}'
   

   

Menyebarkan dengan tampilan sumber daya Kubernetes

1. Pilih Tambahkan dari salah satu tampilan sumber daya (Namespace, Beban Kerja, Layanan dan ingress, Penyimpanan, atau Konfigurasi).

   

2. Tempelkan dalam YAML berikut:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: gs-spring-boot-docker
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: gs-spring-boot-docker
     template:
       metadata:
         labels:
           app: gs-spring-boot-docker
       spec:
         containers:
         - name: gs-spring-boot-docker
           image: wingtiptoysregistry.azurecr.io/gs-spring-boot-docker:latest
   

3. Pilih Tambahkan di bagian bawah editor YAML untuk menyebarkan aplikasi.

   

   Setelah menyebarkan Deployment, seperti di atas, pilih Tambahkan di bagian bawah editor YAML untuk menyebarkan Service menggunakan YAML berikut:

   apiVersion: v1
   kind: Service
   metadata:
     name: gs-spring-boot-docker
   spec:
     type: LoadBalancer
     ports:
     - port: 80
       targetPort: 8080
     selector:
       app: gs-spring-boot-docker
   

4. Setelah file YAML ditambahkan, penampil sumber daya menunjukkan aplikasi Spring Boot Anda. Layanan eksternal menyertakan alamat IP eksternal yang ditautkan sehingga Anda dapat dengan mudah melihat aplikasi di browser Anda.

   

   

5. Pilih IP Eksternal. Anda kemudian akan melihat aplikasi Spring Boot yang berjalan di Azure.

   

Langkah berikutnya

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

Musim Semi di Azure

Lihat juga

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

• Menyebarkan aplikasi Spring Boot ke Linux di Azure App Service

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

Untuk informasi selengkapnya tentang menyebarkan aplikasi Java ke Kubernetes dengan Visual Studio Code, lihat Tutorial Java Visual Studio Code.

Untuk informasi selengkapnya tentang proyek sampel Spring Boot di Docker, lihat Spring Boot di Docker Getting Started.

Tautan berikut memberikan informasi tambahan tentang membuat aplikasi Spring Boot:

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

Tautan berikut memberikan informasi tambahan tentang menggunakan Kubernetes dengan Azure:

• Mulai menggunakan kluster Kubernetes di Azure Kubernetes Service

Informasi lebih lanjut tentang menggunakan antarmuka baris perintah Kubernetes tersedia di panduan pengguna kubectl di https://kubernetes.io/docs/reference/kubectl/.

Situs web Kubernetes memiliki beberapa artikel yang membahas penggunaan gambar di registri privat:

• Mengonfigurasi Akun Layanan untuk Pod
• Namespace
• Menarik Gambar dari Registri Privat

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

Untuk informasi selengkapnya tentang menjalankan dan men-debug kontainer secara berulang langsung di Azure Kubernetes Service (AKS) dengan Azure Dev Spaces, lihat Memulai Azure Dev Spaces dengan Java