/
Особенности обновления до версии 3.18

Особенности обновления до версии 3.18

При переходе на платформу версии 3.18 обратите внимание на следующие изменения.

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

Пересоздание баз данных PostgreSQL

В версии 3.18 образы PostgreSQL обновлены (15.0 → 15.14) и переведены на базовый образ Astra Linux. Из-за этого в процессе обновления базы данных автоматически выгружаются (pg_dump) и пересоздаются на новом образе. Это касается следующих баз:

  • postgres-visiology

  • keycloak

  • onec-dcc и onec-etl (1С-коннектор)

  • smart-forms

На больших объёмах данных эта операция увеличивает время обновления и время недоступности платформы. Перед запуском убедитесь, что выполнен полный бэкап.

Изменилась команда установки

Команда запуска установки изменилась - добавлено создание каталога /var/lib/visiology/v3/python-service/customlibs. Используйте актуальную команду из раздела Установка платформы.

Обновление при использовании внешнего Keycloak

Если используется внешний Keycloak - нужно передать в команду обновления Client secret от Realm Admin

  1. Откройте в браузере адрес административной консоли Keycloak.

  2. Войдите под учётной записью администратора

  3. В левом верхнем углу нажмите на выпадающий список realm-ов (по умолчанию там может быть выбран master) и выберите realm, в котором находится клиент — visiology.

  4. В левом меню перейдите в раздел Clients («Клиенты»).

  5. В списке клиентов найдите и откройте клиент visiology_realm_admin (можно воспользоваться строкой поиска над списком).

  6. Перейдите на вкладку Credentials («Учётные данные»).

  7. В поле Client secret нажмите на иконку копирования (или кнопку Copy to clipboard), чтобы скопировать секретный ключ.

  8. Вставьте скопированное значение в переменную (-e KC_VISIOLOGY_REALM_ADMIN_SECRET=<ключ>).

docker run --rm -it \ --name update-container \ -v /var/run/docker.sock:/var/run/docker/docker.sock \ -v /docker-volume:/docker-volume \ -v /var/lib/visiology:/mnt/volume \ -v /etc/machine-id:/etc/machine-id:ro \ -e KC_VISIOLOGY_REALM_ADMIN_SECRET=<admin_secret> \ cr.yandex/crpe1mi33uplrq7coc9d/visiology/release/update:3.18 \ "$(id -u):$(id -g)" | \ tee /var/lib/visiology/logs/update-log-$(date +%Y-%m-%d-%H-%M-%z).txt

Новые сервисы

MCP-сервер

Добавлен новый сервис mcp-server. По умолчанию он выключен (WITH_MCP_SERVER=false в config.env). Для использования сервис нужно включить вручную.

Сервис Python-виджетов

Добавлен новый сервис python-service для выполнения Python-виджетов. При обновлении создаётся каталог ${PERSISTENT_STORAGE_FOLDER}/python-service/customlibs (по умолчанию /var/lib/visiology/v3/python-service/customlibs) для пользовательских Python-библиотек.

Обновление редакции Cortex Pro: модель V1 → V2

Обновлена модель редакции Cortex Pro: VisiologyGpt-Pro-V1 → VisiologyGpt-Pro-V2 (Qwen3.6-27B-FP8), vLLM обновлён с v0.16.0 до v0.20.1. Агенты стали точнее интерпретировать запросы, глубже анализировать данные и формировать более релевантные ответы.

При обновлении автоматически:

  • меняется значение AI_DEFAULT_MODEL на /models/VisiologyGpt-Pro-V2;

  • обновляется AI_VLLM_COMMAND до нового значения по умолчанию (если команда не была изменена вручную; пользовательские отклонения переносятся поверх нового дефолта, кроме --model);

  • создаётся новый том весов модели visiology3_ai-model-pro-v2_data, который наполняется при первом старте стека.

Том весов старой модели V1 не удаляется автоматически — он сохраняется для возможности отката. После проверки работоспособности модели Pro V2 удалите «осиротевший» том (~31 ГБ) вручную:

docker volume rm visiology3_ai-model-pro-v1_data

На стендах без локальных моделей (WITH_LOCAL_MODELS=false) этого тома нет — команда сообщит «no such volume».

Изменение значений по умолчанию для AI

Для Pro (V2):

AI_VLLM_COMMAND="--model /models/VisiologyGpt-Pro-V2 --tensor-parallel-size 1 --max-model-len 131072 --max-num-seqs 5 --gpu-memory-utilization 0.90 --dtype auto --kv-cache-dtype auto --enable-chunked-prefill --enable-prefix-caching --enable-auto-tool-choice --tool-call-parser qwen3_coder --reasoning-parser qwen3"

