Обновление до v23.12

Процедура обновления на версию v23.12 не отличается от стандартной, но команду docker-compose down следует выполнить с ключом --remove-orphans из-за переименования контейнера.

Тем не менее, в версии v23.12 внесен ряд изменений, требующих выполнения дополнительных действий перед запуском MITIGATOR. К таким изменениям относятся:

  • прекращение поддержки старого формата конфигурационного файла data-plane.conf, существовавшего до версии v20.08.
  • Переименование файла data-plane.conf в dataplane.conf. Совместимость со старым названием сохранена, но рекомендуем обновить название файла.
  • Переименование контейнера data-plane в dataplane.
  • Внесение изменений в логику работы pgfailover.
  • Перенос настроек VPN в файл базовой конфигурации docker-compose.yml.

Поэтому, при обновлении убедитесь, что:

  1. директория data-plane.conf, если она есть, удалена;

    rmdir data-plane.conf
  2. файл data-plane.conf переименован в dataplane.conf;

    mv data-plane.conf dataplane.conf || touch dataplane.conf
  3. настройки в dataplane.conf заданы корректно;

  4. в новом файле базовой конфигурации docker-compose.yml и во всех дополнительных .yml, указанных в переменной COMPOSE_FILE файла .env, название контейнера изменено на dataplane.

    Получить список файлов, указанных в COMPOSE_FILE:

    cat .env | grep COMPOSE_FILE
  5. В переменной COMPOSE_FILE файла .env не указан файл docker-compose.vpn.yml;

  6. В файле docker-compose.failover.yml, если он есть, для сервиса backend задана переменная BACKEND_PGFAILOVER_ADDRESS;

    services:
      backend:
        environment:
          BACKEND_PGFAILOVER_ADDRESS: "${MITIGATOR_VPN_ADDRESS:-localhost}:50052"
  7. В Web-интерфейсе MITIGATOR заново задайте настройки в карточке «Challenge-response аутентификация для HTTPS» на странице «Настройка системы» и в контрмере HCA, если они были заданы ранее.