Критические изменения

Предупреждение

Внимание! Перед любым обновлением обязательно изучите этот раздел для вашей целевой версии. Игнорирование критических изменений может привести к потере данных или неработоспособности системы.

О разделе

Этот раздел документации содержит описание необратимых изменений между версиями продукта. Здесь вы найдёте информацию о:

  • Структурных изменениях (формат данных, схема БД, API)

  • Изменениях в составе (добавленные/удалённые компоненты)

  • Критических изменениях функционала

  • Требованиях к миграциям данных

  • Известных проблемах и способах их решения

Примечание

Для каждой версии с критическими изменениями существует отдельная страница с подробным описанием. Список доступных версий находится в конце этого раздела.

Типы изменений между версиями

1. Патч-версии (patch) — минимальный риск

Пример: 0.8.1 → 0.8.2

Характеристики:

  • Содержат только исправления ошибок и уязвимостей

  • Не изменяют структуру данных или API

  • Не требуют миграций

  • Можно обновляться автоматически

Рекомендация: Обновление рекомендуется для получения исправлений безопасности.

2. Минорные версии (minor) — умеренный риск

Пример: 0.8.0 → 0.9.0

Характеристики:

  • Обычно содержат исправления ошибок и новые функции

  • Редко требуют сложных миграций данных

  • Часто можно обновляться автоматически

  • Могут содержать критические изменения (проверяйте документацию!)

Рекомендация: Рекомендуется изучить changelog перед обновлением.

3. Мажорные версии (major) — высокий риск

Пример: 1.2.0 → 2.0.0

Характеристики:

  • Могут содержать изменения структуры данных

  • Часто требуют ручных миграций

  • Могут изменять поведение системы

  • Иногда добавляют/удаляют компоненты

  • Могут изменять требования к инфраструктуре

Рекомендация: Требуют:

  1. Полного изучения изменений в этом разделе

  2. Тестирования на staging-окружении

  3. Планирования времени простоя

  4. Подготовки плана отката

Как работать с этим разделом

Для каждой версии существует отдельная страница с описанием:

  1. Критических изменений (что сломается при обновлении)

  2. Изменений в архитектуре (новые/удалённые компоненты)

  3. Миграций данных (какие преобразования необходимы)

  4. Совместимости (требования к окружению)

Подготовка к обновлению с критическими изменениями

Чек-лист перед обновлением

Перед началом обновления убедитесь, что выполнены все пункты:

  • [ ] Изучен раздел «Критические изменения» для целевой версии

  • [ ] Проверен changelog и сравнена текущая версия с целевой

  • [ ] Создан полный бэкап всех данных и конфигураций

  • [ ] Проверены системные требования новой версии

  • [ ] Изучены изменения схемы базы данных (если применимо)

  • [ ] Проверены модификации API и их влияние на интеграции

  • [ ] Проверены обновления зависимостей и их совместимость

  • [ ] Изучены изменения в требованиях к инфраструктуре

  • [ ] Проверено наличие необходимых инструментов миграции

  • [ ] Запланировано время простоя (если требуется)

  • [ ] Подготовлен план отката на предыдущую версию

  • [ ] Протестировано обновление на staging-окружении

Особое внимание уделяйте

  • Изменениям схемы базы данных — могут потребовать ручной миграции

  • Модификациям API — могут сломать существующие интеграции

  • Обновлениям зависимостей — могут изменить требования к окружению

  • Изменениям в требованиях к инфраструктуре — могут потребовать обновления ОС или других компонентов

Частые сценарии критических изменений

Изменения в базе данных

Предупреждение

Изменения в схеме БД могут привести к потере данных при неправильной миграции!

Типичные изменения:

  • Переименование таблиц/колонок

  • Изменение типов данных

  • Новые обязательные поля

  • Удаление устаревших таблиц

  • Изменение индексов или ограничений

Что делать: Используйте официальные инструменты миграции и следуйте инструкциям для конкретной версии.

Изменения в API

Предупреждение

Изменения в API могут сломать существующие интеграции и скрипты!

Типичные изменения:

  • Удалённые эндпоинты

  • Изменённые форматы запросов/ответов

  • Новые обязательные заголовки или параметры

  • Изменение кодов ответов

  • Обновление версий API

Что делать: Проверьте все интеграции и обновите клиентский код перед обновлением.

Изменения в составе

Предупреждение

Изменения в составе могут потребовать дополнительной настройки или лицензирования!

Типичные изменения:

  • Удалённые микросервисы

  • Новые обязательные компоненты

  • Изменения в лицензировании модулей

  • Переименование сервисов

  • Изменение портов или endpoints

Что делать: Проверьте конфигурацию и обновите все ссылки на изменённые компоненты.

Что делать, если обнаружили проблему?

Опасно

Важно! Если обновление уже начато и вы столкнулись с проблемой, не пытайтесь откатиться без официальных инструкций. Неправильный откат может привести к потере данных!

Пошаговый план действий

  1. Проверьте документацию

    • Изучите раздел «Известные проблемы» для вашей версии

    • Проверьте раздел «Критические изменения» на наличие упоминания проблемы

    • Изучите changelog на предмет известных багов

  2. Если обновление уже начато

    • Не пытайтесь откатиться без официальных инструкций

    • Сохраните все логи ошибок

    • Задокументируйте все выполненные действия

  3. Соберите информацию для поддержки

    • Версия, с которой обновлялись

    • Версия, на которую обновлялись

    • Точное описание проблемы и шаги для воспроизведения

    • Соответствующие логи ошибок (из всех компонентов)

    • Скриншоты (если применимо)

    • Информация о конфигурации системы

  4. Свяжитесь с поддержкой

    • Предоставьте всю собранную информацию

    • Укажите критичность проблемы

    • Опишите влияние на работу системы

Важные предупреждения

Опасно

Критически важно! Некоторые изменения необратимы — после обновления откат может быть невозможен без потери данных. Всегда создавайте полный бэкап перед обновлением!

Ключевые моменты

  1. Необратимость изменений

    • Некоторые миграции данных нельзя откатить

    • Изменения в схеме БД могут быть несовместимы с предыдущими версиями

    • Всегда проверяйте возможность отката в документации версии

  2. Влияние на интеграции

    • Критические изменения могут затрагивать интеграции с другими системами

    • API-изменения могут сломать внешние сервисы

    • Уведомите команды, использующие интеграции, заранее

  3. Время простоя

    • Время простоя при критических обновлениях может быть значительным

    • Планируйте обновление на период минимальной нагрузки

    • Подготовьте уведомления для пользователей

  4. Тестирование

    • Всегда тестируйте обновление в изолированном окружении перед продакшеном

    • Используйте копию продакшн-данных для тестирования

    • Проверяйте все критичные функции после обновления

Примечание

Рекомендуется также ознакомиться с разделом Стратегия обновления для получения дополнительной информации о процессе обновления.