Kullanımdan Kalkan API Sürümlerinden Göçmek

Neden önemli

Her Kubernetes küçük sürümü API sürümlerini emekli eder ve kümeler sonunda eskileri düpedüz reddeder. Eski rehberlerden kopya bildirimler artık sunulmayan sürümleri taşır ve arıza en kötü anda düz ret olarak gelir: yükseltmede, geri yüklemede veya saat işleyen sınav görevinde.

Kavramlar

Eskime uyarır, kaldırma reddeder: API sunucusu eski sürümlerde uyarı basar ama sunmaya devam eder; sonraki sürümler tümden kaldırır. kubectl apply --dry-run=server gerçek kümene karşı uyarıları yüzeye çıkarır. Sürüm notları küçük sürüm başına kaldırmaları listeler; sınav ünlüleri bilmeni bekler (Job ve CronJoblar için batch v1, autoscaling v2, PodDisruptionBudget için policy v1), gerisini şema okuyarak çevirirsin.

Dönüşüm mekaniktir: apiVersion değiştir, kubectl explain ile yeni sürümde yeniden adlandırılmış veya yapılandırılmış alanları uyarla, dry-run yap, farkı gör, uygula. Depolama taşıması (kümenin saklanan nesneleri yeniden yazması) yükseltmelerde ayrı olur, yöneticilerin işidir; bildirimlerin sunulan sürümü konuşması yeter.

Uygulamalı örnek

Emekli batch sürümü konuşan eski CronJob, sakince çevrilir:

# bul
grep -rn "batch/v1beta1" manifests/     # şüpheli
# yerine geçen şekli kümenin kendisinden oku
kubectl explain cronjob.spec --api-version=batch/v1 | head -30
# çevir: apiVersion batch/v1, jobTemplate şekilde aynı,
# zamanlama dokunulmaz, sonra yeni dosyayı doğrula
kubectl apply --dry-run=server -f cronjob.yaml
kubectl diff -f cronjob.yaml || true
kubectl apply -f cronjob.yaml
kubectl get cronjob nightly-report -o yaml | grep apiVersion

Kümenin kendi explain çıktısı göç rehberidir: yeni sürümde var olan alanlar yasaldır, olmayanlar yeniden yazım listesidir.

Sınav notları

Sunum uyarıları stderr ve denetim loglarında belirir, uygulama arızası olarak değil: sessizlik onay değildir. Farklı kümeler farklı sürümler sunar; aynı bildirim bir kümede göçer diğerinde kırılır: hep hedefe karşı doğrula. Ve CRDler yerleşiklerdışı bağımsız sürümlenir: onlar için Kubernetes sürüm notlarına değil işleticinin belgelerine bak.