Для Max (без изменений в этом релизе):

AI_VLLM_COMMAND="--model /models/VisiologyGpt-Max-V1 --tensor-parallel-size 4 --max-model-len 65536 --gpu-memory-utilization 0.85 --kv-cache-dtype fp8 --enable-chunked-prefill --enable-prefix-caching --enable-auto-tool-choice --tool-call-parser hermes"

Если вы настраивали ai-agent на работу с сервером ИИ-моделей вручную через указание IP-адресов в файле /var/lib/visiology/scripts/v3/env-files/ai.env, то после обновления необходимо изменить адрес для новых моделей в полях AI_EMBED_URL и AI_RERANKER_URL.

Обновление инфраструктурных компонентов и переход на Astra Linux

В версии 3.18 базовые образы инфраструктурных компонентов переведены на Astra Linux, а сами компоненты обновлены до новых версий. Основные изменения:

Компонент

Было (3.17)

Стало (3.18)

Компонент

Было (3.17)

Стало (3.18)

Keycloak

26.2.4

26.6.1

PostgreSQL

15.0

15.14

Grafana

12.4.0

13.0.1

Prometheus

v3.8.1

v3.11.3

Loki

3.6.3

3.7.2

Tempo

2.9.0

2.10.5

Promtail

3.6.3

3.6.11

cAdvisor

0.55.0

0.57.0

Node Exporter

v1.10.2

v1.11.1

OpenTelemetry Collector

0.142.0

0.152.0

MinIO

2025-09-07

2025-10-15

vLLM

v0.16.0

v0.20.1

ClickHouse остаётся на версии 25.8.16.34 (как и в 3.17/3.17.1), миграции данных ClickHouse при обновлении до 3.18 не требуется.

Изменились имена образов

В связи с переводом базовых образов на Astra Linux изменились имена (пути в реестре) образов инфраструктурных и AI-компонентов. Хост и префикс реестра cr.yandex/crpe1mi33uplrq7coc9d/visiology/ остались прежними — изменилась только часть пути после него: release/original/… → derived/…. Версии (теги) приведены в таблице выше.

Образы самих сервисов платформы (release/dashboard-service-3, release/dashboard-viewer-3, release/visiology-designer, release/formula-engine, release/data-management-service, release/workspace-service, release/edge, release/ai-agent, release/smart-forms-3, release/backup-service, release/license-server и др.) не переименовывались — у них изменился только тег.

Это важно при установке в закрытом контуре (air-gapped) и при зеркалировании образов в собственный реестр: при предзагрузке используйте новые имена образов.

Инфраструктурные компоненты: release/original/… → derived/astralinux/…

Было (3.17.1)

Стало (3.18)

Было (3.17.1)

Стало (3.18)

release/original/minio

derived/astralinux/minio

release/original/clickhouse-server

derived/astralinux/clickhouse-server

release/original/clickhouse-keeper

derived/astralinux/clickhouse-keeper

release/original/jdbc-bridge

derived/astralinux/jdbc-bridge

release/original/keycloak

derived/astralinux/keycloak

release/original/postgres

derived/astralinux/postgres

release/original/opentelemetry-collector-contrib

derived/astralinux/opentelemetry-collector-contrib

release/original/loki

derived/astralinux/loki

release/original/tempo

derived/astralinux/tempo

release/original/promtail

derived/astralinux/promtail

release/original/grafana

derived/astralinux/grafana

release/original/prometheus

derived/astralinux/prometheus

release/original/cadvisor

derived/astralinux/cadvisor

release/original/node-exporter

derived/astralinux/node-exporter

release/original/etl-db

derived/astralinux/etl-db

release/original/onec-connector

derived/astralinux/onec-connector

AI-компоненты: release/original/ai/… → derived/original/ai/…

Было (3.17.1)

Стало (3.18)

Было (3.17.1)

Стало (3.18)

release/original/ai/vllm-openai

derived/original/ai/vllm-openai

release/original/ai/model

derived/original/ai/model

release/original/ai/text-embeddings-inference

derived/original/ai/text-embeddings-inference

Образы обратного прокси

Было (3.17.1)

Стало (3.18)

Было (3.17.1)

Стало (3.18)

release/original/astralinux

derived/original/astralinux

release/original/astralinux/nginx/nginx1263-njs

derived/astralinux/nginx1263-njs

Смотрите также

Обновление платформы
Запуск платформы

Нужна дополнительная помощь?

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