Label penyebaran di Azure Container Apps

Label deployment membantu Anda menetapkan nama yang bermakna, seperti dev, staging, atau prod, pada revisi kontainer tertentu. Saat Menerapkan nama-nama ini, Anda menyederhanakan penanganan skenario penyebaran yang kompleks dan manajemen lingkungan.

Dengan menggunakan label penyebaran, Anda dapat:

  • Tetapkan label deskriptif yang jelas ke revisi.
  • Secara otomatis mengalokasikan revisi baru ke label untuk pengarahan dan manajemen lalu lintas.
  • Mengarahkan lalu lintas berdasarkan label alih-alih mengubah nama revisi.
  • Promosikan atau turunkan revisi dengan menarik kembali label.
  • Gulung balik ke revisi sebelumnya dengan menggunakan riwayat label.

Penting

Sebelum dapat menggunakan label penyebaran, Anda harus mengikuti langkah-langkah untuk terlebih dahulu mengaktifkan label penyebaran di portal untuk aplikasi kontainer Anda.

Fitur utama

Label penyebaran memungkinkan Anda membuat strategi penyebaran canggih sambil mempertahankan kontrol atas siklus hidup aplikasi Anda dengan menggunakan fitur-fitur berikut:

  • Penetapan label: Buat dan tetapkan label yang bermakna ke revisi kontainer, sehingga lebih mudah untuk mengelola lingkungan seperti dev, staging, dan prod.

  • Pemisahan lalu lintas & pengujian A/B: Dukungan untuk pemisahan lalu lintas, rollback tanpa pengamatan, dan pengujian A/B memungkinkan peluncuran dan pengujian fitur baru secara bertahap.

  • Rilis penahapan & pertukaran otomatis: Aktivasi revisi otomatis memungkinkan Anda membuat revisi baru dengan lancar dan menetapkannya ke label baru atau yang sudah ada untuk menerima lalu lintas. Setiap revisi yang tidak lagi direferensikan oleh label dimatikan secara otomatis.

Menggunakan label penyebaran

Secara default, label penyebaran tidak tersedia untuk aplikasi kontainer Anda. Untuk mengaktifkan, label penyebaran, ikuti langkah-langkah ini di portal Microsoft Azure:

  1. Buka aplikasi kontainer Anda di portal Azure.

  2. Dari menu, di bawah bagian Aplikasi , pilih Revisi dan replika.

  3. Pilih Mode penyebaran.

  4. Pilih kolom Label Penggelaran.

  5. Pilih Terapkan.

Membuat label baru

Buat label baru di portal berdasarkan label yang sudah ada. Secara default, Container Apps membuat label pertama Anda bernama label-1. Saat membuat label melalui CLI atau Bicep, Anda dapat mengaitkannya dengan revisi yang ada atau revisi baru.

  1. Buka aplikasi kontainer Anda di portal Azure.

  2. Dari menu, di bawah bagian Aplikasi , pilih Label.

  3. Pilih Label baru.

  4. Pilih label yang sudah ada yang ingin Anda jadikan dasar bagi label baru.

  5. Masukkan nama label baru dalam kotak teks.

  6. Pilih Duplikat.

Riwayat label dan pembatalan

Anda dapat melihat riwayat lengkap label dengan menggunakan langkah-langkah berikut:

  1. Buka aplikasi kontainer Anda di portal Azure.

  2. Dari menu, di bawah Aplikasi, pilih Label.

  3. Pilih Perlihatkan riwayat untuk label yang Anda minati.

Gunakan opsi Perlihatkan riwayat untuk label apa pun untuk:

  • Tinjau riwayat revisi label.
  • Kembali ke revisi sebelumnya dengan mengarahkan label ke revisi kontainer yang berbeda.

Menggunakan label penyebaran

Untuk mengaktifkan label penyebaran, ikuti langkah-langkah ini di Azure CLI:

  1. Buka terminal Anda.

  2. Buat variabel lingkungan berikut.

     CONTAINER_APP_NAME="my-container-app"
     CONTAINER_APP_IMAGE="mcr.microsoft.com/k8se/quickstart:latest"
     LOCATION="centralus"
     RESOURCE_GROUP="my-container-apps-rg"
     ENVIRONMENT_NAME="my-container-apps-env"
     TARGET_LABEL="stage"
    
  3. Gunakan perintah berikut untuk membuat aplikasi baru dan revisi dengan label:

    az containerapp create \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --image $CONTAINER_APP_IMAGE \
    --environment $ENVIRONMENT_NAME \
    --location $LOCATION \
    --ingress external \
    --target-port 0 \
    --revisions-mode labels \
    --target-label $TARGET_LABEL
    
  4. Untuk membuat revisi baru dengan label baru atau yang sudah ada, gunakan perintah berikut:

    az containerapp update \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --image $CONTAINER_APP_IMAGE \
    --target-label $TARGET_LABEL
    
  5. Untuk memperlihatkan riwayat label, gunakan perintah berikut:

    az containerapp label-history show \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --label $TARGET_LABEL
    
  6. Untuk menampilkan lalu lintas aplikasi label, gunakan perintah berikut:

    az containerapp ingress traffic show \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    
  7. Untuk menambahkan label ke revisi, gunakan perintah berikut:

    az containerapp revision label add \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --revision $REVISION_NAME \
    --label $TARGET_LABEL
    
  8. Untuk menghapus label dari revisi, gunakan perintah berikut:

    az containerapp revision label remove \
    --name $CONTAINER_APP_NAME \
    --resource-group $RESOURCE_GROUP \
    --label $TARGET_LABEL
    

Skenario yang didukung

  • Penyebaran biru-hijau: Kelola penyebaran biru-hijau dengan mudah dengan memberi label dan beralih antara revisi. Pendekatan ini menyediakan cara sederhana untuk menangani pertukaran lingkungan yang lengkap.

  • Pengujian A/B: Mengarahkan persentase lalu lintas ke revisi yang berbeda untuk pengujian fitur. Praktik ini memungkinkan Anda memvalidasi fungsionalitas baru dengan subset pengguna sebelum penyebaran penuh.

  • Peluncuran bertahap: Secara bertahap meningkatkan lalu lintas ke revisi baru dengan menyesuaikan persentase lalu lintas.

  • Isolasi lingkungan: Gunakan label untuk mempertahankan lingkungan dev, staging, dan prod terpisah. Setiap lingkungan dapat diperbarui secara independen sambil mempertahankan jalur promosi yang jelas.

Contoh alur kerja

Berikut adalah alur kerja umum menggunakan label penyebaran:

  1. Buat label awal: Buat label seperti "tahap" dan "produksi" yang menunjuk ke revisi yang sama pada awalnya.

  2. Memperbarui label: Pilih label (misalnya, "tahap") untuk memperbaruinya dengan kontainer, penskalaan, atau pengaturan volume baru.

  3. Uji perubahan: Dengan revisi baru yang disebarkan, rutekan sebagian lalu lintas ke label yang diperbarui.

  4. Promosikan perubahan: Saat Anda yakin dengan revisi produksi, perbarui label produksi untuk mengarahkan ke revisi yang sama.

  5. Pantau dan putar kembali jika diperlukan: Jika masalah muncul, gunakan riwayat label untuk mengembalikan ke versi sebelumnya.

Label revisi