Memperbarui gambar Kubernetes dan node di beberapa kluster menggunakan Azure Kubernetes Fleet Manager

Admin platform yang mengelola sejumlah besar kluster sering memiliki masalah dengan penahapan pembaruan beberapa kluster (misalnya, meningkatkan gambar OS node atau versi Kubernetes) dengan cara yang aman dan dapat diprediksi. Untuk mengatasi tantangan ini, Azure Kubernetes Fleet Manager (Fleet) memungkinkan Anda mengatur pembaruan di beberapa kluster menggunakan eksekusi pembaruan.

Eksekusi pembaruan terdiri dari tahapan, grup, dan strategi dan dapat diterapkan secara manual untuk pembaruan satu kali, atau secara otomatis, untuk pembaruan reguler yang sedang berlangsung menggunakan profil peningkatan otomatis. Semua pembaruan berjalan (manual atau otomatis) menghormati jendela pemeliharaan kluster anggota.

Panduan ini mencakup cara mengonfigurasi dan menjalankan eksekusi pembaruan secara manual.

Prasyarat

• Baca gambaran umum konseptual fitur ini, yang memberikan penjelasan tentang strategi pembaruan, eksekusi, tahapan, dan grup yang dirujuk dalam panduan ini.

• Anda harus memiliki sumber daya Armada dengan satu atau beberapa kluster anggota. Jika tidak, ikuti mulai cepat untuk membuat sumber daya Armada dan bergabung dengan kluster Azure Kubernetes Service (AKS) sebagai anggota.

• Atur variabel lingkungan berikut:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  

• Jika Anda mengikuti instruksi Azure CLI dalam artikel ini, Anda memerlukan Azure CLI versi 2.58.0 atau yang lebih baru terinstal. Untuk menginstal atau meningkatkan, lihat Menginstal Azure CLI.

• Anda juga memerlukan fleet ekstensi Azure CLI, yang dapat Anda instal dengan menjalankan perintah berikut:

  az extension add --name fleet
  

  Jalankan az extension update perintah untuk memperbarui ke versi terbaru ekstensi yang dirilis:

  az extension update --name fleet
  

Membuat eksekusi pembaruan

Catatan

Eksekusi pembaruan mematuhi jendela pemeliharaan terencana yang Anda tetapkan di tingkat kluster AKS. Untuk informasi selengkapnya, lihat pemeliharaan terencana di beberapa kluster anggota, yang menjelaskan bagaimana pembaruan berjalan menangani kluster anggota yang dikonfigurasi dengan jendela pemeliharaan terencana.

Eksekusi pembaruan mendukung dua opsi untuk urutan peningkatan kluster:

• Satu per satu: Jika Anda tidak peduli tentang mengontrol urutan peningkatan kluster, one-by-one berikan pendekatan sederhana untuk meningkatkan semua kluster anggota armada secara berurutan satu per satu.
• Mengontrol urutan kluster menggunakan grup dan tahap pembaruan: Jika Anda ingin mengontrol urutan peningkatan kluster, Anda dapat menyusun kluster anggota dalam grup pembaruan dan tahap pembaruan. Anda dapat menyimpan urutan ini sebagai templat dalam bentuk strategi pembaruan. Anda dapat membuat eksekusi pembaruan nanti menggunakan strategi pembaruan alih-alih menentukan urutan setiap kali Anda perlu membuat eksekusi pembaruan.

Memperbarui semua kluster satu per satu

Portal Azure

1. Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.

2. Dari menu layanan, di bawah Pengaturan, pilih Pembaruan>multi-kluster Buat eksekusi.

3. Masukkan nama untuk eksekusi pembaruan, lalu pilih Satu per satu untuk jenis peningkatan.

   

4. Pilih salah satu opsi berikut untuk cakupan Peningkatan:

   • Versi Kubernetes untuk sarana kontrol dan kumpulan simpul
   • Versi Kubernetes hanya untuk sarana kontrol kluster
   • Hanya versi gambar node

