Оновлення Deployment без простою

Ця сторінка показує, як оновити працюючий Deployment до нової версії за допомогою поступового оновлення (rolling update). Поступове оновлення поступово замінює старі Podʼи новими, тому ваш застосунок залишається доступним протягом усього процесу.

Цілі

• Запустити поступове оновлення Deployment.
• Моніторинг прогресу оновлення.
• Призупинити та відновити розгортання.
• Налаштувати параметри стратегії поступового оновлення.
• (Якщо потрібно) Відкотити до попередньої версії.

Перш ніж ви розпочнете

Вам треба мати кластер Kubernetes, а також інструмент командного рядка kubectl має бути налаштований для роботи з вашим кластером. Рекомендується виконувати ці настанови у кластері, що має щонайменше два вузли, які не виконують роль вузлів управління. Якщо у вас немає кластера, ви можете створити його, за допомогою minikube або використовувати одну з цих пісочниць:

• iximiuz Labs
• Killercoda
• KodeKloud

Вам потрібен наявний Deployment. Якщо у вас його немає, створіть Deployment nginx з Запуск застосунку без збереження стану за допомогою Deployment:

kubectl apply -f https://k8s.io/examples/application/deployment.yaml

Перевірте, що Deployment має два Podʼи:

kubectl get deployment nginx-deployment

Вивід схожий на:

NAME               READY   UP-TO-DATE   AVAILABLE   AGE
nginx-deployment   2/2     2            2           10s

Виконання поступового оновлення

Будь-яка зміна в полі .spec.template Deployment запускає поступове оновлення. Kubernetes створює нові Podʼи з оновленою конфігурацією та поступово завершує старі Podʼи.

Оновлення за допомогою kubectl apply

Ви можете запустити поступове оновлення, редагуючи маніфест Deployment і застосовуючи зміни. Цей підхід добре працює, якщо ви зберігаєте маніфести у системі контролю версій.

Експортуйте поточний Deployment у локальний файл:

kubectl get deployment nginx-deployment -o yaml > /tmp/nginx-deployment.yaml

Редагуйте /tmp/nginx-deployment.yaml і змініть .spec.template.spec.containers[0].image з nginx:1.14.2 на nginx:1.16.1.

Перед застосуванням порівняйте ваші локальні зміни зі станом кластера:

kubectl diff -f /tmp/nginx-deployment.yaml

Вивід схожий на:

diff -u -N /tmp/LIVE/apps.v1.Deployment.default.nginx-deployment /tmp/MERGED/apps.v1.Deployment.default.nginx-deployment
--- /tmp/LIVE/apps.v1.Deployment...
+++ /tmp/MERGED/apps.v1.Deployment...
@@ -29,7 +29,7 @@
       containers:
-      - image: nginx:1.14.2
+      - image: nginx:1.16.1
         name: nginx

Застосуйте оновлений маніфест:

kubectl apply -f /tmp/nginx-deployment.yaml

Оновлення лише образу контейнера

Щоб оновити образ контейнера без редагування файлу маніфесту, використовуйте kubectl set image:

kubectl set image deployment/nginx-deployment nginx=nginx:1.16.1

Вивід схожий на:

deployment.apps/nginx-deployment image updated

Перевірте, що образ було оновлено:

kubectl get deployment nginx-deployment -o jsonpath='{.spec.template.spec.containers[0].image}'

Вивід схожий на:

nginx:1.16.1

Моніторинг прогресу оновлення

Використовуйте kubectl rollout status, щоб стежити за прогресом поступового оновлення:

kubectl rollout status deployment/nginx-deployment

Вивід схожий на:

Waiting for deployment "nginx-deployment" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "nginx-deployment" rollout to finish: 1 out of 2 new replicas have been updated...
Waiting for deployment "nginx-deployment" rollout to finish: 1 old replicas are pending termination...
deployment "nginx-deployment" successfully rolled out

Після завершення оновлення перевірте Deployment:

kubectl get deployment nginx-deployment

Вивід схожий на:

NAME               READY   UP-TO-DATE   AVAILABLE   AGE
nginx-deployment   2/2     2            2           2m

Призупинення та відновлення поступового оновлення

Ви можете призупинити поступове оновлення, щоб перевірити часткове оновлення або обʼєднати кілька змін в одне оновлення.

Призупинення поступового оновлення

kubectl rollout pause deployment/nginx-deployment

Вивід схожий на:

deployment.apps/nginx-deployment paused

Виконання додаткових змін під час призупинення

Під час призупинення поступового оновлення ви можете вносити додаткові зміни. Ці зміни не запускають нове оновлення, поки ви не відновите його:

kubectl set image deployment/nginx-deployment nginx=nginx:1.17.0

Відновлення поступового оновлення

kubectl rollout resume deployment/nginx-deployment

Вивід схожий на :

deployment.apps/nginx-deployment resumed

Перевірте, що поступове оновлення завершено:

kubectl rollout status deployment/nginx-deployment

Налаштування стратегії поступового оновлення

Deployments підтримують два типи стратегій оновлення:

• RollingUpdate (стандартно): поступово замінює старі Podʼи новими.
• Recreate: спочатку завершує всі наявні Podʼи, а потім створює нові. Це призводить до простою.

Для стратегії RollingUpdate ці параметри контролюють, як Kubernetes виконує оновлення:

Для налаштування цих параметрів використовуйте kubectl patch:

kubectl patch deployment nginx-deployment -p \
  '{"spec":{"strategy":{"rollingUpdate":{"maxUnavailable":"25%","maxSurge":"25%"}}}}'

Ви також можете встановити ці поля в маніфесті Deployment під .spec.strategy.rollingUpdate. Для детальних прикладів дивіться max unavailable та max surge в документації з концепцій Deployment.

Виявлення завислого поступового оновлення

Якщо поступове оновлення не просувається протягом часу, вказаного в .spec.progressDeadlineSeconds (зазвичай: 600 секунд), Kubernetes позначає стан Deployment Progressing як False. Ви можете перевірити цей стан, описавши Deployment:

kubectl describe deployment nginx-deployment

Шукайте стан Progressing у розділі Conditions у виводі. Зависле поступове оновлення зазвичай вказує на те, що нові Podʼи не можуть запуститися. Розділ Events у виводі може допомогти діагностувати проблему.

Повернення до попередньої ревізії

Якщо нова версія викликає проблеми, ви можете повернутися до попередньої ревізії.

Перегляд історії поступового оновлення

kubectl rollout history deployment/nginx-deployment

Вивід схожий на:

deployment.apps/nginx-deployment
REVISION  CHANGE-CAUSE
1         <none>
2         <none>

Повернення до попередньої ревізії

kubectl rollout undo deployment/nginx-deployment

Вивід схожий на:

deployment.apps/nginx-deployment rolled back

Повернення до конкретної ревізії

kubectl rollout undo deployment/nginx-deployment --to-revision=1

Перевірте, що повернення до попередньої ревізії завершено:

kubectl rollout status deployment/nginx-deployment

Очищення

Видаліть Deployment:

kubectl delete deployment nginx-deployment

Що далі

• Дізнайтеся більше про Deployments.
• Дізнайтеся, як масштабувати Deployment вручну.
• Пройдіть завдання з Горизонтального автомасштабування Podʼів.
• Дізнайтеся, як виконати поступове оновлення для DaemonSet.