#Обновление

#Матрица совместимости

В таблице ниже перечислены поддерживаемые версии Alauda Streaming Service for Kafka и его ключевых компонентов:

#Предварительные требования

Перед началом обновления убедитесь в следующем:

1. Совместимость версий: Текущая версия входит в поддерживаемый путь обновления.
2. Состояние компонентов: Экземпляры Kafka находятся в состоянии Ready.
3. Наличие ресурсов: В кластере достаточно ресурсов для поддержки процесса обновления.
4. Проверка режима KRaft: Убедитесь, что у всех экземпляров rdskafka spec.mode установлен в KRaft.
   • Можно использовать следующую команду для проверки режима всех экземпляров Kafka:

     kubectl get rdskafka -A -o custom-columns="NAME:.metadata.name,NAMESPACE:.metadata.namespace,MODE:.spec.mode,PHASE:.status.phase"
   • Если какой-либо экземпляр не находится в режиме KRaft, необходимо перенести его в режим KRaft с помощью оператора v4.1.x перед обновлением до v4.2.x.
   • Оператор v4.2.x не поддерживает режим ZooKeeper и не выполняет миграцию из ZooKeeper в KRaft.
   • План миграции из режима ZooKeeper в режим KRaft доступен (мигрировать в KRaft).

Сведения об изменениях для конкретных версий, новых возможностях и устаревших функциях см. в 📝 Примечания к выпуску.

#Рекомендации по пути обновления

#Последовательное обновление (рекомендуется)

• Описание: Выполняйте обновление поэтапно через последовательные minor-версии.
• Пример: 4.1.x → 4.2.x

#Обновление на уровне patch

• Описание: Обновления между любыми patch-версиями в рамках одной minor-версии полностью совместимы и могут выполняться напрямую.
• Пример: 4.1.0 → 4.1.x

#Согласование версий Kafka

• Описание: Убедитесь, что обновления версии Kafka соответствуют матрице совместимости оператора.
• Пример:
  • Alauda Streaming Service for Kafka 4.2.x поддерживает Kafka 4.1.2.
  • Alauda Streaming Service for Kafka 4.1.x поддерживает Kafka 3.8.1 или Kafka 2.8.2 (with plugin).

#Особое примечание для обновления до v4.2.x

• Требование режима KRaft: Все экземпляры должны находиться в режиме KRaft перед обновлением до v4.2.x.
• Удаление плагина Kafka 2: Экземпляры Kafka 2.x и сборка Alauda для плагина Kafka 2 не поддерживаются в v4.2.x.
• Путь миграции: Если у вас есть экземпляры в режиме ZooKeeper:
  1. Оставайтесь на операторе v4.1.x
  2. Мигрируйте все экземпляры в режим KRaft с помощью процедуры миграции
  3. Убедитесь, что все экземпляры успешно работают в режиме KRaft
  4. Обновите оператор до v4.2.x
• Нет отката к ZooKeeper: После миграции в режим KRaft откат обратно в режим ZooKeeper не поддерживается.

#Стратегия обновления

Alauda Streaming Service for Kafka будет выполнять обновления в соответствии с настроенной стратегией обновления:

• Автоматически: Автоматические обновления запускаются немедленно после обнаружения новых версий компонентов.
• Вручную: Перед началом процесса обновления требуется ручное подтверждение.