5. Pilih salah satu opsi berikut untuk gambar Node:

   • Gambar terbaru: Memperbarui setiap kluster AKS dalam pembaruan yang dijalankan ke gambar terbaru yang tersedia untuk kluster tersebut di wilayahnya.
   • Gambar yang konsisten: Karena mungkin eksekusi pembaruan memiliki kluster AKS di beberapa wilayah di mana gambar simpul terbaru yang tersedia dapat berbeda (periksa pelacak rilis untuk informasi lebih lanjut). Eksekusi pembaruan memilih gambar umum terbaru di semua wilayah ini untuk mencapai konsistensi.

   

6. Pilih Buat untuk membuat eksekusi pembaruan.

Azure CLI

1. Buat eksekusi pembaruan menggunakan az fleet updaterun create perintah dengan nilai yang Anda pilih untuk --upgrade-type bendera dan --node-image-selection . Perintah berikut membuat eksekusi pembaruan yang meningkatkan versi Kubernetes untuk sarana kontrol dan kumpulan simpul dan menggunakan gambar node terbaru yang tersedia untuk setiap kluster di wilayahnya.

   Bendera --upgrade-type mendukung nilai berikut:

   • Full meningkatkan versi Kubernetes untuk sarana kontrol dan kumpulan simpul bersama dengan gambar simpul.
   • ControlPlaneOnly hanya meningkatkan versi Kubernetes untuk sarana kontrol kluster.
   • NodeImageOnly hanya meningkatkan gambar simpul.

   Bendera --node-image-selection mendukung nilai berikut:

   • Latest: Memperbarui setiap kluster AKS dalam pembaruan yang dijalankan ke gambar terbaru yang tersedia untuk kluster tersebut di wilayahnya.
   • Consistent: Karena mungkin pembaruan dijalankan untuk memiliki kluster AKS di beberapa wilayah di mana gambar node terbaru yang tersedia dapat berbeda (periksa pelacak rilis untuk informasi lebih lanjut). Eksekusi pembaruan memilih gambar umum terbaru di semua wilayah ini untuk mencapai konsistensi.

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-1 --upgrade-type Full --kubernetes-version 1.26.0 --node-image-selection Latest
   

2. Mulai eksekusi pembaruan menggunakan az fleet updaterun start perintah .

   az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name run-1
   

Saat membuat eksekusi pembaruan, Anda memiliki kemampuan untuk mengontrol cakupan eksekusi pembaruan. Bendera --upgrade-type mendukung nilai berikut:

• ControlPlaneOnly hanya meningkatkan versi Kubernetes untuk sarana kontrol kluster.
• Full meningkatkan versi Kubernetes untuk sarana kontrol dan kumpulan simpul bersama dengan gambar simpul.
• NodeImageOnly hanya meningkatkan gambar simpul.

Selain itu, --node-image-selection bendera mendukung nilai berikut:

• Terbaru: Memperbarui setiap kluster AKS dalam pembaruan yang dijalankan ke gambar terbaru yang tersedia untuk kluster tersebut di wilayahnya.
• Konsisten: Karena mungkin pembaruan dijalankan untuk memiliki kluster AKS di beberapa wilayah di mana gambar node terbaru yang tersedia dapat berbeda (periksa pelacak rilis untuk informasi lebih lanjut). Eksekusi pembaruan memilih gambar umum terbaru di semua wilayah ini untuk mencapai konsistensi.

Memulai eksekusi pembaruan:

Untuk memulai eksekusi pembaruan, jalankan perintah berikut:

az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name <run-name>

Menetapkan kluster untuk memperbarui grup dan tahapan

Memperbarui grup dan tahapan memberikan kontrol lebih besar atas urutan yang dijalankan pembaruan mengikuti saat Anda memperbarui kluster. Dalam tahap pembaruan, pembaruan diterapkan ke semua grup pembaruan yang berbeda secara paralel. Dalam grup pembaruan, kluster anggota diperbarui secara berurutan.

