Bagikan melalui

Menyiapkan lingkungan penahapan di Azure Spring Apps

Note

Paket Basic, Standard, dan Enterprise memasuki periode pensiun pada 17 Maret 2025. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Artikel ini berlaku untuk:✅ Java ❎ C#

Artikel ini berlaku untuk: ❎ Basic ✅ Standard ✅ Enterprise

Artikel ini menjelaskan cara menyiapkan penyebaran tahap dengan menggunakan pola penyebaran biru-hijau di Azure Spring Apps. Penyebaran biru-hijau adalah pola pengiriman berkelanjutan Azure DevOps yang bergantung pada menjaga versi (biru) yang ada tetap aktif saat versi baru (hijau) disebarkan. Artikel ini menunjukkan kepada Anda cara memindahkan penyebaran tahap tersebut ke tahap produksi tanpa mengubah penyebaran produksi.

Prerequisites

  • Instans Azure Spring Apps yang ada pada paket Standar.
  • Azure CLI.

Artikel ini menggunakan aplikasi yang dibangun dari Spring Initializr. Jika Anda ingin menggunakan aplikasi yang berbeda untuk contoh ini, buat perubahan pada bagian aplikasi yang menghadap publik untuk membedakan penggelaran percobaan Anda dari penggelaran produksi.

Tip

Azure Cloud Shell adalah shell interaktif gratis yang dapat Anda gunakan untuk menjalankan instruksi dalam artikel ini. Ini memiliki alat Azure umum yang telah diinstal sebelumnya, termasuk versi terbaru Git, JDK, Maven, dan Azure CLI. Jika Anda masuk ke langganan Azure, mulai instans Cloud Shell Anda. Untuk mempelajari selengkapnya, lihat Gambaran Umum Azure Cloud Shell.

Untuk menyiapkan penyebaran biru-hijau di Azure Spring Apps, ikuti instruksi di bagian berikutnya.

Memasang ekstensi Azure CLI

Instal ekstensi Azure Spring Apps untuk Azure CLI dengan menggunakan perintah berikut:

az extension add --name spring

Menyiapkan aplikasi dan penyebaran

Untuk membangun aplikasi, ikuti langkah-langkah berikut:

  1. Buat kode untuk aplikasi sampel dengan menggunakan Spring Initializr dengan konfigurasi ini.

  2. Unduh kode.

  3. Tambahkan file sumber HelloController.java berikut ke folder **\src\main\java\com\example\hellospring**:

    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!";
  }

}

  4. Buat file .jar :

    mvn clean package -DskipTests

  5. Buat aplikasi di instans Azure Spring Apps Anda:

    az spring app create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name demo \
    --runtime-version Java_17 \
    --assign-endpoint

  6. Sebarkan aplikasi ke Azure Spring Apps:

    az spring app deploy \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name demo \
    --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar

  7. Ubah kode untuk staging deployment Anda:

    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! THIS IS THE GREEN DEPLOYMENT";
  }

}

  8. Bangun ulang file .jar :

    mvn clean package -DskipTests

  9. Buat penyebaran hijau:

    az spring app deployment create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --app demo \
    --name green \
    --runtime-version Java_17 \
    --artifact-path target\hellospring-0.0.1-SNAPSHOT.jar

Menampilkan aplikasi dan penyebaran

Gunakan langkah-langkah berikut untuk melihat aplikasi yang disebarkan.

  1. Buka instans Azure Spring Apps Anda di portal Microsoft Azure.

  2. Dari panel navigasi, buka panel Aplikasi untuk menampilkan aplikasi untuk instans layanan Anda.

    Cuplikan layar panel Aplikasi memperlihatkan aplikasi untuk instans layanan Anda.

  3. Pilih aplikasi untuk melihat detail.

    Cuplikan layar aplikasi demo yang menampilkan halaman Gambaran Umum dengan pengaturan yang tersedia.

  4. Buka Penyebaran untuk melihat semua penyebaran aplikasi. Kisi menunjukkan penyebaran produksi dan penahapan.

    Cuplikan layar yang memperlihatkan penyebaran aplikasi yang tercantum.

  5. Pilih URL untuk membuka aplikasi yang saat ini disebarkan.

    Cuplikan layar yang memperlihatkan URL aplikasi yang disebarkan.

  6. Pilih Produksi di kolom Status untuk melihat aplikasi default.

    Cuplikan layar yang memperlihatkan URL aplikasi default.

  7. Pilih Penahapan di kolom Status untuk melihat aplikasi penahapan.

    Cuplikan layar yang memperlihatkan URL aplikasi penahapan.

Tip

Konfirmasikan bahwa titik akhir pengujian Anda berakhir dengan garis miring (/) untuk memastikan bahwa file CSS dimuat dengan benar. Jika browser mengharuskan Anda memasukkan kredensial masuk untuk melihat halaman, gunakan dekode URL untuk mendekode titik akhir pengujian Anda. Dekode URL mengembalikan URL dalam format https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/green. Gunakan format ini untuk mengakses titik akhir Anda. Jika Anda ingin menonaktifkan autentikasi dasar untuk titik akhir pengujian Anda, jalankan perintah Azure CLI berikut: az spring app update --resource-group <resource-group-name> --service <Azure-Spring-Apps-instance-name> --name demo --disable-test-endpoint-auth true

Note

Pengaturan konfigurasi server berlaku untuk lingkungan staging dan lingkungan produksi Anda. Misalnya, jika Anda mengatur jalur konteks (server.servlet.context-path) untuk demo aplikasi Anda di server konfigurasi sebagai somepath, jalur ke penyebaran hijau Anda berubah menjadi https://\<username>:\<password>@\<cluster-name>.test.azuremicroservices.io/demo/green/somepath/....

Pada saat ini, jika Anda mengunjungi demo aplikasi publik, Anda akan melihat halaman lama tanpa perubahan baru.

Mengatur penyebaran hijau sebagai lingkungan produksi

  1. Setelah Anda memverifikasi perubahan di lingkungan uji coba, Anda dapat mengirimkannya ke produksi. Pada halamanPenyebaran>, pilih aplikasi yang saat ini berada di Produksi.

  2. Pilih elipsis setelah Status pendaftaran penyebaran hijau, lalu pilih Atur sebagai produksi.

    Cuplikan layar yang memperlihatkan pilihan untuk mengubah build staging ke produksi.

  3. Konfirmasikan bahwa URL aplikasi menampilkan perubahan Anda.

    Cuplikan layar yang memperlihatkan URL aplikasi sekarang dalam produksi.

Note

Setelah Anda menetapkan penyebaran hijau sebagai lingkungan produksi, penyebaran sebelumnya menjadi penyebaran penahapan.

Mengubah penyebaran di lingkungan staging

Jika Anda tidak puas dengan perubahan, Anda dapat memodifikasi kode aplikasi, membangun paket .jar baru, dan mengunggahnya ke penyebaran hijau Anda dengan menggunakan Azure CLI:

az spring app deploy \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name demo \
    --deployment green \
    --artifact-path demo.jar

Menghapus penggelaran uji coba

Untuk menghapus penyebaran tahap Anda dari portal Azure, buka halaman untuk penyebaran tahap tersebut dan pilih tombol Hapus.

Atau, hapus deploy tahap Anda dari Azure CLI dengan menjalankan perintah ini:

az spring app deployment delete \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --name <staging-deployment-name> \
    --app demo

Langkah selanjutnya

  • Last updated on