Перейти к содержанию

Политика версионирования WAF‑ноды

Политика описывает способ версионирования артефактов WAF‑ноды Валарм для разных платформ: пакеты Linux, Docker‑контейнеры, чарты Helm и т.д. Вы можете использовать этот документ при выборе версии для первой установки и для планирования обновления установленных пакетов.

Артефакт

Артефакт — результат разработки, который используется для установки WAF‑ноды на платформу. Например: Linux‑пакеты, модули Kong API, Docker‑контейнеры и другие.

Список версий

Версия WAF‑ноды Дата выхода Окончание поддержки
2.16 и ниже Июль 2021
2.18 Февраль 2021 Ноябрь 2021
3.0 Июль 2021 Январь 2022
3.2 Август 2021
3.4 Октябрь 2021

Формат версий

Версии артефактов WAF‑ноды имеют следующий формат:

<MAJOR_VERSION>.<MINOR_VERSION>.<PATCH_VERSION>[-<BUILD_NUMBER>]
Параметр Описание Средняя частота обновления
<MAJOR_VERSION> Мажорная версия WAF‑ноды:
  • Крупная переработка компонентов
  • Несовместимые изменения
Начальное значение — 2. Значение увеличивается на 1, например: 2.14.0, 3.1.0.
Обновление не ожидается
<MINOR_VERSION> Минорная версия WAF‑ноды:
  • Новые возможности продукта
  • Исправленные крупные ошибки
  • Другие совместимые изменения
Значение увеличивается на 2, например: 2.12, 2.14.
1 раз в квартал
<PATCH_VERSION> Версия патча WAF‑ноды:
  • Исправленные мелкие ошибки
  • Новые возможности, добавленные по специальному запросу
Начальное значение — 0. Значение увеличивается на 1, например: 2.14.0, 2.14.1.
1 раз в месяц
<BUILD_NUMBER> (опционально) Версия сборки WAF‑ноды. Присваивается платформой для сборки пакетов автоматически. Если пакеты собираются вручную, значение не присваивается.
Значение увеличивается на 1, например: 2.14.0-1, 2.14.0-2. Если первая сборка завершилась с ошибкой, сборка выполняется еще раз и значение увеличивается.
По мере обновления <PATCH_VERSION>

В зависимости от формы установки WAF‑ноды, мы рекомендуем использовать разный формат версии пакетов и образов при скачивании:

  • <MAJOR_VERSION>.<MINOR_VERSION> при скачивании Linux‑пакетов

  • <MAJOR_VERSION>.<MINOR_VERSION>.<PATCH_VERSION>[-<BUILD_NUMBER>] при скачивании Docker‑образов, облачных образов и Helm‑чарта

    При скачивании Docker‑образов Валарм, вы также можете указать версию WAF‑ноды в формате <MAJOR_VERSION>.<MINOR_VERSION>. Установленная минорная версия будет содержать изменения из последней доступной версии патча. Поведение WAF‑ноды может меняться с каждым запуском одной и той же версии образа в формате <MAJOR_VERSION>.<MINOR_VERSION>, так как при следующем запуске минорная версия может содержать изменения из последней доступной версии патча, которые не были доступны при предыдущем запуске образа.

Версии пакетов WAF‑ноды в рамках одного артефакта могут отличаться. Например, обновление может требоваться только для одного пакета, в таком случае для остальных пакетов сохраняется предыдущая версия.

Поддержка версий

Валарм поддерживает только 3 последние мажорные или минорные версии WAF‑ноды следующим образом:

  • Последняя версия (например, 3.2): открытый доступ к скачиванию, исправление ошибок, обновление сторонних компонентов при обнаружении уязвимостей. Возможно добавление новых возможностей после соответствующего запроса.

  • Предыдущая версия (например, 3.0): открытый доступ к скачиванию, исправление ошибок.

  • Третья доступная версия (например, 2.18): открытый доступ к скачиванию, исправление ошибок в течение 3 месяцев после релиза последней версии. Через 3 месяца поддержка прекращается.

При первой установке WAF‑ноды, рекомендуется использовать последнюю доступную версию. При установке дополнительной WAF‑ноды в окружение с уже установленными WAF‑нодами, рекомендуется использовать одинаковые мажорную и минорную версии во всех установках для полной совместимости.

Обновление версии

Предполагается, что вы используете последнюю доступную версию WAF‑ноды при установке, обновлении или настройке продукта. Инструкции для WAF‑ноды описывают команды, которые автоматически устанавливают последнюю доступную версию патча и сборки.

Уведомление о новой версии

Валарм публикует информацию о новых мажорных и минорных версиях в следующих источниках:

Также, информация о новых доступных мажорных, минорных версиях и версиях патчей отображается в Консоли управления Валарм → Ноды для обычных нод. Рядом с каждым пакетом отображается статус Обновлено или версии доступных обновлений. Например, если установлены пакеты последних версий:

Карточка ноды

Процедура обновления

Вместе с выпуском новых мажорных и минорных версий WAF‑ноды, публикуются инструкции по установке новой версии и по обновлению существующих артефактов. Способы обновления артефактов различаются. Чтобы обновить версии артефактов, используйте соответствующие инструкции из раздела Обновление и миграция.