Memigrasikan instans pratinjau Azure Kubernetes Fleet Manager ke status yang didukung

Selama tahap pratinjau Azure Kubernetes Fleet Manager (Kubernetes Fleet), perubahan API definisi sumber daya kustom internal (CRD) dilakukan yang berdampak pada sejumlah kecil instans Armada Kubernetes yang dibuat selama pratinjau publik layanan.

Microsoft memberi tahu pengguna Kubernetes Fleet yang terpengaruh yang dapat menggunakan artikel ini untuk membantu mengidentifikasi instans Armada Kubernetes yang terpengaruh oleh perubahan tersebut.

Perubahan API Definisi Sumber Daya Kustom (CRD) Kubernetes Fleet ditampilkan dalam tabel.

Definisi API lama (tidak didukung)	Definisi API baru (didukung)
memberclusters.fleet.azure.com/v1alpha1	memberclusters.cluster.kubernetes-fleet.io/v1
internalmemberclusters.fleet.azure.com/v1alpha1	internalmemberclusters.cluster.kubernetes-fleet.io/v1

Pada Maret 2025, definisi API lama tidak lagi menerima dukungan atau pembaruan dan akan dihapus dari penyebaran platform.

Administrator dengan instans Kubernetes Fleet yang terpengaruh perlu membuat instans Kubernetes Fleet baru dan mentransfer kluster anggota secara manual. Ini adalah aktivitas satu kali.

Prasyarat

• Pengguna yang melakukan aktivitas ini harus diberi Azure Kubernetes Fleet Manager RBAC Cluster Admin peran ID Entra.

• Anda memerlukan Azure CLI versi 2.70.0 atau yang lebih baru terinstal. Untuk menginstal atau meningkatkan, lihat Menginstal Azure CLI.

• Anda memerlukan fleet ekstensi Azure CLI versi 1.5.0 atau yang lebih baru, yang dapat Anda instal dengan menjalankan perintah berikut:

  az extension add --name fleet
  

  Jalankan perintah berikut untuk memperbarui ke versi terbaru ekstensi yang dirilis:

  az extension update --name fleet
  

Mengidentifikasi instans yang terpengaruh

1. Atur langganan Azure yang benar. Jika Anda menerima pemberitahuan dari Microsoft, pemberitahuan tersebut berisi satu atau beberapa ID langganan yang harus Anda gunakan.

   az account set \
       --subscription <subscription-id>
   

2. Temukan semua instans Kubernetes Fleet yang Anda miliki dalam langganan.

   az resource list \
       --resource-type 'Microsoft.ContainerService/fleets'
   

   Jika Anda memiliki beberapa instans Armada Kubernetes yang disebarkan, Anda dapat memfilter ke instans yang dibuat pada tahun 2022 atau 2023 yang mungkin terpengaruh. Contoh pada tahun 2024 tidak terpengaruh.

   az resource list \
       --resource-type 'Microsoft.ContainerService/fleets' \
       --query "[?contains(createdTime, '2023') || contains(createdTime, '2022')]"
   

   Jika kueri di atas mengembalikan instans yang cocok, tentukan apakah instans menggunakan API CRD Kubernetes yang dihentikan seperti yang dijelaskan pada langkah berikutnya.

3. Unduh kredensial Kubernetes untuk kluster hub Armada Kubernetes.

   az fleet get-credentials \
       --resource-group <resource-group> \
       --name <fleet-name>
   

4. Memeriksa API Kubernetes dari kluster hub Kubernetes Fleet untuk memeriksa apakah versi CRD lama telah diterapkan.

   kubectl get crd memberclusters.fleet.azure.com
   kubectl get crd internalmemberclusters.fleet.azure.com
   

   Jika kedua kueri mengembalikan Error from server (NotFound) customresourcedefinitions.apiextensions.k8s.io, maka instans Armada Kubernetes yang dipilih tidak terpengaruh dan tidak diperlukan tindakan lebih lanjut.

   Jika ada instans yang terpengaruh, lihat bagian berikutnya untuk langkah-langkah remediasi.

Memulihkan instans yang terpengaruh

Setelah Anda mengidentifikasi instans Kubernetes Fleet yang terpengaruh, Anda harus mengambil langkah-langkah berikut.

1. Dokumentasikan setiap eksekusi pembaruan dan aturan penempatan sumber daya kluster yang ditentukan pada instans Armada Kube yang terpengaruh.
2. Hapus semua kluster anggota dari instans Kubernetes Fleet yang terpengaruh.
3. Buat instans Kubernetes Fleet Manager baru dan kaitkan kluster anggota sesuai kebutuhan.
4. Terapkan kembali dan validasi konfigurasi apa pun yang Anda catat dari instans Armada Kubernetes lama.
5. Hapus instans Kubernetes Fleet lama.