Обновление глобального кластера
состоит из глобального кластера и одного или нескольких кластеров рабочих нагрузок. Глобальный кластер обязательно должен быть обновлен до любых кластеров рабочих нагрузок.
В этом документе описана процедура обновления глобального кластера.
Если глобальный кластер настроен с решением global DR (Disaster Recovery), строго следуйте процедуре global DR. В противном случае следуйте стандартной процедуре.
Стандартная процедура
Загрузка образов
Скопируйте основной пакет на любой узел плоскости управления глобального кластера. Распакуйте пакет и выполните cd в каталог с распакованным содержимым.
-
Если глобальный кластер использует встроенный реестр, выполните:
-
Если глобальный кластер использует внешний реестр, также необходимо указать адрес реестра:
Если вы планируете выполнить обновление Operator и Cluster Plugin одновременно с обновлением глобального кластера, заранее загрузите соответствующие пакеты в реестр соответствующего кластера. Инструкции по массовой загрузке см. в разделе Загрузить все пакеты одновременно.
Загрузка образов обычно занимает около 2 часов в зависимости от сетевых характеристик и производительности диска.
Если ваша платформа настроена на глобальное аварийное восстановление (DR), помните, что резервный глобальный кластер также требует загрузки образов. Обязательно спланируйте окно обслуживания с учетом этого.
Подробности о подкоманде violet push см. в разделе Загрузка пакетов.
Запуск обновления
После завершения загрузки образов выполните следующую команду, чтобы запустить процесс обновления:
Дождитесь завершения сценария, прежде чем продолжать. Примерно через 10–15 минут кнопка обновления на вкладке Functional Components станет доступной. После этого вы сможете обновить Operator и Cluster Plugin в соответствии со следующими инструкциями по обновлению.
Известная проблема в ACP 4.2.1:
Эта проблема затрагивает только обновления с ACP 4.2.0 до 4.2.1 и будет исправлена в ACP 4.2.2. Она относится только к cluster plugins, а не к Operator.
После выполнения bash upgrade.sh --skip-sync-image, когда кнопка Upgrade станет доступной на вкладке Functional Components, вы можете увидеть, что для cluster plugins, таких как Alauda Container Platform Base, в поле Target отображается более низкая версия.
Требуемое действие: Для этих cluster plugins необходимо вручную изменить значение Target на Do not upgrade. Если этого не сделать, cluster plugins могут быть понижены до более старой версии.
Обновление глобального кластера
- Войдите в Web Console глобального кластера и переключитесь в режим Administrator.
- Перейдите в Clusters > Clusters.
- Нажмите на кластер
global, чтобы открыть его страницу сведений. - Перейдите на вкладку Functional Components.
- Нажмите кнопку Upgrade.
Ознакомьтесь с доступными обновлениями компонентов в диалоговом окне и подтвердите продолжение.
- Если плагин Alauda Container Platform GitOps установлен в глобальном кластере и его pods работают некорректно после обновления, см. Обновление Alauda Container Platform GitOps.
Известная проблема в ACP 4.2.1:
Эта проблема затрагивает только обновления с ACP 4.2.0 до 4.2.1 и будет исправлена в ACP 4.2.2. Она относится только к cluster plugins, а не к Operator.
После завершения обновления на вкладке Functional Components кнопка Upgrade для cluster plugins может по-прежнему выглядеть доступной для нажатия.
НЕ нажимайте кнопку Upgrade для cluster plugins повторно. Если вы нажмете ее, то увидите, что в поле Target для cluster plugins, уже обновленных до новой patch-версии, отображается более низкая версия. Повторное обновление приведет к понижению версии этих cluster plugins.
Установка плагина Alauda Container Platform Cluster Enhancer
Этот шаг нужен только для того, чтобы убедиться, что плагин cluster enhancer установлен. Если вы обнаружили, что этот cluster plugin уже установлен, ничего делать не нужно.
-
Перейдите в раздел Administrator.
-
В левой боковой панели нажмите Marketplace > Cluster Plugins и выберите кластер
global. -
Найдите плагин Alauda Container Platform Cluster Enhancer и нажмите Install.
(При необходимости) Обновление Service Mesh Essentials
Если установлен Service Mesh v1, перед обновлением кластеров рабочих нагрузок обратитесь к документации Alauda Service Mesh Essentials Cluster Plugin.
После обновления
Процедура global DR
Проверка согласованности данных
Выполните обычные процедуры проверки global DR, чтобы убедиться, что данные в резервном глобальном кластере согласованы с основным глобальным кластером.
Если обнаружены несоответствия, не удаляйте плагин синхронизации etcd на следующем шаге и обратитесь в техническую поддержку перед продолжением. Удаление плагина, когда в резервном глобальном кластере отсутствуют данные, которые есть в основном кластере, может привести к некорректному разрешению owner references, а объекты Machine узлов кластера рабочих нагрузок — включая кластеры immutable-OS, где это уничтожает базовую виртуальную машину, — могут быть удалены.
На обоих кластерах выполните следующую команду, чтобы убедиться, что ни один узел Machine не находится в состоянии, отличном от рабочего:
Если такие узлы существуют, обратитесь в техническую поддержку, чтобы устранить проблему, прежде чем продолжить.
Удаление плагина синхронизации etcd
- Откройте Web Console резервного кластера через его IP или VIP.
- Переключитесь в режим Administrator.
- Перейдите в Marketplace > Cluster Plugins.
- УБЕДИТЕСЬ, что вы переключились на кластер
global. - Найдите плагин Alauda Container Platform etcd Synchronizer и выполните Uninstall. Дождитесь завершения удаления.
Загрузка образов
Выполните шаг Загрузка образов как на резервном кластере, так и на основном кластере.
Подробности см. в разделе Загрузка образов в стандартной процедуре.
Обновление резервного кластера
Для выполнения обновления требуется доступ к Web Console резервного кластера.
Перед продолжением убедитесь, что ресурс ProductBase резервного кластера корректно настроен и VIP кластера указан в spec.alternativeURLs.
Если это не так, обновите конфигурацию следующим образом:
На резервном кластере выполните шаги из стандартной процедуры, чтобы завершить обновление.
Обновление основного кластера
После обновления резервного кластера выполните стандартную процедуру на основном кластере.
Переустановка плагина синхронизации etcd
Перед переустановкой убедитесь, что порт 2379 корректно перенаправляется с обоих VIP глобального кластера на их узлы плоскости управления.
Чтобы переустановить:
- Откройте Web Console резервного глобального кластера через его IP или VIP.
- Переключитесь в режим Administrator.
- Перейдите в Marketplace > Cluster Plugins.
- Выберите кластер
global. - Найдите Alauda Container Platform etcd Synchronizer, нажмите Install и укажите требуемые параметры.
Для проверки установки:
Проверка статуса синхронизации
Выполните следующую команду, чтобы проверить статус синхронизации:
Пояснение к выводу:
"LOCAL ETCD missed keys:"– ключи существуют в основном кластере, но отсутствуют в резервном. Часто это устраняется после перезапуска pod."LOCAL ETCD surplus keys:"– ключи существуют в резервном кластере, но отсутствуют в основном. Перед удалением обсудите их с вашей эксплуатационной командой.