#Обновление кластера

В этом руководстве объясняется, как обновлять кластеры Kubernetes, управляемые с помощью Cluster API, с минимальным временем простоя, сохраняя при этом стабильность и целостность данных.

#Обзор

Обновление кластера включает несколько компонентов и следует структурированному подходу для обеспечения надежности системы:

• Обновление контрольной плоскости: обновление компонентов контрольной плоскости Kubernetes и базовой инфраструктуры
• Обновление рабочих узлов: обновление рабочих узлов с новыми образами машин и версиями Kubernetes
• Обновления инфраструктуры: изменение спецификаций виртуальных машин, хранилища и сетевых конфигураций

Cluster API оркестрирует декларативные rolling updates с встроенными механизмами безопасности.

#Обновление контрольной плоскости

Обновление контрольной плоскости включает обновление Kubernetes API server, etcd, scheduler и controller manager, а также базовой инфраструктуры виртуальных машин.

#Обновление образов инфраструктуры

Обновление базовых образов машин для узлов контрольной плоскости обеспечивает получение патчей безопасности, улучшение производительности и обновление системных компонентов.

#Процедура

1. Создайте обновлённый шаблон машины

   Скопируйте существующий DCSMachineTemplate, на который ссылается KubeadmControlPlane, и измените необходимые спецификации:

   kubectl get dcsmachinetemplate <current-template-name> -n cpaas-system -o yaml > new-cp-template.yaml

2. Измените спецификации шаблона

   Отредактируйте новый шаблон:

   • Установите metadata.name в <new-template-name>
   • Обновите по необходимости:
     • spec.template.spec.vmTemplateName
     • spec.template.spec.dcsMachineCpuSpec.quantity
     • spec.template.spec.dcsMachineMemorySpec.quantity
     • spec.template.spec.dcsMachineDiskSpec
     • и др.

3. Примените обновлённый шаблон

   Примените новый шаблон машины:

   kubectl apply -f new-cp-template.yaml -n cpaas-system

4. Обновите ссылку контрольной плоскости

   Измените ресурс KubeadmControlPlane, чтобы он ссылался на новый шаблон:

   kubectl patch kubeadmcontrolplane <kcp-name> -n cpaas-system --type='merge' -p='{"spec":{"machineTemplate":{"infrastructureRef":{"name":"<new-template-name>"}}}}'

5. Отслеживайте rolling update

   Контрольная плоскость автоматически выполнит rolling update:

   kubectl get kubeadmcontrolplane <kcp-name> -n cpaas-system -w
   kubectl get machines -n cpaas-system -l cluster.x-k8s.io/control-plane

#Обновление версии Kubernetes

Обновление версии Kubernetes включает обновление программного обеспечения контрольной плоскости и поддерживающих образов виртуальных машин.

#Требования

• Проверьте совместимость целевой версии Kubernetes с существующими рабочими нагрузками
• Убедитесь, что шаблон VM поддерживает целевую версию Kubernetes. См. OS Support Matrix для сопоставления версий.
• Ознакомьтесь с путём обновления Kubernetes и политикой version skew

#Процедура

1. Обновите ссылку на шаблон VM

   Обновите spec.template.spec.vmTemplateName в используемом DCSMachineTemplate. Новый шаблон VM должен соответствовать целевой версии Kubernetes.

2. Обновите версию контрольной плоскости

   Измените поле spec.version в ресурсе KubeadmControlPlane (обязательно). При необходимости скорректируйте связанные поля (например, стратегию rollout, тайм-ауты drain/deletion или ссылку на инфраструктурный шаблон) для соответствия новой версии и политике обновления.

3. Проверьте прогресс обновления

   Отслеживайте процесс rolling update:

   # Проверка статуса контрольной плоскости
   kubectl get kubeadmcontrolplane <kcp-name> -n cpaas-system
   
   # Мониторинг отдельных машин
   kubectl get machines -n cpaas-system -l cluster.x-k8s.io/control-plane
   
   # Проверка состояния кластера
   kubectl get nodes

#Обновление рабочих узлов

Обновление рабочих узлов управляется через ресурсы MachineDeployment.

#Дополнительные ресурсы

• Документация по обновлению Cluster API
• Политика version skew Kubernetes