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

Artikel
12/04/2024

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>
export AKS_CLUSTER_ID=<aks-cluster-resource-id>

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

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.

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.

Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.
Dari menu layanan, di bawah Pengaturan, pilih Pembaruan>multi-kluster Buat eksekusi.
Masukkan nama untuk eksekusi pembaruan, lalu pilih Satu per satu untuk jenis peningkatan.
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
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.
Pilih Buat untuk membuat eksekusi pembaruan.

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
```

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>

Memperbarui kluster menggunakan grup dan tahapan

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. Anda dapat menyimpan urutan ini sebagai templat dalam bentuk strategi pembaruan.

Portal Azure
Azure CLI

Di portal Azure, navigasikan ke sumber daya Azure Kubernetes Fleet Manager Anda.
Dari menu layanan, di bawah Pengaturan, pilih Pembaruan>multi-kluster Buat eksekusi.
Masukkan nama untuk eksekusi pembaruan, lalu pilih Tahapan untuk jenis urutan pembaruan.
Pilih Buat tahap, lalu masukkan nama untuk tahap dan waktu tunggu di antara tahapan.
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.
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
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.
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.
Di menu Pembaruan multi-kluster, pilih eksekusi pembaruan, lalu pilih Mulai.

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"
                }
            ]
        }
    ]
}

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
```

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:

Menyimpan strategi pembaruan saat membuat eksekusi pembaruan

Simpan strategi pembaruan saat membuat eksekusi pembaruan di portal Azure:

Mengelola eksekusi pembaruan

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

Portal Azure
Azure CLI

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.

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

Cara: Secara otomatis meningkatkan beberapa kluster menggunakan Azure Kubernetes Fleet Manager.

Bagikan melalui