Anda dapat menetapkan kluster anggota ke grup pembaruan tertentu dengan salah satu dari dua cara:

• Tetapkan ke grup saat menambahkan kluster anggota ke armada.
• Tetapkan anggota armada yang ada ke grup pembaruan.

Tetapkan ke grup saat menambahkan kluster anggota ke armada

Portal Azure

1. Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.

2. Dari menu layanan, di bawah Pengaturan, pilih Tambahkan kluster>Anggota.

   

3. Pilih kluster yang ingin Anda tambahkan, lalu pilih Berikutnya: Tinjau + tambahkan.

4. Masukkan nama grup pembaruan yang ingin Anda tetapkan klusternya, lalu pilih Tambahkan.

Azure CLI

• Tetapkan kluster anggota ke grup pembaruan saat menambahkan kluster anggota ke armada menggunakan az fleet member create perintah dengan bendera yang --update-group diatur ke nama grup pembaruan.

  az fleet member create --resource-group $GROUP --fleet-name $FLEET --name member1 --member-cluster-id $AKS_CLUSTER_ID --update-group group-1a
  

Menetapkan anggota armada yang sudah ada ke grup pembaruan

Portal Azure

1. Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.

2. Dari menu layanan, di bawah Pengaturan, pilih Kluster anggota.

3. Pilih kluster atau kluster yang ingin Anda tetapkan ke grup pembaruan, lalu pilih Tetapkan grup pembaruan

   

4. Masukkan nama grup pembaruan yang ingin Anda tetapkan klusternya, lalu pilih Tetapkan.

   

Azure CLI

• Tetapkan anggota armada yang ada ke grup pembaruan menggunakan az fleet member update perintah dengan bendera yang --update-group diatur ke nama grup pembaruan.

  az fleet member update --resource-group $GROUP --fleet-name $FLEET --name member1 --update-group group-1a
  

Catatan

Anggota armada hanya dapat menjadi bagian dari satu grup pembaruan, tetapi grup pembaruan dapat memiliki beberapa anggota armada yang ditetapkan untuk itu. Grup pembaruan itu sendiri bukan jenis sumber daya terpisah. Grup pembaruan hanyalah string yang mewakili referensi dari anggota armada. Jadi, jika semua anggota armada dengan referensi ke grup pembaruan umum dihapus, grup pembaruan tertentu juga akan berhenti ada.

Menentukan eksekusi dan tahapan pembaruan

Anda dapat menentukan eksekusi pembaruan menggunakan tahap pembaruan untuk secara berurutan memesan aplikasi pembaruan ke grup pembaruan yang berbeda. Misalnya, tahap pembaruan pertama mungkin memperbarui kluster anggota lingkungan pengujian, dan tahap pembaruan kedua kemudian akan memperbarui kluster anggota lingkungan produksi. Anda juga dapat menentukan waktu tunggu di antara tahap pembaruan.

Portal Azure

1. Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.

2. Dari menu layanan, di bawah Pengaturan, pilih Pembaruan>multi-kluster Buat eksekusi.

3. Masukkan nama untuk eksekusi pembaruan, lalu pilih Tahapan untuk jenis urutan pembaruan.

   

4. Pilih Buat tahap, lalu masukkan nama untuk tahap dan waktu tunggu di antara tahapan.

   

5. Pilih grup pembaruan yang ingin Anda sertakan dalam tahap ini. Anda juga dapat menentukan urutan grup pembaruan jika Anda ingin memperbaruinya dalam urutan tertentu. Jika sudah selesai, pilih Buat.

   

6. Pilih salah satu opsi berikut untuk cakupan Peningkatan:

   • Versi Kubernetes untuk sarana kontrol dan kumpulan simpul
   • Versi Kubernetes hanya untuk sarana kontrol kluster
   • Hanya versi gambar node

