Перейти к основному содержимому
Версия: v2 (текущая)

Релизы и обновления on-prem

TL;DR. PanDev Metrics регулярно выпускает новые сборки. Обновление on-prem — это смена image-тегов в docker-compose.yml (или values.yaml для Helm), затем pull и рестарт. Миграции схемы выполняются автоматически на старте. Полный changelog по релизам со ссылками на сборки — в разделе Релизы → Текущий релиз.

Как узнать текущую версию​

Знание текущей версии — первый шаг перед любым разговором про апгрейд.

В Docker Compose версия — это теги запущенных образов:

terminal
docker compose images

Смотрите теги для pandev-metrics-server и pandev-metrics-workspace. В Kubernetes:

terminal
helm list -n metrics
kubectl get deploy -n metrics -o jsonpath="{.items[*].spec.template.spec.containers[*].image}"

Версию также видно в футере веб-интерфейса после входа под админом.

Где смотреть release notes​

Подробные release notes лежат в отдельном разделе документации, не на этой странице.

Подробный changelog по каждому релизу со всеми версиями компонентов и ссылками на сборки плагинов лежит в отдельном разделе документации:

Каждая запись о релизе содержит:

  • Версии бэкенда (pandev-metrics) и workspace (pandev-metrics-backoffice) и их Docker-теги
  • Версии плагинов JetBrains, VS Code, Xcode, Visual Studio
  • Версии CLI и браузерных расширений
  • Bug fixes и новые фичи

Как обновиться (Docker Compose)​

Стандартный апгрейд Docker Compose — это четыре шага: бэкап, смена тегов, pull, рестарт.

Обновления не разрушают данные — PostgreSQL переживает смену версий в томе postgres-data. Перед апгрейдом всё равно сделайте бэкап.

  1. Прочитайте release notes для целевой версии.
  2. Сделайте бэкап PostgreSQL через pg_dump (см. бэкапы).
  3. Обновите image-теги в docker-compose.yml и для server, и для workspace (на хостах arm64 используйте теги -arm):
docker-compose.yml
services:
  pandev-metrics-server:
    image: pandevofficial/pandev-metrics:<НОВАЯ_ВЕРСИЯ_SERVER>
  pandev-metrics-workspace:
    image: pandevofficial/pandev-metrics-backoffice:<НОВАЯ_ВЕРСИЯ_WORKSPACE>
  1. Подтяните образы и перезапустите стек:
terminal
docker compose pull
docker compose up -d
  1. Подтвердите новые теги через docker compose images и что футер UI показывает новую версию.

Миграции БД выполняются автоматически при старте.

Как обновиться (Kubernetes / Helm)​

Для Helm-деплоев — поменяйте image-теги в values.yaml и выполните helm upgrade.

  1. Сделайте бэкап PostgreSQL.
  2. Обновите image-теги в values.yaml:
values.yaml
server:
  image:
    tag: <НОВАЯ_ВЕРСИЯ_SERVER>
workspace:
  image:
    tag: <НОВАЯ_ВЕРСИЯ_WORKSPACE>
  1. Примените, используя чарт из распакованного архива:
terminal
helm upgrade pandev-metrics ./helm-chart -n metrics -f values.yaml
  1. Дождитесь раскатки:
terminal
kubectl rollout status deployment/pandev-metrics-server -n metrics

Совместимость версий​

Мы поддерживаем только forward-обновление: ставите новую сборку, схема мигрирует на месте, и всё работает. Downgrade после применения миграций не поддерживается — если нужно откатиться, восстанавливайте бэкап. Плагины (IDE, browser, CLI) совместимы в пределах мажорной версии — обновляйте их в удобном темпе.

FAQ​

Частые вопросы про релизы и обновления on-prem.

Как часто выходят релизы on-prem?​

PanDev Metrics регулярно выпускает обновления бэкенда и плагинов. Жёсткой каденции нет — minor-версии выходят раз в несколько недель, патчи по мере необходимости. Темп лучше смотреть в Архиве релизов.

Нужно ли обновлять плагины вместе с бэкендом?​

Не всегда. Плагины совместимы по версиям — старые плагины продолжают работать с более новым бэкендом в рамках одного мажора. Чтобы получить новые фичи (например, учёт AI-активности в CLI), обновите плагин до версии, указанной в release notes.

Можно ли пропускать версии при обновлении?​

Да. Миграции выстраиваются в цепочку, поэтому при переходе с 4.5.x сразу на 4.7.2 отработают все промежуточные миграции по порядку. Сделайте бэкап и прочитайте notes по всем пропущенным версиям, чтобы не пропустить breaking changes.

Как откатить неудачный апгрейд?​

Остановите новые контейнеры, восстановите PostgreSQL из дампа, который сделали перед обновлением, и запустите предыдущие image-теги. In-place downgrade не поддерживается — миграции схемы идут только вперёд.

Где скачать сборки плагинов?​

Прямые ссылки на JetBrains, VS Code и Xcode-сборки публикуются в каждой записи релиза — см. Текущий релиз. Если рабочие станции разработчиков ходят через ограниченный egress и не могут достучаться до cdn.pandev.io, разместите артефакты на внутреннем зеркале.

Сопутствующее чтение для админов on-prem.