Обновление

Информация

• Специальные инструкции для обновления до v24.08.
• Специальные инструкции для обновления до v23.12.
• Специальные инструкции для обновления до v23.06.
• Специальные инструкции для обновления до v23.02.
• Специальные инструкции для обновления до v22.12.
• Специальные инструкции для обновления до v22.08.
• Специальные инструкции для обновления до v22.06.
• Специальные инструкции для обновления до v22.02.

Внимание

Перед обновлением нужно делать резервную копию.

Информация

После обновления и запуска системы начинается процедура миграции в базе данных. Пока миграция выполняется, Web-интерфейс будет недоступен. При большом объеме базы эта процедура может занимать продолжительное время. Отследить момент окончания миграций можно с помощью команды

docker-compose logs -f postgres | grep ready

В выдаче должно быть 2 записи.

См. также: политика совместимости версий.

BGP-анонсы

Если в MITIGATOR настроено анонсирование защищаемых префиксов по BGP, то перед обновлением экземпляра следует отключить BGP-соединение для обновляемого экземпляра в карточке «Локальные параметры BGP» на странице «BGP».

После завершения работ по обновлению экземпляра следует восстановить BGP-подключение.

Обновление изолированного экземпляра

Информация

После обновления включение защиты и визуализация графиков может занять некоторое время. Не включайте защиту вручную, она включится после пролития всех настроек.

  1. Убедитесь в наличии резервной копии, снятой ранее.

  2. Записать в файл .env строку с версией:

    VERSION=vXX.XX.X

    Здесь vXX.XX.X – целевая версия (например: v25.12.1).

  3. Загрузить актуальный Compose-файл:

    wget https://docs.mitigator.ru/vXX.XX/dist/docker-compose.yml -O docker-compose.yml

    Здесь vXX.XX – целевая мажорная версия (например: v25.12).

  4. Совершить вход в хранилище образов со своими учетными данными:

    docker login docker.mitigator.ru

  5. Скачать образы:

    docker-compose pull

  6. Перезапустить все компоненты MITIGATOR:

    docker-compose down && docker-compose up -d
Информация

После запуска обновите вкладку браузера с Web-интерфейсом MITIGATOR с очисткой кэша.

Обновление кластера с общим нерезервированным хранилищем

Информация

После обновления включение защиты и визуализация графиков может занять некоторое время. Не включайте защиту вручную, она включится после пролития всех настроек.

  1. Убедитесь в наличии резервных копий, снятых ранее.

  2. Остановить все экземпляры MITIGATOR:

    docker-compose down

  3. На всех экземплярах записать в файл .env строку с версией:

    VERSION=vXX.XX.X

    Здесь vXX.XX.X – целевая версия (например: v25.12.1).

  4. На всех экземплярах скачать актуальный docker-compose.yml:

    wget https://docs.mitigator.ru/vXX.XX/dist/docker-compose.yml

    Здесь vXX.XX – целевая мажорная версия (например: v25.12).

  5. На всех экземплярах, кроме базового, скачать актуальный файл docker-compose.worker.yml:

    wget https://docs.mitigator.ru/vXX.XX/dist/multi/docker-compose.worker.yml \
   -O docker-compose.worker.yml

  6. На базовом экземпляре включить Postgres:

    docker-compose up -d postgres

  7. Выполнить на всех экземплярах последовательно, начиная с лидера:

    docker-compose up -d
Информация

После запуска обновите вкладку браузера с Web-интерфейсом MITIGATOR с очисткой кэша.

Обновление кластера с внутренним отказоустойчивым хранилищем

Информация

После обновления включение защиты и визуализация графиков может занять некоторое время. Не включайте защиту вручную, она включится после пролития всех настроек.

  1. Убедитесь в наличии резервных копий, снятых ранее.

  2. Остановить все экземпляры MITIGATOR, на которых Postgres работает в режиме standby, после чего остановить экземпляр с Postgres в режиме active:

    docker-compose down

  3. На всех экземплярах записать в файл .env строку с версией:

    VERSION=vXX.XX.X

    Здесь vXX.XX.X – целевая версия (например: v25.12.1).

  4. На всех экземплярах скачать актуальный docker-compose.yml:

    wget https://docs.mitigator.ru/vXX.XX/dist/docker-compose.yml

    Здесь vXX.XX – целевая мажорная версия (например: v25.12).

  5. Включить экземпляр с Postgres в режиме active, после чего включить все экземпляры MITIGATOR, с Postgres в режиме standby:

    docker-compose up -d
Информация

После запуска обновите вкладку браузера с Web-интерфейсом MITIGATOR с очисткой кэша.

Обновление кластера с внешним отказоустойчивым хранилищем

Информация

После обновления включение защиты и визуализация графиков может занять некоторое время. Не включайте защиту вручную, она включится после пролития всех настроек.

Шаги 2, 7 и 14 зависят от фактической организации СУБД на внешнем сервере.

  1. Убедитесь в наличии резервных копий, снятых ранее.

  2. Отключить для всех экземпляров доступ к БД.

  3. На всех экземплярах записать в файл .env строку с версией:

    VERSION=vXX.XX.X

    Здесь vXX.XX.X – целевая версия (например: v25.12.1).

  4. На всех экземплярах скачать актуальный docker-compose.yml:

    wget https://docs.mitigator.ru/vXX.XX/dist/docker-compose.yml

    Здесь vXX.XX – целевая мажорная версия (например: v25.12).

  5. Совершить вход в хранилище образов со своими учетными данными:

    docker login docker.mitigator.ru

  6. Скачать образы:

    docker-compose pull

  7. Убедиться, что на всех экземплярах отключен доступ к БД:

  8. Перезапустить все компоненты MITIGATOR:

    docker-compose down && docker-compose up -d

  9. Выполнить необходимые миграции БД (действия аналогичны выполняемым при первичной настройке postgres), для чего:

  10. Выполнить команду:

    docker-compose create postgres

  11. Скопировать скрипты миграции:

    docker cp $(docker-compose ps -q postgres):/schema schema

  12. Исполнить скрипты при помощи утилиты SHMIG.

  13. Выполнить команду:

    docker-compose rm -sf postgres

  14. Включить доступ к БД для всех экземпляров.

Информация

После запуска обновите вкладку браузера с Web-интерфейсом MITIGATOR с очисткой кэша.