7. Pilih salah satu opsi berikut untuk gambar Node:

   • Gambar terbaru: Memperbarui setiap kluster AKS dalam pembaruan yang dijalankan ke gambar terbaru yang tersedia untuk kluster tersebut di wilayahnya.
   • Gambar yang konsisten: Karena mungkin eksekusi pembaruan memiliki kluster AKS di beberapa wilayah di mana gambar simpul terbaru yang tersedia dapat berbeda (periksa pelacak rilis untuk informasi lebih lanjut). Eksekusi pembaruan memilih gambar umum terbaru di semua wilayah ini untuk mencapai konsistensi.

   

8. Pilih Buat untuk membuat eksekusi pembaruan.

   Menentukan tahapan dan urutannya setiap kali saat membuat eksekusi pembaruan bisa berulang dan rumit. Perbarui strategi menyederhanakan proses ini dengan memungkinkan Anda menyimpan templat untuk eksekusi pembaruan. Untuk informasi selengkapnya, lihat memperbarui pembuatan dan penggunaan strategi.

9. Di menu Pembaruan multi-kluster, pilih eksekusi pembaruan, lalu pilih Mulai.

Azure CLI

1. Buat file JSON untuk menentukan tahapan dan grup untuk eksekusi pembaruan. Berikut adalah contoh input dari file tahapan (example-stages.json):

   {
       "stages": [
           {
               "name": "stage1",
               "groups": [
                   {
                       "name": "group-1a"
                   },
                   {
                       "name": "group-1b"
                   },
                   {
                       "name": "group-1c"
                   }
               ],
               "afterStageWaitInSeconds": 3600
           },
           {
               "name": "stage2",
               "groups": [
                   {
                       "name": "group-2a"
                   },
                   {
                       "name": "group-2b"
                   },
                   {
                       "name": "group-2c"
                   }
               ]
           }
       ]
   }
   

2. Buat eksekusi pembaruan menggunakan az fleet updaterun create perintah dengan bendera yang --stages diatur ke nama file JSON Anda dan nilai yang Anda pilih untuk --upgrade-type bendera dan --node-image-selection . Perintah berikut membuat eksekusi pembaruan yang meningkatkan versi Kubernetes untuk sarana kontrol dan kumpulan simpul dan menggunakan gambar node terbaru yang tersedia untuk setiap kluster di wilayahnya.

   Bendera --upgrade-type mendukung nilai berikut:

   • Full meningkatkan versi Kubernetes untuk sarana kontrol dan kumpulan simpul bersama dengan gambar simpul.
   • ControlPlaneOnly hanya meningkatkan versi Kubernetes untuk sarana kontrol kluster.
   • NodeImageOnly hanya meningkatkan gambar simpul.

   Bendera --node-image-selection mendukung nilai berikut:

   • Latest: Memperbarui setiap kluster AKS dalam pembaruan yang dijalankan ke gambar terbaru yang tersedia untuk kluster tersebut di wilayahnya.
   • Consistent: Karena mungkin pembaruan dijalankan untuk memiliki kluster AKS di beberapa wilayah di mana gambar node terbaru yang tersedia dapat berbeda (periksa pelacak rilis untuk informasi lebih lanjut). Eksekusi pembaruan memilih gambar umum terbaru di semua wilayah ini untuk mencapai konsistensi.

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-1 --upgrade-type Full --kubernetes-version 1.26.0 --node-image-selection Latest --stages example-stages.json
   

3. Mulai eksekusi pembaruan menggunakan az fleet updaterun start perintah .

   az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name run-1
   

Membuat eksekusi pembaruan menggunakan strategi pembaruan

Membuat eksekusi pembaruan mengharuskan Anda menentukan tahapan, grup, urutan setiap kali. Perbarui strategi menyederhanakan proses ini dengan memungkinkan Anda menyimpan templat untuk eksekusi pembaruan.

Catatan

Anda dapat membuat beberapa eksekusi pembaruan dengan nama unik dari strategi pembaruan yang sama.

Anda dapat membuat strategi pembaruan menggunakan salah satu metode berikut:

