Оновлення на місці

Команда istioctl upgrade виконує оновлення Istio.

Команда оновлення також може виконувати пониження версії Istio.

Ознайомтеся з довідкою з оновлення istioctl для всіх параметрів, наданих командою istioctl upgrade.

Передумови для оновлення

Перед початком процесу оновлення перевірте наступні вимоги:

• Встановлена версія Istio не повинна бути старшою на більше ніж одну мінорну версію, ніж версія оновлення. Наприклад, версія 1.6.0 або новіша потрібна перед початком процесу оновлення до 1.7.x.

• Ваша установка Istio була виконана за допомогою istioctl.

Кроки для оновлення

Команди в цьому розділі слід виконувати за допомогою нової версії istioctl, яку можна знайти в теці bin/ завантаженого пакета.

1. Завантажте новий реліз Istio та перейдіть у теку нового релізу.

2. Переконайтеся, що ваша конфігурація Kubernetes вказує на кластер для оновлення:

   $ kubectl config view

3. Переконайтеся, що оновлення сумісне з вашим середовищем.

   $ istioctl x precheck
   ✔ No issues found when checking the cluster. Istio is safe to install or upgrade!
   To get started, check out https://istio.io/latest/docs/setup/getting-started/

4. Розпочніть оновлення, виконавши цю команду:

   $ istioctl upgrade

   Якщо ви встановили Istio за допомогою прапорців --set, переконайтеся, що ви передаєте ті ж прапорці --set для оновлення, інакше налаштування, виконані за допомогою --set, будуть скасовані. Для операційного використання рекомендується використовувати файл конфігурації замість --set.

   Якщо ви пропустите прапорець -f, Istio буде оновлено за допомогою стандартного профілю.

   Після виконання кількох перевірок, istioctl попросить вас підтвердити, чи слід продовжити.

5. istioctl оновить панель управління та шлюзи Istio до нової версії та покаже статус завершення.

6. Після завершення оновлення командою istioctl ви повинні вручну оновити панель даних Istio, перезапустивши будь-які podʼи з sidecar контейнерами Istio:

   $ kubectl rollout restart deployment

Примітки до пониження версії

Перед початком процесу пониження версії перевірте наступні вимоги:

• Ваша установка Istio була виконана за допомогою istioctl.

• Версія Istio, до якої ви плануєте понизити версію, не повинна бути старшою на більше ніж одну мінорну версію, ніж встановлена версія Istio. Наприклад, ви можете знизити версію Istio 1.7.x до версії не нижчої за 1.6.0.

• пониження версії має бути виконано за допомогою версії бінарного файлу istioctl, яка відповідає версії Istio, до якої ви плануєте знизити версію. Наприклад, якщо ви понижуєте версію з Istio 1.7 до 1.6.5, використовуйте istioctl версії 1.6.5.

Кроки для пониження версії до нижчої версії Istio

Ви можете використовувати istioctl upgrade для пониження версії до нижчої версії Istio. Кроки ідентичні процесу оновлення, описаному в попередньому розділі, тільки з використанням бінарного файлу istioctl, що відповідає нижчій версії (наприклад, 1.6.5). Після завершення, Istio буде відновлено до попередньо встановленої версії.

Як альтернатива, можна використовувати istioctl install для встановлення старішої версії панелі управління Istio.