Вам треба мати кластер Kubernetes, а також інструмент командного рядка kubectl має бути налаштований для роботи з вашим кластером. Рекомендується виконувати ці настанови у кластері, що має щонайменше два вузли, які не виконують роль вузлів управління. Якщо у вас немає кластера, ви можете створити його, за допомогою minikube або використовувати одну з цих пісочниць:
Вам потрібен наявний Deployment. Якщо у вас його немає, створіть Deployment nginx з [Запуск застосунку без збереження стану за допомогою Deployment](/docs/tasks/run-application/run-stateless-application-deployment/): ```shell kubectl apply -f https://k8s.io/examples/application/deployment.yaml ``` Перевірте, що Deployment має два Podʼи: ```shell kubectl get deployment nginx-deployment ``` Вивід схожий на: ```none NAME READY UP-TO-DATE AVAILABLE AGE nginx-deployment 2/2 2 2 10s ``` ## Виконання поступового оновлення {#performing-a-rolling-update} Будь-яка зміна в полі `.spec.template` Deployment запускає поступове оновлення. Kubernetes створює нові Podʼи з оновленою конфігурацією та поступово завершує старі Podʼи. ### Оновлення за допомогою `kubectl apply` {#updating-with-kubectl-apply} Ви можете запустити поступове оновлення, редагуючи маніфест Deployment і застосовуючи зміни. Цей підхід добре працює, якщо ви зберігаєте маніфести у системі контролю версій. Експортуйте поточний Deployment у локальний файл: ```shell 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`. Перед застосуванням порівняйте ваші локальні зміни зі станом кластера: ```shell kubectl diff -f /tmp/nginx-deployment.yaml ``` Вивід схожий на: ```none 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 ``` Застосуйте оновлений маніфест: ```shell kubectl apply -f /tmp/nginx-deployment.yaml ``` ### Оновлення лише образу контейнера {#updating-only-the-container-image} Щоб оновити образ контейнера без редагування файлу маніфесту, використовуйте `kubectl set image`: ```shell kubectl set image deployment/nginx-deployment nginx=nginx:1.16.1 ``` Вивід схожий на: ```none deployment.apps/nginx-deployment image updated ``` Перевірте, що образ було оновлено: ```shell kubectl get deployment nginx-deployment -o jsonpath='{.spec.template.spec.containers[0].image}' ``` Вивід схожий на: ```none nginx:1.16.1 ``` ## Моніторинг прогресу оновлення {#monitoring-rollout-progress} Використовуйте `kubectl rollout status`, щоб стежити за прогресом поступового оновлення: ```shell kubectl rollout status deployment/nginx-deployment ``` Вивід схожий на: ```none 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: ```shell kubectl get deployment nginx-deployment ``` Вивід схожий на: ```none NAME READY UP-TO-DATE AVAILABLE AGE nginx-deployment 2/2 2 2 2m ``` ## Призупинення та відновлення поступового оновлення {#pausing-and-resuming-a-rollout} Ви можете призупинити поступове оновлення, щоб перевірити часткове оновлення або обʼєднати кілька змін в одне оновлення. ### Призупинення поступового оновлення {#pausing-a-rollout} ```shell kubectl rollout pause deployment/nginx-deployment ``` Вивід схожий на: ```none deployment.apps/nginx-deployment paused ``` ### Виконання додаткових змін під час призупинення {#making-additional-changes-while-paused} Під час призупинення поступового оновлення ви можете вносити додаткові зміни. Ці зміни не запускають нове оновлення, поки ви не відновите його: ```shell kubectl set image deployment/nginx-deployment nginx=nginx:1.17.0 ```maxUnavailable та maxSurge приймають абсолютне число або відсоток. Kubernetes обчислює відсотки від бажаної кількості реплік, округлюючи вниз для maxUnavailable та округлюючи вгору для maxSurge.CHANGE-CAUSE показує значення анотації kubernetes.io/change-cause на момент кожної ревізії. Ця анотація не встановлюється автоматично, але якщо ви використовуєте автоматизоване рішення для керування Deployment, інструмент, який ви використовуєте, може записати деякий текст у цю анотацію..spec.revisionHistoryLimit у маніфесті Deployment. Встановлення значення 0 повністю вимикає можливість відкату.