• Simpan strategi pembaruan saat membuat eksekusi pembaruan menggunakan portal Azure.
• Buat strategi pembaruan baru lalu referensikan saat membuat eksekusi pembaruan.

Menyimpan strategi pembaruan saat membuat eksekusi pembaruan

• Simpan strategi pembaruan saat membuat eksekusi pembaruan di portal Azure:

  

Membuat strategi pembaruan baru dan mereferensikannya saat membuat eksekusi pembaruan

Portal Azure

1. Navigasi ke halaman pembaruan Multi-kluster, lalu pilih Strategi>Buat strategi:

   

2. Konfigurasikan detail strategi pembaruan, lalu pilih Buat.

3. Referensikan strategi pembaruan saat membuat eksekusi pembaruan berikutnya yang baru:

   

Azure CLI

1. Buat strategi pembaruan baru menggunakan az fleet updatestrategy create perintah dengan bendera yang --stages diatur ke nama file JSON Anda.

   az fleet updatestrategy create --resource-group $GROUP --fleet-name $FLEET --name strategy-1 --stages example-stages.json
   

2. Buat eksekusi pembaruan menggunakan az fleet updaterun create perintah dengan bendera yang --update-strategy-name diatur ke nama strategi pembaruan.

   az fleet updaterun create --resource-group $GROUP --fleet-name $FLEET --name run-5 --update-strategy-name strategy-1 --upgrade-type NodeImageOnly --node-image-selection Consistent
   

Mengelola eksekusi pembaruan

Bagian berikut menjelaskan cara mengelola eksekusi pembaruan menggunakan portal Azure dan Azure CLI.

Portal Azure

• Pada halaman Pembaruan multi-kluster sumber daya armada, Anda dapat Memulai eksekusi pembaruan yang berada dalam status Tidak dimulai atau Gagal:

  

• Pada halaman Pembaruan multi-kluster sumber daya armada, Anda dapat Menghentikan eksekusi pembaruan yang sedang berjalan:

  

• Dalam pembaruan apa pun yang dijalankan dalam status Belum Dimulai, Gagal, atau Berjalan, Anda dapat memilih Tahap apa pun dan Melewati peningkatan:

  

  Anda juga dapat melewati peningkatan di tingkat kluster grup pembaruan atau anggota.

Azure CLI

• Anda dapat Memulai eksekusi pembaruan yang berada dalam status Tidak Dimulai atau Gagal menggunakan az fleet updaterun start perintah :

  az fleet updaterun start --resource-group $GROUP --fleet-name $FLEET --name <run-name>
  

• Anda dapat Menghentikan eksekusi pembaruan yang sedang Berjalan menggunakan az fleet updaterun stop perintah :

  az fleet updaterun stop --resource-group $GROUP --fleet-name $FLEET --name <run-name>
  

• Anda dapat melewati tahap pembaruan atau grup dengan menentukannya di --targets bendera menggunakan az fleet updaterun skip perintah :

  az fleet updaterun skip --resource-group $GROUP --fleet-name $FLEET --name <run-name> --targets Group:my-group-name Stage:my-stage-name
  

  Untuk informasi selengkapnya, lihat gambaran umum konseptual tentang status eksekusi pembaruan dan lewati perilaku pada eksekusi/tahap/grup.

Mengotomatiskan eksekusi pembaruan menggunakan profil peningkatan otomatis

Profil peningkatan otomatis digunakan untuk menjalankan eksekusi pembaruan secara otomatis di seluruh kluster anggota ketika versi gambar Kubernetes atau simpul baru tersedia.

Untuk informasi selengkapnya tentang mengonfigurasi profil peningkatan otomatis, lihat mengotomatiskan peningkatan kubernetes dan gambar simpul menggunakan Azure Kubernetes Fleet Manager.

Untuk informasi selengkapnya, lihat gambaran umum konseptual tentang status eksekusi pembaruan dan lewati perilaku pada eksekusi/tahap/grup.

Langkah berikutnya

Pelajari selengkapnya tentang Azure Kubernetes Fleet Manager.